Création de VisibilityCone authored by Julien LEBLOND's avatar Julien LEBLOND
This page describes the content of a CZML document. Please read [How to get started]() for an explanation of how a CZML document is put together.
**Extends** : [CZMLPrimaryObject](CZMLPrimaryObject)
**Example** :
```json
{
"id":"VIS/Toulouse Frame/Keplerian parameters: {a: 6928000.0; e: 0.0; i: 60.00000000000001; pa: 0.0; raan: 90.0; v: 90.0;}",
"name":"Visibility of Toulouse Frame looking at Keplerian parameters: {a: 6928000.0; e: 0.0; i: 60.00000000000001; pa: 0.0; raan: 90.0; v: 90.0;}",
"availability":"2022-01-17T12:00:00Z/2022-01-17T13:00:00Z",
"cylinder":{
"bottomRadius":10,
"topRadius":31188660.731582925,
"length":3464000,
"material":{
"solidColor":{
"color":{
"rgba":[
0,0,0,0
]
}
}
},
"heightReference":"CLAMP_TO_GROUND"
},
"position":{
"interval":"2022-01-17T12:00:00Z/2022-01-17T13:00:00Z",
"cartesian":[
4624415.12018318,116587.90809901741,4376399.285187051
]
}
},
```
# Parameters
**id** - String : Identification of the visibility cone, *default* : "VIS/[Name of the station]/[Name of the satellite].
**name** - String : Name of the visibility cone, *default* : "Frame of the station [name of the station] looking at [name of the satellite].
**Cylinder** - [Cylinder](Cylinder) : The cylinder object, that describes the geometric objects representing the visibility.
**availability** - [TimeInterval](https://cesium.com/learn/cesiumjs/ref-doc/TimeInterval.html) : Time interval where the visibility cone is displayed.
**position** - [Position](Position) : The position in a given frame of the visibility cone (usually on the ground station)
**angle of aperture** - Double : The angle of aperture of the station, *default* : 80.0°
##Intrinsic arguments
**TopocentricFrame** - [TopocentricFrame](https://www.orekit.org/site-orekit-development/apidocs/org/orekit/frames/TopocentricFrame.html) : The Orekit TopocentricFrame Object
# Build
These arguments can be used to build a visibility cone object :
* An id, a name, a cylinder, an availability : (**this visibility cone will have a fix height of a terrestrial radius**)
```Java
new VisibilityCone visibilityCone = new VisibilityCone(id, name, cylinder, avalability);
```
* An id, a name, a cylinder, an availability, a [Satellite](Satellite) : (**This constructor allows the visibility cone to reach only the given satellite, so the height is fixed to the altitude of the satellite**)
```Java
new VisibilityCone visibilityCone = new VisibilityCone(id, name, cylinder, avalabilityn satellite);
```
* A [CZMLGroundStation](CZMLGroundStation), a [Header](Header) :
```Java
new VisibilityCone visibilityCone = new VisibilityCone(groundStation, header);
```
* A [CZMLGroundStation](CZMLGroundStation), a [Header](Header), a [Satellite](Satellite) :
```Java
new VisibilityCone visibilityCone = new VisibilityCone(groundStation, satellite, header);
```
* A [CZMLGroundStation](CZMLGroundStation), a [Header](Header) , an angle of aperture :
```Java
new VisibilityCone visibilityCone = new VisibilityCone(groundStation, header, angleOfAperture);
```
* A [TopocentricFrame](https://www.orekit.org/site-orekit-development/apidocs/org/orekit/frames/TopocentricFrame.html), a [Satellite](Satellite), a [Header](Header) :
```Java
new VisibilityCone visibilityCone = new VisibilityCone(topocentricFrame, satellite, header);
```
* A [TopocentricFrame](https://www.orekit.org/site-orekit-development/apidocs/org/orekit/frames/TopocentricFrame.html), a [Satellite](Satellite), a [Header](Header), an angle of aperture :
```Java
new VisibilityCone visibilityCone = new VisibilityCone(topocentricFrame, satellite, header, angleOfAperture);
```
\ No newline at end of file