pymsis.msis.create_options#

pymsis.msis.create_options(f107=1, time_independent=1, symmetrical_annual=1, symmetrical_semiannual=1, asymmetrical_annual=1, asymmetrical_semiannual=1, diurnal=1, semidiurnal=1, geomagnetic_activity=1, all_ut_effects=1, longitudinal=1, mixed_ut_long=1, mixed_ap_ut_long=1, terdiurnal=1)#

Create the options list based on keyword argument choices.

Defaults to all 1’s for the input options. 0 turns the option off. 1 turns the option on. 2 turns the main effects off, but the cross terms on.

For geomagnetic_activity, 1 is for daily Ap mode, and -1 is for storm-time Ap mode. You may also use booleans for the options, diurnal=False will turn off the diurnal effect.

Parameters:

  • f107 (float) – Solar flux F10.7 effects on atmospheric density. Controls how much the current F10.7 value modifies the base atmospheric state. When set to 0, F10.7 variations are ignored and the atmosphere uses a standard reference solar flux level.

  • time_independent (float) – Time-independent baseline atmospheric structure. Controls the basic north-south atmospheric variations that provide the fundamental geographic structure of the atmosphere independent of time. Setting to 0 removes these baseline latitude-dependent terms, leaving only time-varying atmospheric patterns.

  • symmetrical_annual (float) – Annual variations that are the same in both hemispheres. Controls seasonal changes in atmospheric density due to Earth’s orbit around the Sun. When set to 0, removes symmetric year-to-year variations.

  • symmetrical_semiannual (float) – Semiannual (6-month) variations that are symmetric between hemispheres. Controls atmospheric changes that occur twice per year due to solar heating patterns. Setting to 0 removes these biannual variations.

  • asymmetrical_annual (float) – Annual variations that differ between northern and southern hemispheres. Accounts for seasonal differences caused by land/ocean distribution and other hemispheric asymmetries. When set to 0, removes asymmetric seasonal effects.

  • asymmetrical_semiannual (float) – Semiannual variations that differ between hemispheres. Controls atmospheric changes that occur twice yearly but with different magnitudes in each hemisphere. Setting to 0 removes these asymmetric biannual variations.

  • diurnal (float) – Daily (24-hour) variations in atmospheric density. Controls day/night differences caused by solar heating and atmospheric tides. When set to 0, removes all diurnal atmospheric variations.

  • semidiurnal (float) – Semi-daily (12-hour) variations in atmospheric density. Controls atmospheric tides that occur twice per day due to solar heating patterns. Setting to 0 removes these twice-daily atmospheric oscillations.

  • geomagnetic_activity (float) – Geomagnetic activity effects on atmospheric heating and expansion. Controls how magnetic storms and aurora affect atmospheric density. (1 = Daily Ap mode using average daily values, -1 = Storm-time Ap mode using 3-hourly Ap indices for more detailed storm modeling)

  • all_ut_effects (float) – Universal Time (UT) and longitudinal effects combined. Controls atmospheric variations that depend on the time of day in UT and geographic longitude. Setting to 0 removes all UT/longitude-dependent variations.

  • longitudinal (float) – Pure longitudinal variations independent of UT. Controls atmospheric differences that vary only with geographic longitude (e.g., land/sea contrasts, topography). When set to 0, removes longitude-only atmospheric variations.

  • mixed_ut_long (float) – Mixed Universal Time and longitudinal effects. Controls atmospheric variations that depend on both UT and longitude simultaneously (e.g., regional differences in tidal patterns). Setting to 0 removes these coupled effects.

  • mixed_ap_ut_long (float) – Combined geomagnetic activity, UT, and longitudinal effects. Controls how magnetic activity affects the atmosphere differently across longitude and UT. When set to 0, removes the geographic/temporal coupling of magnetic effects.

  • terdiurnal (float) – Terdiurnal (8-hour) atmospheric variations. Controls atmospheric tides that occur three times per day due to solar heating harmonics. Setting to 0 removes these 8-hourly atmospheric oscillations.

Returns:

25 options as a list ready for msis2 input

Return type:

list

On this page

This Page