User Manual 3.3 Environment Models - Historique des versions

Admin le 3 avril 2018 à 13:46

2018-04-03T13:46:22Z

Admin : /* Details, limitation and precautions */

2018-03-16T13:45:22Z

Details, limitation and precautions

@@ Ligne 264 : / Ligne 264 : @@
 Here is the list of all possible actual models and the time transform support (please note that only dates prior to 2010 won't support time transformation) :
 |Model and associated data file |Model Name|Validity Period|Time transform support
-|=(% rowspan="23" %)IGRF (% style="font-weight: normal;" %)(''GeoMagneticFieldFactory.getIGRF(..)'' uses IGRF.COF)|IGRF00 | 1900.0 - 1905.0 | false
+{| class="wikitable"
-|IGRF05 | 1905.0 - 1910.0 | false
+| Model and associated data file
-|IGRF10 | 1910.0 - 1915.0 | false
+| Model Name
-|IGRF15 | 1915.0 - 1920.0 | false
+| Validity Period
-|IGRF20 | 1920.0 - 1925.0 | false
+| Time transform support
-|IGRF25 | 1925.0 - 1930.0 | false
+|-
-|IGRF30 | 1930.0 - 1935.0 | false
+| rowspan="23"|IGRF (''GeoMagneticFieldFactory.getIGRF(..)'' uses IGRF.COF)
-|IGRF35 | 1935.0 - 1940.0 | false
+| IGRF00
-|IGRF40 | 1940.0 - 1945.0 | false
+| 1900.0 - 1905.0
-|DGRF45 | 1945.0 - 1950.0 | false
+| false
-|DGRF50 | 1950.0 - 1955.0 | false
+|-
-|DGRF55 | 1955.0 - 1960.0 | false
+| IGRF05
-|DGRF60 | 1960.0 - 1965.0 | false
+| 1905.0 - 1910.0
-|DGRF65 | 1965.0 - 1970.0 | false
+| false
-|DGRF70 | 1970.0 - 1975.0 | false
+|-
-|DGRF75 | 1975.0 - 1980.0 | false
+| IGRF10
-|DGRF80 | 1980.0 - 1985.0 | false
+| 1910.0 - 1915.0
-|DGRF85 | 1985.0 - 1990.0 | false
+| false
-|DGRF90 | 1990.0 - 1995.0 | false
+|-
-|DGRF95 | 1995.0 - 2000.0 | false
+|IGRF15
-|DGRF2000 | 2000.0 - 2005.0 | false
+| 1915.0 - 1920.0
-|DGRF2005 | 2005.0 - 2010.0 | false
+| false
-|IGRF2010 | 2010.0 - 2015.0 | true
+|-
-|=(% rowspan="1" %)WMM (% style="font-weight: normal;" %)(''GeoMagneticFieldFactory.getWMM(..)'' uses WMM.COF)(%%) | WMM2010 | 2010.0 - 2015.0 | true
+|IGRF20
 Precautions :

Admin : /* Tides model for force computation = */

2018-03-05T15:42:20Z

Tides model for force computation =

← Version précédente		Version du 5 mars 2018 à 15:42
Ligne 191 :		Ligne 191 :

	=== Tides models ===		=== Tides models ===
	==== Tides model for force computation =====		==== Tides model for force computation ====

	The PATRIUS <code>org.orekit.forces.gravity.tides</code> package provides tools allowing the user to use Terestrial and Ocean tides. The <code>org.orekit.forces.gravity.tides.coefficients</code> package also allows reading external ocean tides coefficients data files. The following file formats are supported by PATRIUS:		The PATRIUS <code>org.orekit.forces.gravity.tides</code> package provides tools allowing the user to use Terestrial and Ocean tides. The <code>org.orekit.forces.gravity.tides.coefficients</code> package also allows reading external ocean tides coefficients data files. The following file formats are supported by PATRIUS:

Admin le 28 février 2018 à 10:06

2018-02-28T10:06:25Z

← Version précédente		Version du 28 février 2018 à 10:06
Ligne 566 :		Ligne 566 :
	\|[{{JavaDoc3.3}}/org/orekit/models/earth/COFFileFormatReader.html ...]		\|[{{JavaDoc3.3}}/org/orekit/models/earth/COFFileFormatReader.html ...]
	\|}		\|}

			[[Category:User_Manual_3.3_Orbit_Propagation]]

Admin : Admin a déplacé la page Environment Models vers User Manual 3.3 Environment Models sans laisser de redirection

2018-02-28T10:06:02Z

Admin a déplacé la page Environment Models vers User Manual 3.3 Environment Models sans laisser de redirection

