Earth Features : Différence entre versions

De Wiki
Aller à : navigation, rechercher
(Since V11.4 version)
 
(13 révisions intermédiaires par le même utilisateur non affichées)
Ligne 7 : Ligne 7 :
 
== Frames configuration ==
 
== Frames configuration ==
  
Frames configuration is, by default, relatively simple as it has been considered the best ratio between precision and <font color=#FF8C00 title="Central Processing Unit">CPU</font> time. Anyway, it is possible to make it more complex. Nevertheless, be careful about the <font color=#FF8C00 title="Earth Orientation Parameters>EOP</font> corrections as it needs some data provided by [[https://logiciels.cnes.fr/en/node/64?type=desc PATRIUS_DATASET]] (included in the jar). So, if the data for a given epoch are not available, the propagation will exit with an error status.
+
Frames configuration is, by default, relatively simple as it has been considered the best ratio between precision and <font color=#FF8C00 title="Central Processing Unit">CPU</font> time. Anyway, it is possible to make it more complex. Nevertheless, be careful about the <font color=#FF8C00 title="Earth Orientation Parameters>EOP</font> corrections as it needs some data provided by [[https://logiciels.cnes.fr/en/node/64?type=desc PATRIUS_DATASET]] (included in the jar). <u>So, if the data for a given epoch are not available, the propagation will exit with an error status</u>.
  
''<font color=#FF0000>Note : in V11.0, by default configuration is the complex (factory) one.</font>''
+
''<font color=#FF0000>'''Note : in V11.0, by default configuration is the complex (factory) one.'''</font>''
 +
 
 +
=== How to update data ===
 +
 
 +
Nevertheless, in order not to wait for a new <font color=#556B2F>'''PSIMU'''</font> version, it is allways possible to put additional data (as <font color=#FF8C00 title="Earth Orientation Parameters>EOP</font> parameters or a new <font color=#FF8C00 title="Coordinated universal time>UTC</font>/<font color=#FF8C00 title="Temps Atomique International>TAI</font> gap) to the ones included Inside the [[https://logiciels.cnes.fr/en/node/64?type=desc PATRIUS_DATASET]] ''.jar'' file. This file may be used externally (when used '''psimu-xx.x.jar''') or internally (when used '''psimu-xx.x-jar-with-dependencies.jar''').
 +
==== Since V11.4 version ====
 +
 
 +
Since this V11.4 version it is really simpler to take into account additional data: we have just to add them in the directory defined by the '''ADDITIONAL_PATRIUS_DATA''' variable of the psimu.properties file (no need to respect the original hierarchical structure of [https://logiciels.cnes.fr/en/node/64?type=desc PATRIUS_DATASET] but be careful to respect the exact names)!
 +
 
 +
[[Fichier:EOP0.png|800px]]
 +
 
 +
==== For versions previous to  V11.4 ====
 +
 
 +
Let us show how to add, for example, some <font color=#FF8C00 title="Earth Orientation Parameters>EOP</font> data for year 2017.
 +
 
 +
* First, open the jar file using an application allowing to work with compressed files as [http://www.7-zip.org/ 7-Zip]
 +
* Then go through the .jar tree to reach the ''fr/cnes/sirius/addons.patriusdataset/earth-orientation-parameters'' directory ...
 +
 
 +
[[Fichier:EOP1.png|1000px]]
 +
 
 +
* At last, add inside the ''yearly'' subdirectory, a file obtained from the [https://www.iers.org/ IERS site] ... now you are able to propagate during all the year 2017 !
 +
 
 +
[[Fichier:EOP2.png|1000px]]
 +
 
 +
=== Frames dependencies ===
  
 
The following diagram explains the links between all considered frames.
 
The following diagram explains the links between all considered frames.
  
 
[[Fichier:FramesConfiguration.png]]
 
[[Fichier:FramesConfiguration.png]]
+
 
In the table below, we can see an example of precision versus <font color=#FF8C00>CPU</font> time depending on the frames configuration and for a 30 days <font color=#FF8C00>LEO</font> propagation:
+
=== Precision vs CPU ===
 +
 
 +
In the table below, we can see an example of precision versus <font color=#FF8C00 title="Central Processing Unit">CPU</font> time depending on the frames configuration and for a 30 days <font color=#FF8C00>LEO</font> propagation:
  
 
{| class="wikitable"
 
{| class="wikitable"
Ligne 50 : Ligne 76 :
 
|}
 
|}
  
Here is the example of the "''factory''" configuration for <font color=#FF8C00>IERS2010</font>:
+
Here is the example of the "''factory''" configuration for <font color=#FF8C00 title="International Earth Rotation and Reference Systems Service">IERS 2010</font>:
  
 
[[Fichier:EarthFeatures2.png]]
 
[[Fichier:EarthFeatures2.png]]

Version actuelle en date du 29 novembre 2019 à 07:22

Earth shape

First, the user will have to define some data relative to the Earth shape and its rotating frame as shown on the next image:

EarthFeatures1.png

Frames configuration

Frames configuration is, by default, relatively simple as it has been considered the best ratio between precision and CPU time. Anyway, it is possible to make it more complex. Nevertheless, be careful about the EOP corrections as it needs some data provided by [PATRIUS_DATASET] (included in the jar). So, if the data for a given epoch are not available, the propagation will exit with an error status.

Note : in V11.0, by default configuration is the complex (factory) one.

How to update data

Nevertheless, in order not to wait for a new PSIMU version, it is allways possible to put additional data (as EOP parameters or a new UTC/TAI gap) to the ones included Inside the [PATRIUS_DATASET] .jar file. This file may be used externally (when used psimu-xx.x.jar) or internally (when used psimu-xx.x-jar-with-dependencies.jar).

Since V11.4 version

Since this V11.4 version it is really simpler to take into account additional data: we have just to add them in the directory defined by the ADDITIONAL_PATRIUS_DATA variable of the psimu.properties file (no need to respect the original hierarchical structure of PATRIUS_DATASET but be careful to respect the exact names)!

EOP0.png

For versions previous to V11.4

Let us show how to add, for example, some EOP data for year 2017.

  • First, open the jar file using an application allowing to work with compressed files as 7-Zip
  • Then go through the .jar tree to reach the fr/cnes/sirius/addons.patriusdataset/earth-orientation-parameters directory ...

EOP1.png

  • At last, add inside the yearly subdirectory, a file obtained from the IERS site ... now you are able to propagate during all the year 2017 !

EOP2.png

Frames dependencies

The following diagram explains the links between all considered frames.

FramesConfiguration.png

Precision vs CPU

In the table below, we can see an example of precision versus CPU time depending on the frames configuration and for a 30 days LEO propagation:

Case Corrections Max position error (m) Max velocity error (m/s) CPU time (s)
1 All (IERS2010) - - 4.24
2 All except EOPs 14.6 1.68E-02 4.02
3 Only Precession-Nutation 14.6 1.68E-02 2.88
4 No corrections 469 5.42E-01 1.97

Here is the example of the "factory" configuration for IERS 2010:

EarthFeatures2.png