User Manual 4.0 Frames configuration - Historique des versions

Admin le 21 février 2018 à 13:59

2018-02-21T13:59:21Z

Admin : /* Javadoc */

2018-02-21T07:51:18Z

Javadoc

← Version précédente		Version du 21 février 2018 à 07:51
Ligne 6 :		Ligne 6 :

	=== Javadoc ===		=== Javadoc ===
	\|=Library\|=Javadoc		{\| class="wikitable"
	\|Patrius\|[{{~~PathCurrentJavaDoc~~}}/fr/cnes/sirius/patrius/frames/configuration/package-summary.html Package fr.cnes.sirius.patrius.frames.configuration]		\|-
	\|Patrius\|[{{~~PathCurrentJavaDoc~~}}/fr/cnes/sirius/patrius/frames/configuration/eop/package-summary.html Package fr.cnes.sirius.patrius.frames.configuration.eop]		! scope="col"\| Library
	\|Patrius\|[{{~~PathCurrentJavaDoc~~}}/fr/cnes/sirius/patrius/frames/configuration/tides/package-summary.html Package fr.cnes.sirius.patrius.frames.configuration.tides]		! scope="col"\| Javadoc
	\|Patrius\|[{{~~PathCurrentJavaDoc~~}}/fr/cnes/sirius/patrius/frames/configuration/libration/package-summary.html Package fr.cnes.sirius.patrius.frames.configuration.libration]		\|-
	\|Patrius\|[{{~~PathCurrentJavaDoc~~}}/fr/cnes/sirius/patrius/frames/configuration/precessionnutation/package-summary.html Package fr.cnes.sirius.patrius.frames.configuration.precessionnutation]		\|Patrius
			\|[{{JavaDoc4.0}}/fr/cnes/sirius/patrius/frames/configuration/package-summary.html Package fr.cnes.sirius.patrius.frames.configuration]
			\|-
			\|Patrius
			\|[{{JavaDoc4.0}}/fr/cnes/sirius/patrius/frames/configuration/eop/package-summary.html Package fr.cnes.sirius.patrius.frames.configuration.eop]
			\|-
			\|Patrius
			\|[{{JavaDoc4.0}}/fr/cnes/sirius/patrius/frames/configuration/tides/package-summary.html Package fr.cnes.sirius.patrius.frames.configuration.tides]
			\|-
			\|Patrius
			\|[{{JavaDoc4.0}}/fr/cnes/sirius/patrius/frames/configuration/libration/package-summary.html Package fr.cnes.sirius.patrius.frames.configuration.libration]
			\|-
			\|Patrius
			\|[{{JavaDoc4.0}}/fr/cnes/sirius/patrius/frames/configuration/precessionnutation/package-summary.html Package fr.cnes.sirius.patrius.frames.configuration.precessionnutation]
			\|}

	=== Links ===		=== Links ===

Admin le 20 février 2018 à 16:42

2018-02-20T16:42:00Z

← Version précédente		Version du 20 février 2018 à 16:42
Ligne 1 :		Ligne 1 :
			__NOTOC__
	== Introduction ==		== Introduction ==
	=== Scope ===		=== Scope ===

Admin : /* Classes */

2018-02-20T16:35:18Z

Classes

