Universe

The Universe submodule defines simulation-specific data files which are constants of most simulations. In particular it provides data structures for storing and accessing Earth orientation parameters and spherical harmonic gravity field models.

The module defines the global variables EOP and GRAVITY_MODEL which load default data values at runtime.

EOP defaults to use the rapid Earth orientation data file finals.all (IAU 2000) distributed by the IERS. The module also supports IERS C04 product files.

GRAVITY_MODEL defaults to use the EGM2008 spherical harmonic gravity model, truncated to order and degree 90.

All data files in the module can be updated by running the command download_all_data() in the Julia REPL.

SatelliteDynamics.download_kpFunction

Download geomagnetic indices.

Arguments:

  • year_start::Int First year to download data for. Default: 2000
  • year_end::Int Last year to download data for. Default: 2019

Notes:

  1. Data source is GFZ Potsdam Geomagnetic WDC tables: https://www.gfz-potsdam.de/en/kp-index/
source
SatelliteDynamics.download_solar_fluxFunction

Download F10.7cm Solar Flux data.

10.7cm solar flux is the standard measure of solar activity in space weather models.

Notes:

  1. Data source is NRC Canada solar flux tables: ftp://ftp.seismo.nrcan.gc.ca/spaceweather/solarflux/dailyflux_values/fluxtable.txt
source
SatelliteDynamics.download_all_dataFunction

Downloads package datafiles into folders $PACKAGE_ROOT/DIR

Downloads the following files:

  • IERS C04 IAU2000A Earth Orientation Data
  • IERS C04 IAU1980 Earth Orientation Data
  • IERS Bulletin A/B IAU2000 Earth Orientation Data
source
SatelliteDynamics.EarthOrientationDataType

The EarthOrientationData constains a single data member of type Dict{Int, Tuple{Float64, Float64, Float64}} that stores the Earth Orientation parameters UT1-UTC, xp, and yp whose units are meters, radians, and radians, respectively. xp and yp are the x- and y-components of Earth's polar motion. The dictionary key is the Epoch the parameters are for as a Modified Julian Day at 0h UTC.

Arguments:

  • product::Symbol The IERS product type can be "C04_14", "C04_80", or "FINALS_2000"
source
SatelliteDynamics.EOPConstant

Module-wide global EarthOrientationData object. This data object is used as the default source of Earth Orientation Data by reference system transformations if no explicit EarthOrientationData file is provided to those transformations.

This value can be overridden in your own code as follows:

SatelliteDynamics.EOP = EarthOrientationData(:EOP_PRODUCT_CHOICE)

This global variable defaults to use the module's internal version of "FINALS_2000" if it is not otherwise set/provided.

source
SatelliteDynamics.UT1_UTCFunction

Compute the offset between the UT1 and UTC time systems in seconds. If the EarthOrientationData argument is ommitted the function will use the default module-global value.

Arguments:

  • eop::EarthOrientationData EarthOrientationData object to use to compute the offset
  • mjd::Real Modified Julian Date in UTC of the Epoch for which the UT1-UTC offset is desired.
  • interp::Bool Whether to linearly interpolate the parameter data to the input MJD.

Returns:

  • ut1_utc::Float UT1 - UTC offset. [s]
source
SatelliteDynamics.POLE_LOCATORFunction

Compute the location of the pole. Returns x- and y- components as a tuple with the units of [radians]. If the EarthOrientationData argument is ommitted the function will use the default module-global value.

Arguments:

  • eop::EarthOrientationData EarthOrientationData object to use to compute the offset
  • mjd::Real Modified Julian Date in UTC of the Epoch for which the pole locator is desired.
  • interp::Bool Whether to linearly interpolate the parameter data to the input MJD.

Returns:

  • pole_locator::Tuple{ -Float, Float} (x, y) pole location in radians.
source
SatelliteDynamics.XPFunction

Compute the x-component of the pole locator in [radians]. If the first EarthOrientationData argument is ommitted the function will use the default module-global value.

Arguments:

  • eop::EarthOrientationData EarthOrientationData object to use to compute the offset
  • mjd::Real Modified Julian Date in UTC of the Epoch for which the xp value is desired.
  • interp::Bool Whether to linearly interpolate the parameter data to the input MJD.

Returns:

  • xp::Float x-component of pole locator in radians.
source
SatelliteDynamics.YPFunction

Compute the y-component of the pole locator in [radians]. If the first EarthOrientationData argument is ommitted the function will use the default module-global value.

Arguments:

  • eop::EarthOrientationData EarthOrientationData object to use to compute the offset
  • mjd::Real Modified Julian Date in UTC of the Epoch for which the yp value is desired.
  • interp::Bool Whether to linearly interpolate the parameter data to the input MJD.

Returns:

  • yp::Float y-component of pole locator in radians.
source
SatelliteDynamics.set_eopFunction

Set Earth orientation data values for a specific date in the module global EarthOrientationData object.

Arguments:

  • mjd::Real Modified Julian Date in UTC of the Epoch for which the Earth orientation data is aligned to.
  • ut1_utc::Real Offset between UT1 and UTC in seconds.
  • xp::Real x-component of the pole locator in radians.
  • yp::Real y-component of the pole locator in radians.
source
SatelliteDynamics.load_eopFunction

Load new Earth orientation data into the module global EarthOrientationData object. The product can be one of the symbols: "C04_14", "C04_80", or "FINALS_2000".

Arguments:

  • product::String Loads a different set of EarthOrientationData values into the module-wide global EarthOrientationData parameters.
source
SatelliteDynamics.GravModelType

GravModel stores a spherical harmonic gravity field in memory. Can store normalized or denomalized coefficients. Package contains EGM2008, GGM01S, and GGM0S gravity models, as well as the default gravity model of EGM2008 truncated to degree and order 90.

Additional gravity field models can be downloaded from: http://icgem.gfz-potsdam.de/home

Arguments:

  • filepath::string Path to spherical harmonic gravity model file.
source
SatelliteDynamics.GRAVITY_MODELConstant

Module-wide global GravityModel object. This data object is used as the default spherical harmonic gravity field unless one is otherwise provided.

This value can be overridden in your own code as follows:

SatelliteDynamics.GravityModel = GravityModel(PATH_TO_YOUR_GRAVITY_MODEL)

This global variable defaults to use the module's internal version of the EGM2008 model truncated to order and degree 90, if it is not otherwise set.

source
Missing docstring.

Missing docstring for load_gravity_model. Check Documenter's build log for details.