This page describes the content of a CZML document. Please read Get Started for an explanation of how a CZML document is put together.

Attitude Pointing

Implements : CzmlPrimaryObject

Extends : AbstractPrimaryObject

Example :

  {
    "id":"ATTITUDE_POINTING/Keplerian parameters: {a: 7878000.0; e: 0.0; i: 20.0; pa: 0.0; raan: 0.0; v: 0.0;}",
    "name":"Attitude pointing of : Satellite",
    "availability":"2024-03-15T00:00:00Z/2024-03-15T10:00:00Z",
    "polyline":{
      "width":2,
      "arcType":"NONE",
      "material":{
        "solidColor":{
          "color":{
            "rgba":[
              255,200,0,255
            ]
          }
        }
      },
      "positions":{
        "references":[
          "Keplerian parameters: {a: 7878000.0; e: 0.0; i: 20.0; pa: 0.0; raan: 0.0; v: 0.0;}#position",
          "ABSTRACT_POINT_ON_EARTH/[{lat: 0,135113849 deg, lon: -172,7804104416 deg, alt: 0}, {lat: 0,1531905851 deg, lon: -169,7357174136 deg, alt: 0}, {lat: 0,1589310159 deg, lon: -166,6892337239 deg, alt: 0}, {lat: 0,1408039121 deg, lon: -163,6394087316 deg, alt: 0}, {lat: 0,0880912893 deg, lon: -160,5851779384 deg, alt: 0}, {lat: -0,0084512103 deg, lon: -157,5262625212 deg, alt: 0}, {lat: -0,1556023493 deg, lon: -154,4635281532 deg, alt: 0}, {lat: -0,3561974185 deg, lon: -151,3994335644 deg, alt: 0}, {lat: -0,6069648039 deg, lon: -148,3385949165 deg, alt: 0}, {lat: -0,8955917366 deg, lon: -145,2883800523 deg, alt: 0}]#position"
        ]
      }
    }
  }

Properties

id - String : Identification of the attitude pointing - default : "ATTITUDE_POINTING/{Id of the satellite}"

name - String : Name of the attitude pointing, default : "Attitude pointing of : {name of the satellite}".

availability - TimeInterval : Time interval when the attitude pointing is displayed, default : the time interval of the clock of the header

Intrinsinc arguments

These arguments can be used to build a attiude pointing object :

satellite - Satellite : The satellite referencing the attitude.

body - OneAxisEllipsoid : The body the satellite is orbiting around.

direction - Vector3D : The direction of the pointing, usually you can use : Vector3D.PLUS_I, Vector3D.MINUS_I, Vector3D.PLUS_J, Vector3D.MINUS_J, Vector3D.PLUS_K, Vector3D.MINUS_K.

color - Color : The color of the Polyline that will link the satellite and the ground.

Other parameters

satelliteOrientation - Orientation : The orientation object that allows to display the attitude in the czml file.

attitudePointingPolyline - Polyline : The polyline that will be dismlayed to link the ground and the satellite.

lines - List of Line : A list of line objects that allows to build the direction of the pointing.

*projectedAttitudes - List of GeodeticPoint : A list of GeodeticPoint object, they represents the projection of the point targeted by the attitude on the surface of the body.

julianDates - List of JulianDate : The list of all the JulianDate objects, they represents the julian dates of all instants computed for the attitude pointing.

pointOnBody - AbstractPointOnBody : This represents the Czml object that will create the point at the surface of the body to use it as a reference for the polyline.

satelliteAttitudes - List of Attitude : This list contains all the attitudes object of the satellite computed during the propagation.

satelliteCartesians - List of Cartesian : The list of the cartesian coordinates of the satellite in the ITR frame.

Build

The attitude pointing object can be build with :

• A satellite, a body, a direction :

AttitudePointing pointing = new AttitudePointing(satellite, body, direction);

• A satellite, a body, a direction, an availability :

AttitudePointing pointing = new AttitudePointing(satellite, body, direction, availability);

• A satellite, a body, a direction, a Color :

AttitudePointing pointing = new AttitudePointing(satellite, body, direction, color);

• A satellite, a body, a direction, an availability, a Color :

AttitudePointing pointing = new AttitudePointing(satellite, body, direction, availability, color);

Functions

• displayPointingPath() - void : This function allows to display the path of the point in the surface of the body.
• displayPeriodPointingPath - void : The function must be used always after displayPointingPath(), it allows to displays the path for a duration of one period of the orbit to not overload the scene.