WELCOME TO THE PSIMU WIKI
WHERE TO GET IT ?
Just go there ...
WHAT IS PSIMU?
PSIMU is a CNES tool allowing to propagate trajectories around the Earth. These trajectories may be:
- Elliptical ones (all kind of orbits, from LEO to GEO passing through MEO or HEO),
- Hyperbolic ones,
- Atmospheric ones (in particular in case of debris reentries).
PSIMU is usable via three modes:
- GUI: its utilization is made user-friendly thanks to a graphical user interface (developed using [GENIUS] and [GENOPUS]),
- Batch using a context file (in XML format),
- Library via its Java interface.
Its initialization is made by:
- The initial orbital parameters definition (epoch, frame, coordinates) with a great number of available options.
- The vehicle modelling:
- - Vehicle shapes (sphere, cylinder and parallelepiped) with or without solar panels,
- - Dimensions or surfaces,
- - Aerodynamic characteristics and/or radiative pressure ones,
- - Propulsive characteristics (engines, tanks).
- A maneuver sequence (optional) including impulsive maneuvers and/or continuous ones
- A sequence of attitude laws (optional) ; indeed, if PSIMU does not manage 6 DDL motion, it owns as input data, attitude laws depending on orbital events, allowing to know at every moment the vehicle attitude and thus, to deduce from it the forces applied to the vehicle.
- Numerical integrator parametrization (Runge Kutta or Dormand Price) with, for usual applications, by default settings.
- Choice of force models within:
- - Potential with several models available as the possibility to manage degree and order of zonal and tesseral terms,
- - Other bodies attraction : Moon and Sun via analytical or numerical ephemeris,
- - Atmospheric forces using different atmospheric models and their associated settings,
- - Solar radiative pressure (direct or rediffused one)
- - Oceanic and terrestrial tides
PSIMU also allows to set its output data within several tens of variables, the output frame and, of course, the output step. A graphical interface for plots is also integrated.
HOW TO USE IT?
PSIMU may be used very quickly via its GUI facilitating context elaboration and results exploitation. No code knowledge is necessary. It is also possible to use it in batch mode via a shell and especially on grid computers with no display properties. On the other hand, it is also possible to use it via its Java interface inside a higher level tool (for example, an orbit determination tool or a maneuver optimization tool).
So, three jar files are available:
- psimu-NN.n-jar-with-dependencies.jar : executable jar including all needed libraries => it is the file to use for GUI utilization but it may also be used for the Java interface
- psimu-NN.n.jar : includes only PSIMU classes => to be used for Java interface, under the condition of linking with the right version of [GENOPUS] and [PATRIUS]
- psimu-NN.n-javadoc.jar
REMARKS
- Java version available externally to CNES (previous versions to V11.x were coded in Fortran 95 and V11.0 were only for internal CNES purposes).
- As it is coded in Java, this product is available for any kind of platforms owning Java. An executable jar (launching the GUI) including all dependencies is provided.
- PSIMU is provided as a Freeware under a CNES specific license via this site.
- Some tutorials are available.
CURRENT VERSION : V11.4
New version, now linked with last PATRIUS V4.4 version, correcting V11.3 anomalies and with some interesting new functionalities (see here).
Known bugs of this version: none
See also possible anomalies raised due to [GENOPUS] widgets used by PSIMU.
PREVIOUS VERSIONS
- version 11.3: linked with PATRIUS V4.1.1 version, correcting V11.2 anomalies and with some interesting new functionalities (see here).
- version 11.2/11.2.1 : first version available CNES outside; it corrects few minor anomalies and is now linked with PatriusDataset 1.0.3.
- version 11.1: this version includes essentially ergonomy improvement of the tool. Nevertheless, some new functionalities as SQLite output files have a real interest.
- version 11.0: first Java version available only inside CNES.
DEPENDENCIES
| Version | 11.4 | 11.3 | 11.2 / 11.2.1 | 11.1 | 11.0 |
| Disponibility | from 8th Nov 2019 | from 14th Dec 2018 | from 14th Nov 2017 | - | - |
| Javadoc | - | yes | yes | yes | yes |
| Dependencies | Java 1.8 Patrius 4.4 (not compatible with other versions) PatriusDataset 1.1.0 Genopus 2.1.1 Genius 1.9.1 Miglayout 4.2 Jdom 1.1.2 Gettext-commons 0.9.8 JFreeChart 1.0.19 commons-io 2.4 sqlite-jdbc 3.15.1 |
Java 1.7 Patrius 4.1.1 (not compatible with other versions) PatriusDataset 1.1.0 Genopus 2.0.1 Genius 1.8 Miglayout 4.2 Jdom 1.1.2 Gettext-commons 0.9.8 JFreeChart 1.0.19 commons-io 2.4 sqlite-jdbc 3.15.1 |
Java 1.7 Patrius 3.3 (not compatible with other versions) PatriusDataset 1.0.3 Genopus 1.3.1 Genius 1.7 Miglayout 4.2 Jdom 1.1.2 Gettext-commons 0.9.8 JFreeChart 1.0.19 commons-io 2.4 sqlite-jdbc 3.15.1 |
Java 1.7 Patrius 3.3 (not compatible with other versions) PatriusDataset 1.0.2 Genopus 1.3 Genius 1.7 Miglayout 4.2 Jdom 1.1.2 Gettext-commons 0.9.8 JFreeChart 1.0.19 commons-io 2.4 sqlite-jdbc 3.15.1 |
Java 1.7 Patrius 3.2 (not compatible with other versions) PatriusDataset 1.0.2 Genopus 1.2.1 Genius 1.6.x Miglayout 4.2 Jdom 1.1.2 Gettext-commons 0.9.8 JFreeChart 1.0.19 commons-io 2.4 |
JAVA DOC
Current Java Doc
Java Doc 11.4
Java Doc 11.3
Java Doc 11.2
Java Doc 11.1
Java Doc 11.0
