Changes

Page history
Mise à jour de CZMLGroundStation authored by Julien LEBLOND's avatar Julien LEBLOND
Hide whitespace changes
Inline Side-by-side
CZMLGroundStation.md
View page @ a8d713d8
......@@ -63,9 +63,9 @@ These arguments can be used to build a CZML ground station object :
**topocentricFrames** - [List of TopocentricFrame](https://www.orekit.org/site-orekit-development/apidocs/org/orekit/frames/TopocentricFrame.html) : The list all of the topocentric frame when several ground stations are inputted.
**billboard** - [Billboard](Billboard) : A 2D object that allows to display a given image to represents the ground station. _default_ : A 2D image representing a ground station will be used.
**modelPath** - String : The path to the model used for the ground station.
**position** - [Position](Position) : The position in a given frame of the ground station
**modelPathsInput** - List of String : The paths used to load several models when several stations are computed.
## Other parameters
......@@ -79,32 +79,35 @@ These arguments can be used to build a CZML ground station object :
**multiplePositionOnEarth** - [List of Vector3D](https://www.hipparchus.org/apidocs/org/hipparchus/geometry/euclidean/threed/Vector3D.html) : All the cartesian positio of the points on the surface of the earth when several ground stations are inputted.
**groundStation** - [GroundStation](https://www.orekit.org/site-orekit-development/apidocs/org/orekit/estimation/measurements/GroundStation.html) : The Orekit GroundStation object built from the czml ground station.
**billboard** - [Billboard](Billboard) : The billboard is used when no 3D models are used and a 2D image is necessary to display the station.
**multipleGroundStations** - [List of GroundStation](https://www.orekit.org/site-orekit-development/apidocs/org/orekit/estimation/measurements/GroundStation.html) : All the orekit GroundStation objects built when several ground stations are inputted.
**multipleBillboards** - [List of Billboard](Billboard) : The list of billboard that is used to display 2D images when no 3D models are used with several stations.
**positionObject** - [Position](Position) : The position of the object to be written in the czml file.
**model** - [CzmlModel](CzmlModel) - The model loaded for the station (can be a 2D or 3D model).
**multiplePositionObject** - [List of Position](Position) : All the position of the objects to be written when several ground stations are inputted.
**multipleModel** - [List of CzmlModel](CzmlModel) - The list of models when several stations are computed with different models.
# Build
**positionObject** - [Position](Position) : The position of the object to be written in the czml file.
The CZML ground stration object can be build with :
**multiplePositionObject** - [List of Position](Position) : All the position of the objects to be written when several ground stations are inputted.
* A name, an id, an [availability](https://cesium.com/learn/cesiumjs/ref-doc/TimeInterval.html), a [position](Position), a [billboard](Billboard) :
**modelPaths** - List of String : The list of all the paths used for the models.
```Java
CZMLGroundStation groundStation = new CZMLGroundStation(name, id, availability, position, billboard);
```
# Build
* An [TopocentricFrame](https://www.orekit.org/site-orekit-development/apidocs/org/orekit/frames/TopocentricFrame.html) :
The ground station object can be build with only a topocentric frame or a list of topocentric frames.
In order to build the ground station you should use the [ground station builder](CzmlGrounStationBuilder). Be cause there are 2 ways of building a ground station (one station or several station), there are 2 builders :
```Java
CZMLGroundStation groundStation = new CZMLGroundStation(topocentricFrame);
```java
// Single station builder
final CzmlGroundStation singleStation = CzmlGroundStation.builder(topocentricFrame).build();
// Multiple stations builder
final CzmlGroundStation multipleStations = CzmlGroundStation.builder(listOfTopocentricFrames).build();
```
* A [List of TopocentricFrame](https://www.orekit.org/site-orekit-development/apidocs/org/orekit/frames/TopocentricFrame.html) : (**This function can create several groundStation, with each topocentricFrame assigned to each station**)
This way you can add a model to a single ground station like this : (model to several stations can be add too)
```Java
CZMLGroundStation groundStation = new CZMLGroundStation(topocentricFrameList);
```java
// Single station builder
final CzmlGroundStation singleStation = CzmlGroundStation.builder(topocentricFrame).withModel(modelPath).build();
```
\ No newline at end of file