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);

• A CZMLGroundStation :

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