← Version précédente		Version du 28 février 2018 à 10:06
(Aucune différence)

Admin : /* Contents */

2018-02-28T10:05:08Z

Contents

Voir les modifications

Admin : /* Geomagnetic models */

2018-02-28T10:01:56Z

Geomagnetic models

← Version précédente		Version du 28 février 2018 à 10:01
Ligne 224 :		Ligne 224 :

	The Orekit <code>org.orekit.models.earth</code> package provides tools allowing the user to use different geomagnetic models. For the moment, there are only the two following models available :		The Orekit <code>org.orekit.models.earth</code> package provides tools allowing the user to use different geomagnetic models. For the moment, there are only the two following models available :

	~~(% style="margin-left:30px;list-style-type:square;" %)~~
	* IGRF 11 : International Geomagnetic Reference Field eleventh generation		* IGRF 11 : International Geomagnetic Reference Field eleventh generation
	* WMM 2010 : World Magnetic Model published in december 2009		* WMM 2010 : World Magnetic Model published in december 2009

Admin : /* Tides models */

2018-02-28T10:00:28Z

Tides models

← Version précédente		Version du 28 février 2018 à 10:00
Ligne 194 :		Ligne 194 :

	The PATRIUS <code>org.orekit.forces.gravity.tides</code> package provides tools allowing the user to use Terestrial and Ocean tides. The <code>org.orekit.forces.gravity.tides.coefficients</code> package also allows reading external ocean tides coefficients data files. The following file formats are supported by PATRIUS:		The PATRIUS <code>org.orekit.forces.gravity.tides</code> package provides tools allowing the user to use Terestrial and Ocean tides. The <code>org.orekit.forces.gravity.tides.coefficients</code> package also allows reading external ocean tides coefficients data files. The following file formats are supported by PATRIUS:

	~~(% style="margin-left:30px;list-style-type:square;" %)~~
	* FES2004 format		* FES2004 format

	==== Reference point displacement ====		==== Reference point displacement ====

	The PATRIUS <code>org.orekit.utils.ReferencePointsDisplacement</code> class provides a model describing the displacement of reference points due to the effect of the solid Earth tides. The computation is performed by the static method'''solidEarthTidesCorrections(AbsoluteDate, Vector3D, Vector3D, Vector3D)'''. The implemented model has been validated by comparison with tests available in the IERS website. The example below shows the user how to compute displacements of reference points:		The PATRIUS <code>org.orekit.utils.ReferencePointsDisplacement</code> class provides a model describing the displacement of reference points due to the effect of the solid Earth tides. The computation is performed by the static method '''solidEarthTidesCorrections(AbsoluteDate, Vector3D, Vector3D, Vector3D)'''. The implemented model has been validated by comparison with tests available in the IERS website. The example below shows the user how to compute displacements of reference points:

	<syntaxhighlight lang="java">		<syntaxhighlight lang="java">
	'' Test from source ftp:''tai.bipm.org/iers/convupdt/chapter7/dehanttideinel/DEHANTTIDEINEL.F		// Test from source ftp://tai.bipm.org/iers/convupdt/chapter7/dehanttideinel/DEHANTTIDEINEL.F

	// date : 13/04/2009		// date : 13/04/2009
Ligne 221 :		Ligne 219 :
	Assert.assertEquals(0.05516568152597246810, disp.getZ(), Precision.EPSILON);		Assert.assertEquals(0.05516568152597246810, disp.getZ(), Precision.EPSILON);
	</syntaxhighlight>		</syntaxhighlight>


	=== Geomagnetic models ===		=== Geomagnetic models ===

Admin : /* Drag force models */

2018-02-28T09:59:51Z

Drag force models