← Version précédente		Version du 20 février 2018 à 16:35
Ligne 326 :		Ligne 326 :

	The classes are mentioned according to their packages for better visibility. Note : The aforementioned EOP2000History class is to be used with the PATRIUS IERS Frames Configuration.		The classes are mentioned according to their packages for better visibility. Note : The aforementioned EOP2000History class is to be used with the PATRIUS IERS Frames Configuration.


	{\| class="wikitable"		{\| class="wikitable"
Ligne 361 :		Ligne 360 :
	\|[{{JavaDoc4.0}}/fr/cnes/sirius/patrius/frames/configuration/PrecessionNutation.html ...]		\|[{{JavaDoc4.0}}/fr/cnes/sirius/patrius/frames/configuration/PrecessionNutation.html ...]
	\|}		\|}



	{\| class="wikitable"		{\| class="wikitable"
Ligne 408 :		Ligne 405 :
	\|[{{JavaDoc4.0}}/fr/cnes/sirius/patrius/frames/configuration/sp/NoSpCorrection.html ...]		\|[{{JavaDoc4.0}}/fr/cnes/sirius/patrius/frames/configuration/sp/NoSpCorrection.html ...]
	\|}		\|}


	{\| class="wikitable"		{\| class="wikitable"
Ligne 428 :		Ligne 424 :
	\|[{{JavaDoc4.0}}/fr/cnes/sirius/patrius/frames/configuration/tides/NoTidalCorrection.html ...]		\|[{{JavaDoc4.0}}/fr/cnes/sirius/patrius/frames/configuration/tides/NoTidalCorrection.html ...]
	\|}		\|}



	{\| class="wikitable"		{\| class="wikitable"

Admin : /* Classes */

2018-02-20T16:34:45Z

Classes

Voir les modifications

Admin : /* Interfaces */

2018-02-20T16:29:26Z

Interfaces

← Version précédente		Version du 20 février 2018 à 16:29
Ligne 292 :		Ligne 292 :
	'''Interfaces used within the Frames configurations'''		'''Interfaces used within the Frames configurations'''

	\|=~~(% colspan~~="3" %)Interface~~\|=(% colspan~~="6" %)Summary~~\|=(% colspan~~="1" %)Javadoc		{\| class="wikitable"
	\|~~(% colspan="3" %)~~'''FramesConfiguration'''\|~~(% colspan="6" %)~~Interface providing the basic services for frame configurations.\|[{{~~PathCurrentJavaDoc~~}}/fr/cnes/sirius/patrius/frames/configuration/FramesConfiguration.html ...]		\|-
	\|~~(% colspan="3" %)~~'''EOPHistory'''\|~~(% colspan="6" %)~~Interface for retrieving Earth Orientation Parameters history throughout a large time range.\|[{{~~PathCurrentJavaDoc~~}}/fr/cnes/sirius/patrius/frames/configuration/eop/EOPHistory.html ...]		! scope="col"\| Interface
	\|~~(% colspan="3" %)~~'''LibrationCorrectionModel'''\|~~(% colspan="6" %)~~This interface provides the pole corrections as well as the ut1-utc corrections due to libration.\|[{{~~PathCurrentJavaDoc~~}}/fr/cnes/sirius/patrius/frames/configuration/libration/LibrationCorrectionModel.html ...]		! scope="col"\| Summary
	\|~~(% colspan="3" %)~~'''PrecessionNutationModel'''\|~~(% colspan="6" %)~~This interface provides the Celestial Intermediate Pole motion (CIP) in the GCRS, those coordinates are used for the GCRF to CIRF transformation.\|[{{~~PathCurrentJavaDoc~~}}/fr/cnes/sirius/patrius/frames/configuration/precessionnutation/PrecessionNutationModel.html ...]		! scope="col"\| Javadoc
	\|~~(% colspan="3" %)~~'''SPrimeModel'''\|~~(% colspan="6" %)~~This interface provides the s' correction (used for the following transformation : TIRF -> ITRF).\|[{{~~PathCurrentJavaDoc~~}}/fr/cnes/sirius/patrius/frames/configuration/sp/SPrimeModel.html ...]		\|-
	\|~~(% colspan="3" %)~~'''TidalCorrectionModel'''\|~~(% colspan="6" %)~~This interface provides the pole corrections as well as the ut1-utc corrections due to tidal effects.\|[{{~~PathCurrentJavaDoc~~}}/fr/cnes/sirius/patrius/frames/configuration/tides/TidalCorrectionModel.html ...]		\|'''FramesConfiguration'''
			\|Interface providing the basic services for frame configurations.
			\|[{{JavaDoc4.0}}/fr/cnes/sirius/patrius/frames/configuration/FramesConfiguration.html ...]
			\|-
			\|'''EOPHistory'''
			\|Interface for retrieving Earth Orientation Parameters history throughout a large time range.
			\|[{{JavaDoc4.0}}/fr/cnes/sirius/patrius/frames/configuration/eop/EOPHistory.html ...]
			\|-
			\|'''LibrationCorrectionModel'''
			\|This interface provides the pole corrections as well as the ut1-utc corrections due to libration.
			\|[{{JavaDoc4.0}}/fr/cnes/sirius/patrius/frames/configuration/libration/LibrationCorrectionModel.html ...]
			\|-
			\|'''PrecessionNutationModel'''
			\|This interface provides the Celestial Intermediate Pole motion (CIP) in the GCRS, those coordinates are used for the GCRF to CIRF transformation.
			\|[{{JavaDoc4.0}}/fr/cnes/sirius/patrius/frames/configuration/precessionnutation/PrecessionNutationModel.html ...]
			\|-
			\|'''SPrimeModel'''
			\|This interface provides the s' correction (used for the following transformation : TIRF -> ITRF).
			\|[{{JavaDoc4.0}}/fr/cnes/sirius/patrius/frames/configuration/sp/SPrimeModel.html ...]
			\|-
			\|'''TidalCorrectionModel'''
			\|This interface provides the pole corrections as well as the ut1-utc corrections due to tidal effects.
			\|[{{JavaDoc4.0}}/fr/cnes/sirius/patrius/frames/configuration/tides/TidalCorrectionModel.html ...]
			\|}

	=== Classes ===		=== Classes ===

Admin : Admin a déplacé la page Frames configuration vers User Manual 4.0 Frames configuration

2018-02-19T08:39:42Z

Admin a déplacé la page Frames configuration vers User Manual 4.0 Frames configuration

← Version précédente		Version du 19 février 2018 à 08:39
(Aucune différence)

Admin le 19 février 2018 à 08:39

2018-02-19T08:39:16Z

Voir les modifications

Admin : 1 révision importée

2018-02-19T08:26:23Z

1 révision importée

← Version précédente		Version du 19 février 2018 à 08:26
(Aucune différence)

Admin le 19 février 2018 à 08:26

2018-02-19T08:26:23Z

Nouvelle page

← Version précédente		Version du 21 février 2018 à 13:59
Ligne 50 :		Ligne 50 :
	==== The default configuration (IERS2010) ====		==== The default configuration (IERS2010) ====

	The default configuration (IERS2010) is convenient for most applications. In this case, no operation pertaining to frames configurations needs to be undertaken. At the first call requiring frames, the [{{~~PathCurrentJavaDoc~~}}/FramesFactory fr/cnes/sirius/patrius/frames/FramesFactory.html] FramesFactory will create the default configuration and use it accordingly.		The default configuration (IERS2010) is convenient for most applications. In this case, no operation pertaining to frames configurations needs to be undertaken. At the first call requiring frames, the [{{JavaDoc4.0}}/FramesFactory fr/cnes/sirius/patrius/frames/FramesFactory.html] FramesFactory will create the default configuration and use it accordingly.

	The code snippet below is valid as long as the user has NOT passed a custom configuration to the FramesFactory.		The code snippet below is valid as long as the user has NOT passed a custom configuration to the FramesFactory.
Ligne 95 :		Ligne 95 :
	* account of the quantity ''s''' (IERS2010, IERS2003 or no effect).		* account of the quantity ''s''' (IERS2010, IERS2003 or no effect).

	To create a polar motion model with chosen parameters, PATRIUS provides the constructor '''PolarMotion''' (see [{{~~PathCurrentJavaDoc~~}}/fr/cnes/sirius/patrius/frames/configuration/PolarMotion.html PolarMotion javadoc] for the description of the above parameters).		To create a polar motion model with chosen parameters, PATRIUS provides the constructor '''PolarMotion''' (see [{{JavaDoc4.0}}/fr/cnes/sirius/patrius/frames/configuration/PolarMotion.html PolarMotion javadoc] for the description of the above parameters).

	===== Transformation relating TIRS to CIRS =====		===== Transformation relating TIRS to CIRS =====
Ligne 110 :		Ligne 110 :
	*account of libration effect ''dUT1,,libration,,'' in ''UT1'' (IERS2010 or no effect).'''Note that this effect is not yet implemented. It is negligible in current practical applications due to its very small size'''.		*account of libration effect ''dUT1,,libration,,'' in ''UT1'' (IERS2010 or no effect).'''Note that this effect is not yet implemented. It is negligible in current practical applications due to its very small size'''.

	To create a diurnal rotation model with chosen parameters, PATRIUS provides the constructor '''DiurnalRotation''' (see [{{~~PathCurrentJavaDoc~~}}/fr/cnes/sirius/patrius/frames/configuration/DiurnalRotation.html DiurnalRotation javadoc] for the description of the above parameters).		To create a diurnal rotation model with chosen parameters, PATRIUS provides the constructor '''DiurnalRotation''' (see [{{JavaDoc4.0}}/fr/cnes/sirius/patrius/frames/configuration/DiurnalRotation.html DiurnalRotation javadoc] for the description of the above parameters).

	===== Transformation relating CIRS to GCRS =====		===== Transformation relating CIRS to GCRS =====
Ligne 127 :		Ligne 127 :
	* account of non constant rotation (yes or no) to compute properly the velocity		* account of non constant rotation (yes or no) to compute properly the velocity

	To create a precession nutation model with chosen parameters, PATRIUS provides the constructor '''PrecessionNutation''' (see [{{~~PathCurrentJavaDoc~~}}/fr/cnes/sirius/patrius/frames/configuration/PrecessionNutation.html PrecessionNutation javadoc] for the description of the above parameters).		To create a precession nutation model with chosen parameters, PATRIUS provides the constructor '''PrecessionNutation''' (see [{{JavaDoc4.0}}/fr/cnes/sirius/patrius/frames/configuration/PrecessionNutation.html PrecessionNutation javadoc] for the description of the above parameters).

	===== Using specific EOP history files / data =====		===== Using specific EOP history files / data =====

	Earth Orientation Parameters (EOP) files provide angular corrections that account for short-period variations of Earths' [http://www.iers.org/nn_10828/IERS/EN/Service/Glossary/cip.html Celestial Intermediate Pole]. The corresponding data is used to compute the transformation from the TIRF to the ITRF frame. The amplitudes of the corrections are given in [FDY_FRAME_Home#HPolarmotion Polar Motion]. IN PATRIUS, the [{{~~PathCurrentJavaDoc~~}}/fr/cnes/sirius/patrius/frames/configuration/eop/EOPHistory.html EOPHistory] interface represents EOP data. It has two implementations : [{{~~PathCurrentJavaDoc~~}}/fr/cnes/sirius/patrius/frames/configuration/eop/EOP1980History.html EOP1980History] and [{{~~PathCurrentJavaDoc~~}}/fr/cnes/sirius/patrius/frames/configuration/eop/EOP2000History.html EOP2000History]. These classes differ because the EOP definition and representation has changed, according to the IERS conventions. Both remain available in PATRIUS.		Earth Orientation Parameters (EOP) files provide angular corrections that account for short-period variations of Earths' [http://www.iers.org/nn_10828/IERS/EN/Service/Glossary/cip.html Celestial Intermediate Pole]. The corresponding data is used to compute the transformation from the TIRF to the ITRF frame. The amplitudes of the corrections are given in [FDY_FRAME_Home#HPolarmotion Polar Motion]. IN PATRIUS, the [{{JavaDoc4.0}}/fr/cnes/sirius/patrius/frames/configuration/eop/EOPHistory.html EOPHistory] interface represents EOP data. It has two implementations : [{{JavaDoc4.0}}/fr/cnes/sirius/patrius/frames/configuration/eop/EOP1980History.html EOP1980History] and [{{JavaDoc4.0}}/fr/cnes/sirius/patrius/frames/configuration/eop/EOP2000History.html EOP2000History]. These classes differ because the EOP definition and representation has changed, according to the IERS conventions. Both remain available in PATRIUS.


Ligne 156 :		Ligne 156 :
	</syntaxhighlight>		</syntaxhighlight>

	Also, the user may create an empty EOPHistory object and populate it using a Java InputStream (usually, a file). with the adequate loader (see [{{~~PathCurrentJavaDoc~~}}/fr/cnes/sirius/patrius/frames/configuration/eop/package-summary.html eop package]) :		Also, the user may create an empty EOPHistory object and populate it using a Java InputStream (usually, a file). with the adequate loader (see [{{JavaDoc4.0}}/fr/cnes/sirius/patrius/frames/configuration/eop/package-summary.html eop package]) :

	<syntaxhighlight lang="java">		<syntaxhighlight lang="java">
Ligne 166 :		Ligne 166 :
	</syntaxhighlight>		</syntaxhighlight>

	Of course, in this case, the file has to be in the proper format for the EOP08C04FilesLoader (see its [{{~~PathCurrentJavaDoc~~}}/fr/cnes/sirius/patrius/frames/configuration/eop/EOP08C04FilesLoader.html javadoc] for information).		Of course, in this case, the file has to be in the proper format for the EOP08C04FilesLoader (see its [{{JavaDoc4.0}}/fr/cnes/sirius/patrius/frames/configuration/eop/EOP08C04FilesLoader.html javadoc] for information).

	For the 1980 EOP paradigm, the user must proceed in a similar fashion by manually creating an [{{~~PathCurrentJavaDoc~~}}/fr/cnes/sirius/patrius/frames/configuration/eop/EOP1980HistoryLoader.html EOP1980HistoryLoader] instance and feeding it to the EOPHistoryFactory.		For the 1980 EOP paradigm, the user must proceed in a similar fashion by manually creating an [{{JavaDoc4.0}}/fr/cnes/sirius/patrius/frames/configuration/eop/EOP1980HistoryLoader.html EOP1980HistoryLoader] instance and feeding it to the EOPHistoryFactory.

	*'''By automatically loading data using default EOP loaders:'''		*'''By automatically loading data using default EOP loaders:'''
Ligne 192 :		Ligne 192 :
	'''Note 1''': for the users and applications that do not require any EOP data, utility classes that return zero for all EOP corrections have been implemented. These classes possess validity intervals that span 100 years (1950 through 2050) for the EOP 1980 paradigm and infinity (-infinity through +infinity) for the EOP 2000 paradigm. This means that any application using these classes can request EOP data over these intervals.		'''Note 1''': for the users and applications that do not require any EOP data, utility classes that return zero for all EOP corrections have been implemented. These classes possess validity intervals that span 100 years (1950 through 2050) for the EOP 1980 paradigm and infinity (-infinity through +infinity) for the EOP 2000 paradigm. This means that any application using these classes can request EOP data over these intervals.

	* For the 1980 EOP paradigm, a loader class has been implemented : [{{~~PathCurrentJavaDoc~~}}/fr/cnes/sirius/patrius/frames/configuration/eop/NoEOP1980HistoryLoader.html NoEOP1980HistoryLoader]. The user need only to create an instance of that class and feed it the [{{~~PathCurrentJavaDoc~~}}/fr/cnes/sirius/patrius/frames/configuration/eop/EOPHistoryFactory.html EOPHistoryFactory] in order for all transformations to use zero for EOP corrections (only 1980). This done thanks to the following instruction : <code>EOPHistoryFactory.addEOP1980HistoryLoader(new NoEOP1980HistoryLoader())</code>. This loader then feeds an internal instance of EOP1980History, that the users does not manipulate directly.		* For the 1980 EOP paradigm, a loader class has been implemented : [{{JavaDoc4.0}}/fr/cnes/sirius/patrius/frames/configuration/eop/NoEOP1980HistoryLoader.html NoEOP1980HistoryLoader]. The user need only to create an instance of that class and feed it the [{{JavaDoc4.0}}/fr/cnes/sirius/patrius/frames/configuration/eop/EOPHistoryFactory.html EOPHistoryFactory] in order for all transformations to use zero for EOP corrections (only 1980). This done thanks to the following instruction : <code>EOPHistoryFactory.addEOP1980HistoryLoader(new NoEOP1980HistoryLoader())</code>. This loader then feeds an internal instance of EOP1980History, that the users does not manipulate directly.

	* For the 2000 EOP paradigm, a utility class, [{{~~PathCurrentJavaDoc~~}}/fr/cnes/sirius/patrius/frames/configuration/eop/NoEOP2000History.html NoEOP2000History], was created and represents an EOP history with no corrections (or more precisely 0.0). It has an infinite time interval of validity, from PAST_INFINITY to FUTURE_INFINITY.		* For the 2000 EOP paradigm, a utility class, [{{JavaDoc4.0}}/fr/cnes/sirius/patrius/frames/configuration/eop/NoEOP2000History.html NoEOP2000History], was created and represents an EOP history with no corrections (or more precisely 0.0). It has an infinite time interval of validity, from PAST_INFINITY to FUTURE_INFINITY.

	'''Note 2''': Note that most EOP providers are valid on data-provided timespan. The class <code>EOP2000HistoryConstantOutsideInterval</code> circumvents that limitation by returning boundaries values when requested date is out of data range. Warning: in this case, as the UT1-TAI remains constant the (UT1-UTC) absolute value returned may become higher than 0.9 second depending on leap seconds (for UTC time scale) existing outside this interval.		'''Note 2''': Note that most EOP providers are valid on data-provided timespan. The class <code>EOP2000HistoryConstantOutsideInterval</code> circumvents that limitation by returning boundaries values when requested date is out of data range. Warning: in this case, as the UT1-TAI remains constant the (UT1-UTC) absolute value returned may become higher than 0.9 second depending on leap seconds (for UTC time scale) existing outside this interval.
Ligne 200 :		Ligne 200 :
	===== Note on the internal representation of EOP Data =====		===== Note on the internal representation of EOP Data =====

	As of 2.1, EOP data sets have been modified to store the value of UT1-TAI instead of UT1-UTC. Additionally, new constructors that allow creating EOPEntry instances from UT1-TAI data have been added. The frames tranformations have thus become independent of the UTC-TAI.history file, provided that the user provides a correctly calculated UT1-TAI. Please refer to the [{{~~PathCurrentJavaDoc~~}}/fr/cnes/sirius/patrius/frames/configuration/eop/EOPEntry.html javadoc] for more information.		As of 2.1, EOP data sets have been modified to store the value of UT1-TAI instead of UT1-UTC. Additionally, new constructors that allow creating EOPEntry instances from UT1-TAI data have been added. The frames tranformations have thus become independent of the UTC-TAI.history file, provided that the user provides a correctly calculated UT1-TAI. Please refer to the [{{JavaDoc4.0}}/fr/cnes/sirius/patrius/frames/configuration/eop/EOPEntry.html javadoc] for more information.

	It should be noted that UT1 is defined with respect to UTC. Consequently, the only way to correctly compute UT1-TAI is per UT1-TAI = UT1-UTC + UTC-TAI.		It should be noted that UT1 is defined with respect to UTC. Consequently, the only way to correctly compute UT1-TAI is per UT1-TAI = UT1-UTC + UTC-TAI.

User Manual 4.0 Frames configuration - Historique des versions

Admin le 21 février 2018 à 13:59

Admin : /* Javadoc */

Admin le 20 février 2018 à 16:42

Admin : /* Classes */

Admin : /* Classes */

Admin : /* Interfaces */

Admin : Admin a déplacé la page Frames configuration vers User Manual 4.0 Frames configuration

Admin le 19 février 2018 à 08:39

Admin : 1 révision importée

Admin le 19 février 2018 à 08:26

Admin : /* Javadoc */

Admin : /* Classes */

Admin : /* Classes */

Admin : /* Interfaces */

Admin : Admin a déplacé la page Frames configuration vers User Manual 4.0 Frames configuration

Admin : 1 révision importée