This page describes the content of a CZMLSecondaryObject document. Please read CZMLSecondaryObject for the intern architecture of CZMLPrimaryObjects.

Czml Ellipsoid

The czml ellipsoid aims at representing an ellipsoid for different type of usages.

Implements : CZMLSecondaryObject

Example :

"ellipsoid":{
      "fill":false,
      "outline":true,
      "outlineColor":{
        "rgba":[
          0,255,0,255
        ]
      },
      "slicePartitions":24,
      "stackPartitions":36,
      "interval":"2024-03-15T00:00:00Z/2024-03-15T05:00:00Z",
      "radii":{
        "epoch":"2024-03-15T00:00:00Z",
        "cartesian":[
          0,999.9999999999995,100.00000000000001,99.99999999999994,
          60,1000.3557088442701,101.24416119580226,100.06558092587828,
          120,1001.4188533345995,105.00577034773143,100.26155105418857,
          180,1003.1789072897213,111.37161616179563,100.58560099177218,
          240,1005.6231038323383,120.48430803609354,101.03391142817493,
          300,1008.7436529447372,132.53872099231185,101.60118284669117
        ]
      }
    }

Properties

These arguments can be used to build a czml ellipsoid object :

availability - TimeInterval : The availability of the ellipsoid

cartesian - Cartesian : The cartesian that represents the radius of the ellipsoid in the ITR frame.

color - Color : The color of the ellipsoid, default : yellow

slicePartition - int : The number of slice of the ellipsoid (number of lines in the orthogonal direction), default : 24

stackPartition - int : The number of stack of the ellipsoid (number of line in the vertical direction), default : 36

fill - boolean : Whether or not to fill the ellipsoid, default : false

outline - boolean : Whether or not to display the outline of the ellipsoid, default : true

julianDates - List of JulianDate : A list of all the julian dates when the ellipsoid must be computed.

dimensions - List of Cartesian : These cartesians represents the dimensions of the ellipsoid (x,y,z), each value is the distance from the center for each dimension

Build

The czml ellipsoid object can be build with :

(The following constructors are made to build several ellipsoids in order to follow the object in time, it is not optimal, it is advised to use these constructor only to build a single ellipsoid).

• An availability, a cartesian :

CzmlEllipsoid ellipsoid = new CzmlEllipsoid(availability, cartesian);

• An availability, a cartesian, a color :

CzmlEllipsoid ellipsoid = new CzmlEllipsoid(availability, cartesian, color);

• An availability, a cartesian, a slicePartition, a stackPartition :

CzmlEllipsoid ellipsoid = new CzmlEllipsoid(availability, cartesian, slicePartition, stackPartition);

• An availability, a cartesian, a slicePartition, a stackPartition, a color :

CzmlEllipsoid ellipsoid = new CzmlEllipsoid(availability, cartesian, slicePartition, stackPartition, color);

• An availability, a cartesian, a fill, an outline, a slicePartition, a stackPartition, a color :

CzmlEllipsoid ellipsoid = new CzmlEllipsoid(availability, cartesian, fill, outline, slicePartition, stackPartition, color);

(The following constructors are made to create an ellipsoid to follow an object in time)

• A List of julianDates, a List of dimensions :

CzmlEllipsoid ellipsoid = new CzmlEllipsoid(julianDates, dimensions);

• A List of julianDates, a List of dimensions, a color :

CzmlEllipsoid ellipsoid = new CzmlEllipsoid(julianDates, dimensions, color);

• A List of julianDates, a List of dimensions, a slicePartition, a stackPartition :

CzmlEllipsoid ellipsoid = new CzmlEllipsoid(julianDates, dimensions, slicePartition, stackPartition);

• A List of julianDates, a List of dimensions, a slicePartition, a stackPartition, a color :

CzmlEllipsoid ellipsoid = new CzmlEllipsoid(julianDates, dimensions, slicePartition, stackPartition, color);

• A List of julianDates, a List of dimensions, a fill, an outline, a slicePartition, a stackPartition, a color :

CzmlEllipsoid ellipsoid = new CzmlEllipsoid(julianDates, dimensions, fill, outline, slicePartition, stackPartition, color);