← Version précédente		Version du 28 février 2018 à 09:59
Ligne 93 :		Ligne 93 :
	The atmospheres make use of solar activity in order to compute the density at the given user location excepted US76 model that is only based on altitude parameters. The PATRIUS architecture of atmospheres and solar activity is divided into three layers :		The atmospheres make use of solar activity in order to compute the density at the given user location excepted US76 model that is only based on altitude parameters. The PATRIUS architecture of atmospheres and solar activity is divided into three layers :

	'''*Atmospheres use solar data in specific ways'''		*'''Atmospheres use solar data in specific ways'''
	Each atmosphere model uses the solar data in a specific way (more simply, US76 doesn't use solar data). These representations are enclosed in the atmosphere model specific interfaces, such as [{{JavaDoc3.3}}/org/orekit/forces/atmospheres/DTM2000InputParameters.html DTM2000InputParamters]. Atmosphere models available include US76 (for low altitudes in range 0 to 1000km), DTM2000 and MSISE2000.		Each atmosphere model uses the solar data in a specific way (more simply, US76 doesn't use solar data). These representations are enclosed in the atmosphere model specific interfaces, such as [{{JavaDoc3.3}}/org/orekit/forces/atmospheres/DTM2000InputParameters.html DTM2000InputParamters]. Atmosphere models available include US76 (for low altitudes in range 0 to 1000km), DTM2000 and MSISE2000.
	'''*Reading and storing solar data'''		*'''Reading and storing solar data'''
	The way to store the solar data is enclosed in the [{{JavaDoc3.3}}/org/orekit/forces/atmospheres/solarActivity/SolarActivityDataProvider.html SolarActivityDataProvider interface]. It defines the basic coefficients (Ap, Kp and F10.7 cm) that any solar activity data provider class should be able to return, in order to be compatible with the atmosphere specific implementations (see next point). The [{{JavaDoc3.3}}/org/orekit/forces/atmospheres/solarActivity/package-summary.html solarActivity package] contains classes that can read different file formats and can return the solar activity data. So far, one class for each of the ACSOL and NOAA formats has been implemented. Additionally, one class representing constant solar activity (that requires no external file) has been implemented.		The way to store the solar data is enclosed in the [{{JavaDoc3.3}}/org/orekit/forces/atmospheres/solarActivity/SolarActivityDataProvider.html SolarActivityDataProvider interface]. It defines the basic coefficients (Ap, Kp and F10.7 cm) that any solar activity data provider class should be able to return, in order to be compatible with the atmosphere specific implementations (see next point). The [{{JavaDoc3.3}}/org/orekit/forces/atmospheres/solarActivity/package-summary.html solarActivity package] contains classes that can read different file formats and can return the solar activity data. So far, one class for each of the ACSOL and NOAA formats has been implemented. Additionally, one class representing constant solar activity (that requires no external file) has been implemented.
	'''*Using the solar data in an adequate fashion'''		*'''Using the solar data in an adequate fashion'''
	Making effective use of the solar data for specific atmospheres requires an object that provides solar data (implementing the [{{JavaDoc3.3}}/org/orekit/forces/atmospheres/solarActivity/SolarActivityDataProvider.html SolarActivityDataProvider]) and answers to the interfaces that define the ways in which the atmosphere models use this data (e.g. implementing [{{JavaDoc3.3}}/org/orekit/forces/atmospheres/DTM2000InputParameters.html DTM2000InputParameters]). These classes are contained in the [{{JavaDoc3.3}}/org/orekit/forces/atmospheres/solarActivity/specialized/package-summary.html org.orekit.forces.atmospheres.solarActivity.specialized package]). So far, one class for each of the DTM2000 and MSISE2000 models have been implemented.		Making effective use of the solar data for specific atmospheres requires an object that provides solar data (implementing the [{{JavaDoc3.3}}/org/orekit/forces/atmospheres/solarActivity/SolarActivityDataProvider.html SolarActivityDataProvider]) and answers to the interfaces that define the ways in which the atmosphere models use this data (e.g. implementing [{{JavaDoc3.3}}/org/orekit/forces/atmospheres/DTM2000InputParameters.html DTM2000InputParameters]). These classes are contained in the [{{JavaDoc3.3}}/org/orekit/forces/atmospheres/solarActivity/specialized/package-summary.html org.orekit.forces.atmospheres.solarActivity.specialized package]). So far, one class for each of the DTM2000 and MSISE2000 models have been implemented.

Ligne 109 :		Ligne 109 :
	==== Atmospheric models ====		==== Atmospheric models ====

	Various models are available in PATRIUS: DTM-2000, MSIS-00, US76, etc. all models inherit the <code>Atmosphere</code> interface providing total density information.		Various models are available in PATRIUS: DTM-2000, MSIS-00, US76, etc. all models inherit the <code>Atmosphere</code> interface providing total density information.<br>
	DTM and MSIS models also implement the <code>ExtendedAtmosphere</code> interface which provides more detailed data such as temperature and partial densities of atmosphere constituents.		DTM and MSIS models also implement the <code>ExtendedAtmosphere</code> interface which provides more detailed data such as temperature and partial densities of atmosphere constituents.<br>
	Some models require solar and geomagnetic information (see below for how to provide solar and geomagnetic data).		Some models require solar and geomagnetic information (see below for how to provide solar and geomagnetic data).

