Quick start : Différence entre versions
(→Launch the main GUI) |
|||
(38 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> | + | <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 | + | === 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 | + | 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: |
− | + | * '''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. | ||
− | So, to be | + | 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, <font color=#556B2F>'''PSIMU'''</font> will have to be launched again. | ||
+ | |||
+ | ''<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.
Sommaire
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:
Attitude law
So, since V11.4 a default law is already selected.
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.
Propagate
At the end, we have just to start the propagation by clicking on the "Compute "button ...