Skip to content

Changes

Page history
Mise à jour de AttitudePointing authored by Julien LEBLOND's avatar Julien LEBLOND
Show whitespace changes
Inline Side-by-side
AttitudePointing.md 0 → 100644
View page @ cc4247ac
---
title: AttitudePointing
---
This page describes the content of a CZML document. Please read [Get Started](Get-Started) for an explanation of how a CZML document is put together.
# Attitude Pointing
**Implements** : [CzmlPrimaryObject](CZMLPrimaryObjects) **Extends** : [AbstractPrimaryObject](AbstractPrimaryObject)
**Example** :
```json
{
"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](https://cesium.com/learn/cesiumjs/ref-doc/TimeInterval.html) : Time interval when the attitude pointing is displayed.
## Intrinsinc arguments
These arguments can be used to build a attiude pointing object :
**satellite** - [Satellite](Satellite) : The satellite referencing the attitude.
**body** - [OneAxisEllipsoid](https://www.orekit.org/site-orekit-development/apidocs/org/orekit/bodies/OneAxisEllipsoid.html) : The body the satellite is orbiting around.
**direction** - [Vector3D](https://www.hipparchus.org/apidocs/org/hipparchus/geometry/euclidean/threed/Vector3D.html) : 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](https://docs.oracle.com/javase/8/docs/api/java/awt/Color.html) : The color of the [Polyline](Polyline) that will link the satellite and the ground.
## Other parameters
**satelliteOrientation** - [Orientation](Orientation) : The orientation object that allows to display the attitude in the czml file.
**attitudePointingPolyline** - [Polyline](Polyline) : The polyline that will be dismlayed to link the ground and the satellite.
**lines** - [List of Line](https://www.hipparchus.org/apidocs/org/hipparchus/geometry/euclidean/threed/Line.html) : A list of line objects that allows to build the direction of the pointing.
\*_projectedAttitudes_ - [List of GeodeticPoint](https://www.orekit.org/site-orekit-development/apidocs/org/orekit/bodies/GeodeticPoint.html) : 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](https://cesium.com/learn/cesiumjs/ref-doc/JulianDate.html) : The list of all the JulianDate objects, they represents the julian dates of all instants computed for the attitude pointing.
**pointOnBody** - \[AbstractPointOnBody\](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](https://www.orekit.org/site-orekit-development/apidocs/org/orekit/attitudes/Attitude.html) : This list contains all the attitudes object of the satellite computed during the propagation.
**satelliteCartesians** - [List of Cartesian](https://github.com/AnalyticalGraphicsInc/czml-writer/wiki/Cartesian3Value) : The list of the cartesian coordinates of the satellite in the ITR frame.
# Build
The attitude pointing object can be build with :
A [satellite](Satellite), a [body](https://www.orekit.org/site-orekit-development/apidocs/org/orekit/bodies/OneAxisEllipsoid.html), a [direction](https://www.hipparchus.org/apidocs/org/hipparchus/geometry/euclidean/threed/Vector3D.html) :
```Java
AttitudePointing pointing = new AttitudePointing(satellite, body, direction);
```
A [satellite](Satellite), a [body](https://www.orekit.org/site-orekit-development/apidocs/org/orekit/bodies/OneAxisEllipsoid.html), a [direction](https://www.hipparchus.org/apidocs/org/hipparchus/geometry/euclidean/threed/Vector3D.html), an [availability](https://cesium.com/learn/cesiumjs/ref-doc/TimeInterval.html) :
```Java
AttitudePointing pointing = new AttitudePointing(satellite, body, direction, availability);
```
A [satellite](Satellite), a [body](https://www.orekit.org/site-orekit-development/apidocs/org/orekit/bodies/OneAxisEllipsoid.html), a [direction](https://www.hipparchus.org/apidocs/org/hipparchus/geometry/euclidean/threed/Vector3D.html), a [Color](https://docs.oracle.com/javase/8/docs/api/java/awt/Color.html) :
```Java
AttitudePointing pointing = new AttitudePointing(satellite, body, direction, color);
```
A [satellite](Satellite), a [body](https://www.orekit.org/site-orekit-development/apidocs/org/orekit/bodies/OneAxisEllipsoid.html), a [direction](https://www.hipparchus.org/apidocs/org/hipparchus/geometry/euclidean/threed/Vector3D.html), an [availability](https://cesium.com/learn/cesiumjs/ref-doc/TimeInterval.html), a [Color](https://docs.oracle.com/javase/8/docs/api/java/awt/Color.html) :
```Java
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 orbitn to not overload the scene.
\ No newline at end of file