Quick start : Différence entre versions

De Wiki
Aller à : navigation, rechercher
(Launch the main GUI)
 
(34 révisions intermédiaires par le même utilisateur non affichées)
Ligne 1 : Ligne 1 :
<font color=#556B2F>'''PSIMU'''</font> proposes a lot of options and configurations to propagate an orbit. Anyway, in order to allow to start first simulations very quickly, the <font color=#556B2F>'''PSIMU'''</font> <font color=#FF8C00 title="Graphical User Interface">GUI</font> owns many parameters with by default values.
+
<font color=#556B2F>'''PSIMU'''</font> proposes a lot of options and configurations to propagate an orbit. Anyway, in order to allow to start first simulations very quickly, the <font color=#556B2F>'''PSIMU'''</font> <font color=#FF8C00 title="Graphical User Interface">GUI</font>, many parameters are set to default values.
  
To launch this <font color=#FF8C00 title="Graphical User Interface">GUI</font> you only have to double click on <font color=#FF8C00>Windows</font> systems or type :
+
=== Launch the main GUI ===
 +
To launch the <font color=#FF8C00 title="Graphical User Interface">GUI</font> you only have to double click on <font color=#FF8C00>Windows</font> systems or type :
  
 
   java -jar psimu-xx.x-jar-with-dependencies.jar
 
   java -jar psimu-xx.x-jar-with-dependencies.jar
  
The first time, the <font color=#FF8C00 title="Graphical User Interface">GUI</font> is launched an specific directory where result files will be stored will be created : OUTPUT_'''JPSIMU'''
+
The first time, the <font color=#FF8C00 title="Graphical User Interface">GUI</font> is launched, a file named '''psimu.properties''' is extracted from the jar. This file contains four names of predefined directories:
  
[[Fichier:OutputDirectory.png]]
+
* '''PSIMU_OUTPUT_DIR''' where results will be stored by default
 +
* '''PSIMU_DATA_DIR''' where scenario files will be stored by default
 +
* '''ADDITIONAL_PATRIUS_DATA''' where it will be possible to store additional data models used by PATRIUS (for example <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); see [http://psimu.cnes.fr/index.php/Earth_Features#How_to_update_data here].
 +
* '''PSIMU_TEMP_DIR'''  temporary directory for database storage.
  
Then, it has been decided to avoid to get too many default values. Only the following parameters must be initialized:
+
  PSIMU_OUTPUT_DIR = PSIMU_OUTPUT
* orbital parameters which will be set to zero
+
  PSIMU_DATA_DIR = PSIMU_DATA
* attitude law
+
  ADDITIONAL_PATRIUS_DATA = PSIMU_DATA/AdditionalPatriusData
 +
  PSIMU_TEMP_DIR = PSIMU_TMP
  
So, to be able to execute a propagation, the user will have, at least, to:
+
So the four directories will be automatically created if they do not exist.
* enter a non nul semi mlajor axis (for example 7000 km) in the orbit tab (see here)
+
  
[[Fichier:FirstUse1.png]] [[Fichier:FirstUse1bis.png]]
+
Of course it will be possible to change the values of these four variables but, in that case, <font color=#556B2F>'''PSIMU'''</font> will have to be launched again.
  
* select the default law as the single attitude law (see here)
+
''<font color=#FF0000>Note: in versions previous to the V11.4, this properties mechanism did not exist and only a specific directory (where result files was stored) was automatically created : '''OUTPUT_JPSIMU'''</font>''
 +
 
 +
=== Initialize mandatory data ===
 +
Since V11.4, only the orbital parameters (initially set to zero) has to be initialized as it is not very clever to give a "default" orbit.
 +
 
 +
''<font color=#FF0000>Note: for versions previous to the V11.4, attitude law have to be initialized. Since V11.4, it has been decided to set by default an attitude law (in the <font color=#FF8C00>TNW</font> local frame).</font>''
 +
 
 +
==== Initial orbit ====
 +
To do it, enter a non nul semi major axis (for example 7000 km) in the orbit tab:
 +
 
 +
[[Fichier:FirstUse1.png|800px]] => [[Fichier:FirstUse1bis.png|800px]]
 +
 
 +
==== Attitude law ====
 +
So, since V11.4 a default law is already selected.
 +
 
 +
[[Fichier:FirstUse2.png|800px]] => [[Fichier:FirstUse2bis.png|400px]]
 +
 
 +
==== Dry mass ====
 +
It is possible to let the initial dry mass to zero as below (it only raises a warning). Nevertheless, if the user will add some forces, attitudes or anything that needs to divide by the total mass, then, the data will change from warning to error status (in versions previous to the V11.4, there were no status changes but an error message was only sent) and the propagation will not be launched.
 +
 
 +
[[Fichier:FirstUse3.png|800px]]
 +
 
 +
=== Propagate ===
 +
At the end, we have just to start the propagation by clicking on the "'''Compute''' "button ...
 +
 
 +
[[Fichier:FirstUse4.png|800px]]

Version actuelle en date du 12 novembre 2019 à 09:12

PSIMU proposes a lot of options and configurations to propagate an orbit. Anyway, in order to allow to start first simulations very quickly, the PSIMU GUI, many parameters are set to default values.

Launch the main GUI

To launch the GUI you only have to double click on Windows systems or type :

 java -jar psimu-xx.x-jar-with-dependencies.jar

The first time, the GUI is launched, a file named psimu.properties is extracted from the jar. This file contains four names of predefined directories:

  • PSIMU_OUTPUT_DIR where results will be stored by default
  • PSIMU_DATA_DIR where scenario files will be stored by default
  • ADDITIONAL_PATRIUS_DATA where it will be possible to store additional data models used by PATRIUS (for example EOP parameters or a new UTC/TAI gap); see here.
  • PSIMU_TEMP_DIR temporary directory for database storage.
 PSIMU_OUTPUT_DIR = PSIMU_OUTPUT
 PSIMU_DATA_DIR = PSIMU_DATA
 ADDITIONAL_PATRIUS_DATA = PSIMU_DATA/AdditionalPatriusData
 PSIMU_TEMP_DIR = PSIMU_TMP

So the four directories will be automatically created if they do not exist.

Of course it will be possible to change the values of these four variables but, in that case, PSIMU will have to be launched again.

Note: in versions previous to the V11.4, this properties mechanism did not exist and only a specific directory (where result files was stored) was automatically created : OUTPUT_JPSIMU

Initialize mandatory data

Since V11.4, only the orbital parameters (initially set to zero) has to be initialized as it is not very clever to give a "default" orbit.

Note: for versions previous to the V11.4, attitude law have to be initialized. Since V11.4, it has been decided to set by default an attitude law (in the TNW local frame).

Initial orbit

To do it, enter a non nul semi major axis (for example 7000 km) in the orbit tab:

FirstUse1.png => FirstUse1bis.png

Attitude law

So, since V11.4 a default law is already selected.

FirstUse2.png => FirstUse2bis.png

Dry mass

It is possible to let the initial dry mass to zero as below (it only raises a warning). Nevertheless, if the user will add some forces, attitudes or anything that needs to divide by the total mass, then, the data will change from warning to error status (in versions previous to the V11.4, there were no status changes but an error message was only sent) and the propagation will not be launched.

FirstUse3.png

Propagate

At the end, we have just to start the propagation by clicking on the "Compute "button ...

FirstUse4.png