Ligne 150 :		Ligne 150 :
	Solar and geomagnetic activity can be provided in various ways:		Solar and geomagnetic activity can be provided in various ways:
	* Constant solar activity using:		* Constant solar activity using:
	~~{{code language~~="java" ~~title=""}}~~		<syntaxhighlight lang="java">
	final SolarActivityDataProvider constantSolarActivity = new ConstantSolarActivity(140, 15);		final SolarActivityDataProvider constantSolarActivity = new ConstantSolarActivity(140, 15);
	{{/~~code}}~~		</syntaxhighlight>
	* Variable solar activity using (for instance):		* Variable solar activity using (for instance):
	~~{{code language~~="java" ~~title=""}}~~		<syntaxhighlight lang="java">
	final SolarActivityDataProvider variableSolarActivity = new NOAAFormatReader(...);		final SolarActivityDataProvider variableSolarActivity = new NOAAFormatReader(...);
	final SolarActivityDataProvider otherVariableSolarActivity = new ACSOLFormatReader(...);		final SolarActivityDataProvider otherVariableSolarActivity = new ACSOLFormatReader(...);
	{{/~~code}}~~		</syntaxhighlight>

	Solar and geomagnetic activity data often having a limited timespan, the class {{code ~~language="java" title=""}}~~ExtendedSolarActivityWrapper{{/code}} allows data extension with constant values. Solar and geomagnetic data returned before timespan are equals to an average of first available data (the average duration being user-chosen). Solar and geomagnetic data returned after timespan are equals to an average of last available data (the average duration being user-chosen).		Solar and geomagnetic activity data often having a limited timespan, the class <code>ExtendedSolarActivityWrapper</code> allows data extension with constant values. Solar and geomagnetic data returned before timespan are equals to an average of first available data (the average duration being user-chosen). Solar and geomagnetic data returned after timespan are equals to an average of last available data (the average duration being user-chosen).

	These providers are used as inputs of atmospheric models.		These providers are used as inputs of atmospheric models.
Ligne 168 :		Ligne 168 :

	The following file formats are supported by PATRIUS:		The following file formats are supported by PATRIUS:
	~~(% style="margin-left:30px;list-style-type:square;" %)~~
	* ACSOL format		* ACSOL format
	* NOAA format		* NOAA format
Ligne 174 :		Ligne 173 :
	The user access point is the <code>SolarActivityDataFactory</code> which automatically detects available files and uses the adequate solar file reader. If no file is specified by the user, this factory uses the first available file.		The user access point is the <code>SolarActivityDataFactory</code> which automatically detects available files and uses the adequate solar file reader. If no file is specified by the user, this factory uses the first available file.

	~~{{code language~~="java" ~~title=""}}~~		<syntaxhighlight lang="java">
	//Directory containing the file ACSOL.act		//Directory containing the file ACSOL.act
	final File potdir = new File("/my/data/solar");		final File potdir = new File("/my/data/solar");
Ligne 189 :		Ligne 188 :
	final double kp = provider.getKp( userDate );		final double kp = provider.getKp( userDate );
	final double f = provider.getInstantFluxValue( userDate );		final double f = provider.getInstantFluxValue( userDate );
	{{/~~code}}~~		</syntaxhighlight>

	=== Tides models ===		=== Tides models ===

Admin : /* Earth Potential Models */

2018-02-28T09:56:56Z

Earth Potential Models

← Version précédente		Version du 28 février 2018 à 09:56
Ligne 68 :		Ligne 68 :
	The Orekit <code>org.orekit.forces.gravity.potential</code> package provides tools allowing the user to read external gravity potential data files. The following file formats are supported by Orekit :		The Orekit <code>org.orekit.forces.gravity.potential</code> package provides tools allowing the user to read external gravity potential data files. The following file formats are supported by Orekit :

	~~(% style="MARGIN-LEFT: 30px; LIST-STYLE-TYPE: square" %)~~
	* EGM96 ASCII format data		* EGM96 ASCII format data
	* EIGEN-GRACE format		* EIGEN-GRACE format
Ligne 87 :		Ligne 86 :

	[[File:varPOT.PNG\|center]]		[[File:varPOT.PNG\|center]]


	=== Drag force models ===		=== Drag force models ===

