PointGroup.Coverage(Formation, Array) Method



This method provides sensor coverage analysis for the set of points defined by a PointGroup. This can be used to determine what parts of the central body can be seen by a given sensor at some point in time, using the current epoch of the specified Spacecraft. The coverage analysis can be extended over a period of time by calling this method inside a propagation loop. When specifying Spacecraft arguments, up to 50 Spacecraft can be included in the analysis. The active Sensors on each Spacecraft will be used to determine coverage.


Array output arguments are used to capture the statistics of the coverage analysis. Do not use these arrays as output arguments for more than one method. Note that the dimensions of the argument arrays are set when the Coverage method is first called; the dimension is not reset by subsequent calls. The Coverage method returns a flag indicating whether the coverage has changed since the last method call. This can be used to increase performance by indicating that further analysis is not necessary if the coverage statistics have not changed.


Timing Precision Mode

This page describes functionality in nanosecond timing precision mode.


Note: This method has a state. See the Methods and Properties with State page for more information.


Method Signature


Formation formation,

Array coverageArray)





Formation containing Spacecraft whose Sensors will be used for the coverage analysis.




This array holds the coverage for the entire set of Sensors. A zero indicates the point has never been in view of any Sensor of the set. A one indicates the point has been in view of at least one Sensor of the set.



Return Value




Returns a 1 if the coverage has changed since the last method call, and a 0 if coverage has not changed.



myVariable1 = myPointGroup1.Coverage(myFormation1, myArray1);


See also

PointGroup Object


Coverage and Contact Analysis Guide

PointGroups Guide