« Events » : différence entre les versions

De GENOPUS
Aller à la navigation Aller à la recherche
Aucun résumé des modifications
 
(7 versions intermédiaires par le même utilisateur non affichées)
Ligne 6 : Ligne 6 :
* [{{PathCurrentJavaDoc}}/fr/cnes/genopus/events/GPAltitudeDetector.html GPAltitudeDetector],
* [{{PathCurrentJavaDoc}}/fr/cnes/genopus/events/GPAltitudeDetector.html GPAltitudeDetector],
* [{{PathCurrentJavaDoc}}/fr/cnes/genopus/events/GPDateDetector.html GPDateDetector],
* [{{PathCurrentJavaDoc}}/fr/cnes/genopus/events/GPDateDetector.html GPDateDetector],
* [{{PathCurrentJavaDoc}}/fr/cnes/genopus/events/GPRecurrentDateDetector.html GPRecurrentDateDetector] (since V2.1),
* [{{PathCurrentJavaDoc}}/fr/cnes/genopus/events/GPRelativeDateDetector.html GPRelativeDateDetector],
* [{{PathCurrentJavaDoc}}/fr/cnes/genopus/events/GPRelativeDateDetector.html GPRelativeDateDetector],
* [{{PathCurrentJavaDoc}}/fr/cnes/genopus/events/GPRecurrentRelativeDateDetector.html GPRelativeRecurrentDateDetector] (since V2.1),
And the following events are specific as they have the possibility to define an occurrence for triggering them.
And the following events are specific as they have the possibility to define an occurrence for triggering them.
* [{{PathCurrentJavaDoc}}/fr/cnes/genopus/events/GPAOLDetector.html GPAOLDetector],
* [{{PathCurrentJavaDoc}}/fr/cnes/genopus/events/GPAOLDetector.html GPAOLDetector],
Ligne 50 : Ligne 52 :
The display just below corresponds to [{{PathCurrentJavaDoc}}/fr/cnes/genopus/events/GPDateDetector.html GPDateDetector]:
The display just below corresponds to [{{PathCurrentJavaDoc}}/fr/cnes/genopus/events/GPDateDetector.html GPDateDetector]:


[[File:GPAltitudeDetector.png]]
[[File:GPDateDetector.png]]
   
   
We see that the display is composed of a [[GPAbsoluteDate|GPAbsoluteDate]] widget followed by fields corresponding to the event definition with the type of action (see [[https://logiciels.cnes.fr/en/node/62?type=desc PATRIUS]] documentation for more information):
We see that the display is composed of a [[GPAbsoluteDate|GPAbsoluteDate]] widget followed by fields corresponding to the event definition with the type of action (see [[https://logiciels.cnes.fr/en/node/62?type=desc PATRIUS]] documentation for more information):
Ligne 60 : Ligne 62 :
[[File:EventExpertSettings.png]]
[[File:EventExpertSettings.png]]
   
   
On the following example (<font color=#4169E1>GPAOLDetector</font>), we see another event detector but with a trigger information (i.e. the occurrence of the event):
On the following example ([{{PathCurrentJavaDoc}}/fr/cnes/genopus/events/GPAOLDetector.html GPAOLDetector]), we see another event detector but with a trigger information (i.e. the occurrence of the event):


[[File:GPAOLDetector.png]]
[[File:GPAOLDetector.png]]


At last, here is the display when using <font color=#4169E1>GPEventSelector</font> widget:
At last, here is the display when using [{{PathCurrentJavaDoc}}/fr/cnes/genopus/events/GPEventSelector.html GPEventSelector] widget, customised with only '''Apsides''' and '''Node''' events and showing the trigger information in a different way as above:


[[File:GPEventSelector.png]]
[[File:GPEventSelector.png]]
Ligne 92 : Ligne 94 :
       <String name="scale">UTC</String>
       <String name="scale">UTC</String>
     </AbsoluteDate>
     </AbsoluteDate>
     <String name="actionData">STOP</String>
     <String name="actionData">RESET_STATE</String>
     <Real name="maxCheck" unit="s">1.0E10</Real>
     <Real name="maxCheck" unit="s">1.0E10</Real>
     <Real name="threshold" unit="s">1.0E-9</Real>
     <Real name="threshold" unit="s">1.0E-9</Real>
   </DateDetector>
   </DateDetector>
</syntaxhighlight>
</syntaxhighlight>

Dernière version du 8 novembre 2019 à 10:10

Some widgets are corresponding to the most used orbital events as defined with [PATRIUS]. The following list Is not exhaustive but will present the use of a part of them. Moreover such events are also internally used in attitude or maneuver sequences.

How to call it

Some basic event widgets are:

And the following events are specific as they have the possibility to define an occurrence for triggering them.

It is very simple to call them:

  • Using a constructor with a single label:
date = new GPDateDetector("Absolute date event");
  • … or with an initial event for initialization (and it that case, wa have also specified the kind of actions raised by this event with RESET actions):
final AbsoluteDate date0 = new AbsoluteDate(2010, 1, 1, TimeScalesFactory.getUTC());
final CustomDateDetector dateDetector = new CustomDateDetector(date0);
date = new GPDateDetector("Absolute date eve nt", dateDetector, Action.RESET_STATE, Action.RESET_DERIVATIVES);

Note: we do not use directly [PATRIUS] detectors but GENOPUS ones as some getter methods, necessary for the widgets, do not exist.

There is also the possibility to freeze the action associated for such events (for example, if the event is associated to a maneuver, it must be set to STOP and there must have no possibility to change the action. In that case, we have just to give a single action in the constructor then, this action will not be displayed. With the previous date event, it will be:

date = new GPDateDetector("Absolute date eve nt", dateDetector, Action.STOP);

At last, it exists a global GPEventSelector widget proposing a menu to select an event through a predefined list. In the example below, we will propose only an apside and a node event …

eventSelector =
  new GPEventSelector("Events:", GPEventsEnum.APSIDE, GPEventsEnum.NODE);

Display

The display just below corresponds to GPDateDetector:

GPDateDetector.png

We see that the display is composed of a GPAbsoluteDate widget followed by fields corresponding to the event definition with the type of action (see [PATRIUS] documentation for more information):

EventAction.png

… and eventually expert settings including the checking interval and the convergence threshold (see [PATRIUS] documentation for more information):

EventExpertSettings.png

On the following example (GPAOLDetector), we see another event detector but with a trigger information (i.e. the occurrence of the event):

GPAOLDetector.png

At last, here is the display when using GPEventSelector widget, customised with only Apsides and Node events and showing the trigger information in a different way as above:

GPEventSelector.png

How to use it

To get the corresponding GENOPUS objects, we will just have to call for the getPatriusObject() method as below:

CustomDateDetector dateDetector = date.getPatriusObject();

… or, when using GPEventSelector:

CustomDateDetector dateDetector = eventSelector.getPatriusObject()

How it is stored

Here is an example of XML format for <font GPDateDetector:

  <DateDetector name="Absolute_date_event">
    <AbsoluteDate name="eventDate">
      <String name="date">01/01/2010 00h00m00s</String>
      <String name="scale">UTC</String>
    </AbsoluteDate>
    <String name="actionData">RESET_STATE</String>
    <Real name="maxCheck" unit="s">1.0E10</Real>
    <Real name="threshold" unit="s">1.0E-9</Real>
  </DateDetector>