« GPlotPanel » : différence entre les versions

De GENIUS
Aller à la navigation Aller à la recherche
Aucun résumé des modifications
 
(34 versions intermédiaires par le même utilisateur non affichées)
Ligne 1 : Ligne 1 :
There is another higher level widget [{{PathCurrentJavaDoc}}/fr/cnes/genius/plots/GPlotPanel.html GPlotPanel]] allowing to plot data stored in a file with a given format as described here below ...
There is another higher level widget [{{PathCurrentJavaDoc}}/fr/cnes/genius/plots/GPlotPanel.html GPlotPanel] allowing to plot data stored in a file with the "'''Madona'''" or [https://www.sqlite.org/ SQLite] formats given format as described [[ResultsFileManagement|here]].  
 
<syntaxhighlight lang="java">
#<AM-acces:COL-V2.0>
<INIT:
Logiciel="DOORS"
VERSION="V10.0"
<COL:
  0 : DATE ~cal (Date)
  1 : TIME ~s (Time)
  2 : X ~m (Integration Frame X Coordinates)
  3 : Y ~m (Integration Frame Y Coordinates)
  4 : Z ~m (Integration Frame Z Coordinates)
  5 : VX ~m/s (Integration Frame X Velocity Coordinates)
  6 : VY ~m/s (Integration Frame Y Velocity Coordinates)
  7 : VZ ~m/s (Integration Frame Z Velocity Coordinates)
  8 : PSI ~deg (Integration Frame Pitch Angle)
  9 : TETA ~deg (Integration Frame Yaw Angle)
  10 : PHI ~deg (Integration Frame Roll Angle)
 
>
>
2010-01-01T00:00:00.000 0.000000000000000e+00  6.678133638255782e+06  3.787739409565575e-01 -6.700773491792874e+03 -6.052524398242765e+00  4.780628779989441e+03 -6.031804544978191e+03  9.000000000000000e+01  5.160000022816957e+01  2.699999999999999e+02
2010-01-01T00:00:10.000 1.000000000000000e+01  6.677625571129634e+06  4.780559859589861e+04 -6.701701843926338e+04 -9.555978350214156e+01  4.780308392028196e+03 -6.031309305094114e+03  9.106301358852552e+01  5.159519405116432e+01  2.708330583318874e+02
...
</syntaxhighlight>
 
Note that to be interpreted, dates must have the "<font color=#FF8C00>yyyy-mm-ddThh:mm:ss.sss</font>" format (and the "unit" must be <font color=#FF8C00>~cal</font>).


Using this widget is very simple as you have just to instantiate and then display it. To instantiate it, you must give at least (for the "'''Madona'''" files):
* the prefix of the files you want to read
* the suffix of the files you want to read
* a comment giving a description of this kind of files
* the maximum number of detached plot windows. If greater than 0 a "+" button wille be displayed in order to allow to display other plots in detached panels


Using this widget is very simple as you have just to instantiate and then display it. To instantiate it, you must give :
Nevertheless, you have the possibility to specify which kind of files you will have to consider, adding an additionnal parameter:
* the prefix of the files you want to read
* either [{{PathCurrentJavaDoc}}/fr/cnes/genius/plots/GPlotDataMadonaReader.html GPlotDataMadonaReader]
* the suffix of the files you want to read
* or [{{PathCurrentJavaDoc}}/fr/cnes/genius/sqlite/GPlotDataSqliteReader.html GPlotDataSqliteReader]
* a comment giving a description of this kind of files
* the maximum number of detached plot windows. If greater than 0 a "+" button wille be displayed in order to allow to display other plots in detached panels


In the following example, we will check for EPH_* files (no specific suffix).
In the following example, we will check for EPH_* files (no specific suffix).


<syntaxhighlight lang="java">
<syntaxhighlight lang="java">
     GPlotPanel plots = new GPlotPanel("EPH", "", "Ephemeris file", 0);
     GPlotPanel plots = new GPlotPanel("EPH", "", "Ephemeris file", 0, true);
      
      
     ...
     ...
Ligne 51 : Ligne 27 :
This panel will then appear ...
This panel will then appear ...


{{:user_manual:gplotpanel1.jpg|}}
[[File:GPlotPanel1.jpg]]
 


After selecting a file ...
After selecting a file ...


{{:user_manual:gplotpanel2.jpg|}}
[[File:GPlotPanel2.jpg]]
 


We may have something like that ...
We may have something like that ...


{{:user_manual:gplotpanel3.jpg|}}
[[File:GPlotPanel3.jpg]]
 
== Additional files ==
 
Note that, since the V1.9 verison, it is now possible to plot additional files to make comparison between them. It is also possible to get relative values but this functionnality is now relatively limited as it is necessary to have exactly the same amount of lines between each files and no interpolation are made if abscissae are different.
 
[[File:GPlotPanel4.jpg]]
 
== EVENT files ==
 
Since V1.10, it is now possible to plot "'''EVENT'''" files coming, for example, from the [http://psimu.cnes.fr PSIMU] software. These files look exactly the same as [[ResultsFileManagement#Madona_files|Madona files]] except the first column which includes characters describing the kind of event. Here is an example of such a file:
 
<syntaxhighlight lang="java">
#<AM-acces:COL-V2.0>
<INIT:
Logiciel="JPSIMU"
VERSION="V11.4.1"
<COL:
  1 : EVENT ~ (Event code)
  2 : DATE ~cal (date)
  3 : TIME ~s (duration since initial conditions)
  4 : A ~km (semi-major axis)
  5 : E ~ (eccentricity)
  6 : I ~deg (inclination)
  7 : ALTG ~km (geodetic altitude)
  8 : LATG ~deg (geodetic latitude)
  9 : LON ~deg (longitude)
>
>
Constant thrust maneuver Maneuver1 start: Relative date (0j00h10m00s)    2000-01-01T00:10:00.000        6.00000000000000e+02        7.00000006665629e+03        9.52233579255254e-09        5.15999981057783e+01        6.26650567709823e+02        2.83267318798703e+01      -7.73441356109702e+01
Constant thrust maneuver Maneuver1 end: Date (2000-01-01T00:12:12.000)    2000-01-01T00:11:40.000        7.00000000000000e+02        7.07569671802727e+03        1.06930031433105e-02        5.15999981057783e+01        6.28194776514761e+02        3.26360096408306e+01      -7.25917790877161e+01
 
</syntaxhighlight>
 
== Calculator ==
 
Since V1.11.2 version, there is the possibility to create new variables using initial ones from a '''MADONA''' column file via specific equations. This functionnality is not yet available for [https://www.sqlite.org/ SQLite] files.
 
Once the user have loaded a file, a specific button appears : [[File:GCalculator0.png]].
 
If we push on that button a new window will appear where it will be possible to define specific equation(s) to get additional variables. In the example below, we have define the "'''VZ'''" variable for the vertical velocity, defined by <math>V_z = V_{rel}*sin(\gamma_{rel})</math> with <math>V_{rel} = VREL</math> and <math>\gamma_{rel} = FPAR</math>.
 
[[File:GCalculator1.png]]
 
We can see that we have access to :
 
* The list of initial variables
* Some specific functions
* The possibility to load, save or clear an equation or a list of equations
* For each equation, we will have to define :
** the name of the new variable
** its unit
** a description of this variable
** the gap for plot discontinuities
 
For each formula, we may reset the data or the formula and also validate it :
 
If the formula is valid this pop-up window will appear : [[File:GCalculator2.png]]
 
On the contrary (for example [[File:GCalculator3.png]]), this pop-up window will be displayed:
 
[[File:GCalculator4.png]]
 
At the end, we may :
* Validate all the formulae
* Create a file to store these formulae
* Quit the calculator panel without or with using these formulae. In this last case, the new variable(s) will be added to the initial ones.
 
[[File:GCalculator5.png]] => [[File:GCalculator6.png]]
 
== GPLOT utility ==
 
If users want to use [{{PathCurrentJavaDoc}}/fr/cnes/genius/plots/GPlotPanel.html GPlotPanel] functions without coding, since V1.9 version, it is possible to use directly a compiled tool with its own <font color=#FF8C00 title="Graphical User Interface">GUI</font>. It is provided with the full zip package and to use it, you have just to double clicked on the jar file or type the following command:
 
>> java -jar gplot-x.x.jar
 
The default mode (no command line arguments) is to use the Madona reader interface. You have the possibility change it after running it:
 
[[File:GPlotPanel5.jpg]]      [[File:GPlotPanel6.jpg]]
 
 
… or to use arguments as is:


* '''-h''' or '''--help''' for printing help on arguments
* '''-r''' or '''--reader''' then reader name ('''MADONA''' or '''SQLITE''')
* '''-p''' or '''--prefix''' then prefix of the files to read
* '''-d''' or '''--desc''' then description of the files to read


[[WELCOME_TO_THE_GENIUS_WIKI|Return to the introduction ↑]]  
[[WELCOME_TO_THE_GENIUS_WIKI|Return to the introduction ↑]]  
[[Internationalization|Go to the next page →]]
[[Internationalization|Go to the next page →]]

Dernière version du 7 décembre 2021 à 12:35

There is another higher level widget GPlotPanel allowing to plot data stored in a file with the "Madona" or SQLite formats given format as described here.

Using this widget is very simple as you have just to instantiate and then display it. To instantiate it, you must give at least (for the "Madona" files):

  • the prefix of the files you want to read
  • the suffix of the files you want to read
  • a comment giving a description of this kind of files
  • the maximum number of detached plot windows. If greater than 0 a "+" button wille be displayed in order to allow to display other plots in detached panels

Nevertheless, you have the possibility to specify which kind of files you will have to consider, adding an additionnal parameter:

In the following example, we will check for EPH_* files (no specific suffix).

    GPlotPanel plots = new GPlotPanel("EPH", "", "Ephemeris file", 0, true);
    
    ...

    public void display() throws GException {
        put(plots);
    }
}

This panel will then appear ...

GPlotPanel1.jpg


After selecting a file ...

GPlotPanel2.jpg


We may have something like that ...

GPlotPanel3.jpg

Additional files

Note that, since the V1.9 verison, it is now possible to plot additional files to make comparison between them. It is also possible to get relative values but this functionnality is now relatively limited as it is necessary to have exactly the same amount of lines between each files and no interpolation are made if abscissae are different.

GPlotPanel4.jpg

EVENT files

Since V1.10, it is now possible to plot "EVENT" files coming, for example, from the PSIMU software. These files look exactly the same as Madona files except the first column which includes characters describing the kind of event. Here is an example of such a file:

#<AM-acces:COL-V2.0>
<INIT:
Logiciel="JPSIMU"
VERSION="V11.4.1"
<COL:
  1 : EVENT ~ (Event code)
  2 : DATE ~cal (date)
  3 : TIME ~s (duration since initial conditions)
  4 : A ~km (semi-major axis)
  5 : E ~ (eccentricity)
  6 : I ~deg (inclination)
  7 : ALTG ~km (geodetic altitude)
  8 : LATG ~deg (geodetic latitude)
  9 : LON ~deg (longitude)
>
>
 Constant thrust maneuver Maneuver1 start: Relative date (0j00h10m00s)     2000-01-01T00:10:00.000        6.00000000000000e+02        7.00000006665629e+03        9.52233579255254e-09        5.15999981057783e+01        6.26650567709823e+02        2.83267318798703e+01       -7.73441356109702e+01
 Constant thrust maneuver Maneuver1 end: Date (2000-01-01T00:12:12.000)    2000-01-01T00:11:40.000        7.00000000000000e+02        7.07569671802727e+03        1.06930031433105e-02        5.15999981057783e+01        6.28194776514761e+02        3.26360096408306e+01       -7.25917790877161e+01

Calculator

Since V1.11.2 version, there is the possibility to create new variables using initial ones from a MADONA column file via specific equations. This functionnality is not yet available for SQLite files.

Once the user have loaded a file, a specific button appears : GCalculator0.png.

If we push on that button a new window will appear where it will be possible to define specific equation(s) to get additional variables. In the example below, we have define the "VZ" variable for the vertical velocity, defined by [math]\displaystyle{ V_z = V_{rel}*sin(\gamma_{rel}) }[/math] with [math]\displaystyle{ V_{rel} = VREL }[/math] and [math]\displaystyle{ \gamma_{rel} = FPAR }[/math].

GCalculator1.png

We can see that we have access to :

  • The list of initial variables
  • Some specific functions
  • The possibility to load, save or clear an equation or a list of equations
  • For each equation, we will have to define :
    • the name of the new variable
    • its unit
    • a description of this variable
    • the gap for plot discontinuities

For each formula, we may reset the data or the formula and also validate it :

If the formula is valid this pop-up window will appear : GCalculator2.png

On the contrary (for example GCalculator3.png), this pop-up window will be displayed:

GCalculator4.png

At the end, we may :

  • Validate all the formulae
  • Create a file to store these formulae
  • Quit the calculator panel without or with using these formulae. In this last case, the new variable(s) will be added to the initial ones.

GCalculator5.png => GCalculator6.png

GPLOT utility

If users want to use GPlotPanel functions without coding, since V1.9 version, it is possible to use directly a compiled tool with its own GUI. It is provided with the full zip package and to use it, you have just to double clicked on the jar file or type the following command:

>> java -jar gplot-x.x.jar

The default mode (no command line arguments) is to use the Madona reader interface. You have the possibility change it after running it:

GPlotPanel5.jpg GPlotPanel6.jpg


… or to use arguments as is:

  • -h or --help for printing help on arguments
  • -r or --reader then reader name (MADONA or SQLITE)
  • -p or --prefix then prefix of the files to read
  • -d or --desc then description of the files to read

Return to the introduction ↑ Go to the next page →