← Version précédente		Version du 3 avril 2018 à 13:46
Ligne 51 :		Ligne 51 :
	* [http://op.gfz-potsdam.de/grace/ GFZ - Grace (Gravity Recovery and Climate Experiment) Mission Homepage]		* [http://op.gfz-potsdam.de/grace/ GFZ - Grace (Gravity Recovery and Climate Experiment) Mission Homepage]
	* [http://icgem.gfz-potsdam.de/ICGEM/ GFZ - International Centre for Global Earth Models]		* [http://icgem.gfz-potsdam.de/ICGEM/ GFZ - International Centre for Global Earth Models]
	* [http://grgs.obs-mip.fr Groupe de Recherche de ~~Géodésie~~ Spatiale]		* [http://grgs.obs-mip.fr Groupe de Recherche de G갤괩e Spatiale]

	'''Results Pages'''		'''Results Pages'''
Ligne 77 :		Ligne 77 :
	[[File:physicalModels.PNG\|center]]		[[File:physicalModels.PNG\|center]]

	For a detailed explanation of the Orekit Data Management System, please refer to the [~~SUP_DMS_Home~~ Data Management System section] of the Support User Manual.		For a detailed explanation of the Orekit Data Management System, please refer to the [[User Manual 3.3 Data management system\|Data Management System section]] of the Support User Manual.

	The Orekit <code>org.orekit.forces.gravity.variations</code> package provides tools allowing the user to read external variable gravity potential data files. The corresponding ForceModel is also included in the package. The following file formats are supported by Orekit :		The Orekit <code>org.orekit.forces.gravity.variations</code> package provides tools allowing the user to read external variable gravity potential data files. The corresponding ForceModel is also included in the package. The following file formats are supported by Orekit :
Ligne 105 :		Ligne 105 :
	[[File:atmospheres2.PNG\|center]]		[[File:atmospheres2.PNG\|center]]

	For a detailed explanation of the Orekit Data Management System, please refer to the [~~SUP_DMS_Home~~ Data Management System section] of the Support User Manual.		For a detailed explanation of the Orekit Data Management System, please refer to the [[User Manual 3.3 Data management system\|Data Management System section]] of the Support User Manual.

	==== Atmospheric models ====		==== Atmospheric models ====
Ligne 165 :		Ligne 165 :
	===== Reading Solar Activity Data files =====		===== Reading Solar Activity Data files =====

	The data is read through the Orekit <code>DataLoader</code> infrastructure; it provides several ways to load solar activity data. Please see the [~~SUP_DMS_Home~~ Data Management System section] for more information.		The data is read through the Orekit <code>DataLoader</code> infrastructure; it provides several ways to load solar activity data. Please see the [[User Manual 3.3 Data management system\|Data Management System section]] for more information.

	The following file formats are supported by PATRIUS:		The following file formats are supported by PATRIUS:
Ligne 241 :		Ligne 241 :
	==== WMM 2010 geomagnetic model ====		==== WMM 2010 geomagnetic model ====

	The World Magnetic Model is a joint product of the United ~~States’ National~~ Geospatial-Intelligence Agency (NGA) and the United ~~Kingdom’s~~ Defence Geographic Centre (DGC). The WMM was developed jointly by the National Geophysical Data Center (NGDC, Boulder CO, USA) and the British Geological Survey (BGS, Edinburgh, Scotland).		The World Magnetic Model is a joint product of the United StatesҠNational Geospatial-Intelligence Agency (NGA) and the United Kingdomӳ Defence Geographic Centre (DGC). The WMM was developed jointly by the National Geophysical Data Center (NGDC, Boulder CO, USA) and the British Geological Survey (BGS, Edinburgh, Scotland).

	The World Magnetic Model is the standard model used by the U.S. Department of Defense, the U.K. Ministry of Defence, the North Atlantic Treaty Organization (NATO) and the International Hydrographic Organization (IHO), for navigation, attitude and heading referencing systems using the geomagnetic field. It is also used widely in civilian navigation and heading systems. The model, associated software, and documentation are distributed by NGDC on behalf of NGA. The model is produced at 5-year intervals, with the current model expiring on December 31, 2014.		The World Magnetic Model is the standard model used by the U.S. Department of Defense, the U.K. Ministry of Defence, the North Atlantic Treaty Organization (NATO) and the International Hydrographic Organization (IHO), for navigation, attitude and heading referencing systems using the geomagnetic field. It is also used widely in civilian navigation and heading systems. The model, associated software, and documentation are distributed by NGDC on behalf of NGA. The model is produced at 5-year intervals, with the current model expiring on December 31, 2014.

User Manual 3.3 Environment Models - Historique des versions

Admin le 3 avril 2018 à 13:46

Admin : /* Details, limitation and precautions */

Admin : /* Tides model for force computation = */

Admin le 28 février 2018 à 10:06

Admin : Admin a déplacé la page Environment Models vers User Manual 3.3 Environment Models sans laisser de redirection

Admin : /* Contents */

Admin : /* Geomagnetic models */

Admin : /* Tides models */

Admin : /* Drag force models */

Admin : /* Earth Potential Models */