pyrfu.models package#

pyrfu.models.igrf(time, flag)[source]#

Returns magnetic dipole latitude and longitude of the IGRF model

Parameters:

  • time (numpy.ndarray) – Times in unix format.

  • flag (str) – Default is dipole.

Returns:

  • lambda (ndarray) – latitude

  • phi (ndarray) – longitude

pyrfu.models.magnetopause_normal(r_gsm, b_z_imf, p_sw, model: str = 'mp_shue1997', m_alfven: float = 4.0)[source]#

Computes the distance and normal vector to the magnetopause for [1] or [2] model. Or bow shock for [3] model.

Parameters:

  • r_gsm (array_like) – GSM position in Re.

  • b_z_imf (float) – IMF Bz in nT.

  • p_sw (float) – Solar wind dynamic pressure in nPa.

  • model ({"mp_shue1997", "mp_shue1998", "bs97", "bs98"}, Optional) –

    Name of model :

    • ’mp_shue97’ : Shue et al., 1997 (Default)

    • ’mp_shue98’ : Shue et al., 1998

    • ’bs97’ : Bow shock, Farris & Russell 1994

    • ’bs98’ : Bow shock, Farris & Russell 1994

  • m_alfven (float, Optional) – Alfvenic Mach number, only needed if bow shock model is used.

Returns:

  • mindist (float) – Minimum distance to the magnetopause, in Re. Positive value if spacecraft is inside the magnetopause, negative if outside the magnetopause.

  • n_vec (numpy.ndarray) – Normal vector to the magnetopause (pointing away from Earth).

References

[1]

J.-H. Shue, J. K. Chao, H. C. Fu, C. T. Russell, P. Song, K. K. Khurana, and H. J. Singer (1997), A new functional form to study the solar wind control of the magnetopause size and shape, J. Geophys. Res., 102, 9497, doi: https://doi.org/10.1029/97JA00196

[2]

J.-H. Shue, P. Song, C. T. Russell, J. T. Steinberg, J. K. Chao, G. Zastenker, O. L. Vaisber, S. Kokubun, H. J. Singer, T. R. Detman and H. Kawano (1998), Magnetopause location under extreme solar wind conditions, J. Geophys. Res., 103(A8), 17, 691–17,700, doi: https://doi.org/10.1029/98JA01103

[3]

M. H. Farris and C. T. Russell (1994), Determining the standoff distance of the bow shock: Mach number dependence and use of models, J. Geophys. Res., 99, 17681. doi: https://doi.org/10.1029/94JA01020

Submodules#