VisibilityCone - Zudokakikuto/OreCZML GitHub Wiki
This page describes the content of a CZML document. Please read Get Started for an explanation of how a CZML document is put together.
Visibility Cone
Implements : CZMLPrimaryObject
Extends : AbstractPrimaryObject
Example :
{
"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].
availability - TimeInterval : Time interval where the visibility cone is displayed.
Intrinsic arguments
**
TopocentricFrame - TopocentricFrame : The Orekit TopocentricFrame Object
Cylinder - Cylinder : The cylinder object, that describes the geometric objects representing the visibility.
satellite - Satellite : The satellite that will be in the visibility cone.
groundStation - CzmlGroundStation : The ground station where the visibility cone will be attached to.
angle of aperture - Double : The angle of aperture of the station, default : 80.0°
Other parameters
position - Position : The position in a given frame of the visibility cone (usually on the ground station)
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)
new VisibilityCone visibilityCone = new VisibilityCone(id, name, cylinder, avalability);
- An id, a name, a cylinder, an availability, a satellite : (This constructor allows the visibility cone to reach only the given satellite, so the height is fixed to the altitude of the satellite)
new VisibilityCone visibilityCone = new VisibilityCone(id, name, cylinder, avalability, satellite);
new VisibilityCone visibilityCone = new VisibilityCone(groundStation);
- A CZMLGroundStation, a satellite :
new VisibilityCone visibilityCone = new VisibilityCone(groundStation, satellite);
- A CZMLGroundStation, satellite, an angle of aperture :
new VisibilityCone visibilityCone = new VisibilityCone(groundStation, satellite, angleOfAperture);
- A TopocentricFrame, a satellite :
new VisibilityCone visibilityCone = new VisibilityCone(topocentricFrame, satellite);
- A TopocentricFrame, a satellite, an angle of aperture :
new VisibilityCone visibilityCone = new VisibilityCone(topocentricFrame, satellite, angleOfAperture);
Functions
noDisplay() - void : Allows the user to not display the visibility cone