WELCOME TO THE PSIMU WIKI : Différence entre versions

Version du 13 janvier 2020 à 13:14

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:

• It is now possible to select which time scale will be used in the ephemeris/events files. Unfortunately, the comment included in the header of such files has not been updated and it is always written TAI as in the previous versions :

 1 : DATE ~cal (date (TAI))

See also possible anomalies raised due to [GENOPUS] or [GENIUS] widgets used by PSIMU.

In particular, due to a [GENIUS] anomaly, when using the Custom plots tab, we can normally display data together from the ephemeris table data but also from the events table. With this version, it is no more possible. To do it up to now, we must display data of the second table using the secondary axis possibility.

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

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