|
|
| (48 révisions intermédiaires par le même utilisateur non affichées) |
| Ligne 1 : |
Ligne 1 : |
| | __NOTOC__ | | __NOTOC__ |
| − | == WHERE TO GET IT ? == | + | Welcome to the <font color=#556B2F>'''PSIMU'''</font> wiki, a [https://cnes.fr/fr '''CNES'''] flight dynamics tool. As it is coded in <font color=#FF8C00>Java</font>, this product is available for any kind of platforms owning a <font color=#FF8C00 title="JavaVirtual Machine">JVM</font>. |
| | | | |
| − | Just go [https://logiciels.cnes.fr/en/content/psimu there] ...
| + | == DESCRIPTION == |
| | | | |
| − | == WHAT IS PSIMU? ==
| + | [[What_is_Psimu|'''What is PSIMU?''']] |
| | | | |
| − | <font color=#556B2F>'''PSIMU'''</font> is a [https://cnes.fr/fr '''CNES'''] tool allowing to propagate trajectories around the Earth. These trajectories may be: | + | ::<font color=#556B2F>'''PSIMU'''</font> is a [https://cnes.fr/fr '''CNES'''] tool allowing to propagate trajectories around the Earth. |
| − | * <font color=#FF0000>'''Elliptical'''</font> ones (all kind of orbits, from <font color=#FF8C00 title="Low Earth Orbit">LEO</font> to <font color=#FF8C00 title="Geostationary Earth Orbit">GEO</font> passing through <font color=#FF8C00 title="Medium Earth Orbit">MEO</font> or <font color=#FF8C00 title="High Elliptical Earth Orbit">HEO</font>),
| + | |
| − | * <font color=#FF0000>'''Hyperbolic'''</font> ones,
| + | |
| − | * <font color=#FF0000>'''Atmospheric'''</font> ones (in particular in case of debris reentries).
| + | |
| | | | |
| − | <font color=#556B2F>'''PSIMU'''</font> is usable via three modes:
| + | [[Current_version|'''Current version''']] |
| − | * <font color=#FF8C00 title="Graphical User Interface">GUI</font>: its utilization is made user-friendly thanks to a graphical user interface (developed using [[http://genius.cnes.fr GENIUS]] and [[http://genopus.cnes.fr GENOPUS]]),
| + | |
| − | * Batch using a context file (in <font color=#FF8C00 title="Extensible Markup Language">XML</font> format),
| + | |
| − | * Library via its <font color=#FF8C00>Java</font> interface.
| + | |
| | | | |
| − | Its initialization is made by:
| + | ::The current version is: <font color=#FF0000>'''V11.7.4'''</font>. |
| − | * 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 (<font color=#FF8C00>Runge Kutta</font> or <font color=#FF8C00>Dormand Price</font>) 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
| + | |
| | | | |
| − | <font color=#556B2F>'''PSIMU'''</font> 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.
| + | [[Previous_versions|'''Previous versions''']] |
| | | | |
| − | == HOW TO USE IT? ==
| + | ::Describes evolutions thanks to previous versions. |
| | | | |
| − | <font color=#556B2F>'''PSIMU'''</font> may be used very quickly via its <font color=#FF8C00 title="Graphical User Interface">GUI</font> facilitating context elaboration and results exploitation. No code knowledge is necessary.
| + | == USE IT == |
| − | 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 <font color=#FF8C00>Java</font> interface inside a higher level tool (for example, an orbit determination tool or a maneuver optimization tool).
| + | |
| | | | |
| − | So, three jar files are available:
| + | [[Where_to_get_it|'''Where to get it?''']] |
| | | | |
| − | * '''psimu-NN.n-jar-with-dependencies.jar''' : executable jar including all needed libraries => it is the file to use for <font color=#FF8C00 title="Graphical User Interface">GUI</font> utilization but it may also be used for the <font color=#FF8C00>Java</font> interface
| + | ::Where to download it. |
| − | * '''psimu-NN.n.jar''' : includes only <font color=#556B2F>'''PSIMU'''</font> classes => to be used for <font color=#FF8C00>Java</font> interface, under the condition of linking with the right version of [[http://genopus.cnes.fr GENOPUS]] and [[http://patrius.cnes.fr PATRIUS]]
| + | |
| − | * '''psimu-NN.n-javadoc.jar'''
| + | |
| | | | |
| − | == REMARKS ==
| + | [[Quick start|'''Quick start''']] |
| − | * Java version available externally to [https://cnes.fr/fr '''CNES'''] (previous versions to V11.x were coded in <font color=#FF8C00>Fortran 95</font> and V11.0 were only for internal [https://cnes.fr/fr '''CNES'''] purposes).
| + | |
| − | * As it is coded in <font color=#FF8C00>Java</font>, this product is available for any kind of platforms owning <font color=#FF8C00>Java</font>. An executable jar (launching the <font color=#FF8C00 title="Graphical User Interface">GUI</font>) including all dependencies is provided.
| + | |
| − | * <font color=#556B2F>'''PSIMU'''</font> is provided as a Freeware under a [https://cnes.fr/fr '''CNES'''] specific license via this [https://logiciels.cnes.fr/en/home site].
| + | |
| − | * Some tutorials are available.
| + | |
| | | | |
| − | == CURRENT VERSION : V11.3 ==
| + | ::First steps with <font color=#556B2F>'''PSIMU'''</font> |
| − | New version, now linked with last [http://patrius.cnes.fr PATRIUS] V4.1.1 version, correcting V11.2 anomalies and with some interesting new functionalities (see [[Main_differences_between_V11.2_and_V11.3|here]]).
| + | |
| | | | |
| − | <u>Known bugs of this version</u>:
| + | [[User_Manual|'''User Manual''']] |
| | | | |
| − | * when initial orbital parameters correspond to an hyperbolic trajectory, <font color=#556B2F>'''PSIMU'''</font> will exit in error because of some output data computation.
| + | ::<font color=#556B2F>'''PSIMU'''</font> may be used very quickly via its <font color=#FF8C00 title="Graphical User Interface">'''GUI'''</font> facilitating context elaboration and results exploitation. No code knowledge is necessary. |
| − | * when propagation duration is exactly equals to zero, <font color=#556B2F>'''PSIMU'''</font> will exit in error.
| + | ::Anyway, it is also possible to use it in <font color=#FF8C00>'''batch'''</font> mode (especially on grid computers with no display properties) or using its <font color=#FF8C00>'''Java'''</font> interface. |
| − | * use of mean zonal terms is wrong in case of ''Droziner'' or ''Cunningham'' équations (not available in <font color=#FF8C00 title="Graphical User Interface">GUI</font> mode)
| + | |
| − | * In <font color=#FF8C00>Java</font> mode, using '''FILE_SC_BINARY''' output option, calling <font color=#4169E1>getSpacecraftStateList()</font> or <font color=#4169E1>getSpacecraftState(i)</font> methods does not give the same rkind of results (sort problem).
| + | |
| − | * geocentric altitude and latitude computation (so in <font color=#FF8C00 title="International Terrestrial Reference Frame">ITRF</font> frame) is in fact done with intertial position coordinates
| + | |
| | | | |
| − | == PREVIOUS VERSIONS == | + | == DOCUMENTATION == |
| − | * version 11.2/11.2.1 : first version available [https://cnes.fr/fr '''CNES'''] outside; it corrects few minor anomalies and is now linked with [https://logiciels.cnes.fr/en/content/patriusdataset PatriusDataset] 1.0.3.
| + | |
| − | * version 11.1: this version includes essentially ergonomy improvement of the tool. Nevertheless, some new functionalities as [https://www.sqlite.org/ SQLite] output files have a real interest.
| + | |
| − | * version 11.0: first Java version available only inside [https://cnes.fr/fr '''CNES'''].
| + | |
| | | | |
| − | == DEPENDENCIES ==
| + | [[Java_Doc|'''Java Doc''']] |
| − | {| class="wikitable"
| + | |
| − | |-
| + | |
| − | |Version
| + | |
| − | |style="text-align:center;"|11.4
| + | |
| − | |style="text-align:center;"|11.3
| + | |
| − | |style="text-align:center;"|11.2 / 11.2.1
| + | |
| − | |style="text-align:center;"|11.1
| + | |
| − | |style="text-align:center;"|11.0
| + | |
| − | |-
| + | |
| − | |Disponibility
| + | |
| − | |style="text-align:center;"|november 2019
| + | |
| − | |style="text-align:center;"|from 14/12/2018
| + | |
| − | |style="text-align:center;"|from 14/11/2017
| + | |
| − | |style="text-align:center;"| -
| + | |
| − | |style="text-align:center;"| -
| + | |
| − | |-
| + | |
| − | |Javadoc
| + | |
| − | |style="text-align:center;"|-
| + | |
| − | |style="text-align:center;"|yes
| + | |
| − | |style="text-align:center;"|yes
| + | |
| − | |style="text-align:center;"|yes
| + | |
| − | |style="text-align:center;"|yes
| + | |
| − | |- style="vertical-align:top;"
| + | |
| − | |Dependencies
| + | |
| − | |style="text-align:center;"|Java 1.8<br/>Patrius 4.4 (not compatible with other versions)<br/> PatriusDataset 1.1.0<br/> Genopus 2.1<br/> Genius 1.9.1<br/> Miglayout 4.2<br/> Jdom 1.1.2<br/> Gettext-commons 0.9.8<br/> JFreeChart 1.0.19<br/> commons-io 2.4<br/> sqlite-jdbc 3.15.1
| + | |
| − | |style="text-align:center;"|Java 1.7<br/>Patrius 4.1.1 (not compatible with other versions)<br/> PatriusDataset 1.1.0<br/> Genopus 2.0.1<br/> Genius 1.8<br/> Miglayout 4.2<br/> Jdom 1.1.2<br/> Gettext-commons 0.9.8<br/> JFreeChart 1.0.19<br/> commons-io 2.4<br/> sqlite-jdbc 3.15.1
| + | |
| − | |style="text-align:center;"|Java 1.7<br/>Patrius 3.3 (not compatible with other versions)<br/> PatriusDataset 1.0.3<br/> Genopus 1.3.1<br/> Genius 1.7<br/> Miglayout 4.2<br/> Jdom 1.1.2<br/> Gettext-commons 0.9.8<br/> JFreeChart 1.0.19<br/> commons-io 2.4<br/> sqlite-jdbc 3.15.1
| + | |
| − | |style="text-align:center;"|Java 1.7<br/>Patrius 3.3 (not compatible with other versions)<br/> PatriusDataset 1.0.2<br/> Genopus 1.3<br/> Genius 1.7<br/> Miglayout 4.2<br/> Jdom 1.1.2<br/> Gettext-commons 0.9.8<br/> JFreeChart 1.0.19<br/> commons-io 2.4<br/> sqlite-jdbc 3.15.1
| + | |
| − | |style="text-align:center;"|Java 1.7<br/>Patrius 3.2 (not compatible with other versions)<br/> PatriusDataset 1.0.2<br/> Genopus 1.2.1<br/> Genius 1.6.x<br/> Miglayout 4.2<br/> Jdom 1.1.2<br/> Gettext-commons 0.9.8<br/> JFreeChart 1.0.19<br/> commons-io 2.4
| + | |
| − | |}
| + | |
| | | | |
| − | == JAVA DOC== | + | ::Access to current and old <font color=#FF8C00>Java</font> doc. |
| − | [{{PathCurrentJavaDoc}} Current Java Doc]<br />
| + | |
| − | [{{CurrentServer}}/uploads/JavaDocs/V11.3 Java Doc 11.3]<br /> | + | [[Dependencies|'''Dependencies''']] |
| − | [{{CurrentServer}}/uploads/JavaDocs/V11.2 Java Doc 11.2]<br />
| + | |
| − | [{{CurrentServer}}/uploads/JavaDocs/V11.1 Java Doc 11.1]<br /> | + | ::Describes dependencies with other products. |
| − | [{{CurrentServer}}/uploads/JavaDocs/V11.0 Java Doc 11.0]<br />
| + | |
| | + | [[News|'''News''']] |
| | + | |
| | + | ::Main evolutions of the tool or its Wiki. |
