Class: Location botec.py

A location represents an orbital position around a primary object at a given distance.

Base Classes
ReprMixin
object
Methods
__init__
__init__ (
self,
primary,
distance,
)

__str__
__str__ ( self )

altitude
altitude ( self )

The altitude is the height above the surface. [m]

closingSpeeds
closingSpeeds ( self )

Return a 2-tuple providing the range of possible impactor closing speeds given that the impactor is travelling at escape speed when it hits. [m/s, m/s]

distance
distance ( self )

distanceFrom
distanceFrom ( self,  other )

Compute the (average) distance between two bodies, either both of which have the same parent or one is a parent of the other. [m]

effectiveDeltaveeDifference
effectiveDeltaveeDifference ( self,  other )

The effective (ideal) deltavee between the two locations around the same primary based purely on energy arguments. [m/s]

escapeSpeedExcess
escapeSpeedExcess ( self )

The difference between the escape speed and the orbital speed. [m/s]

escapeSpeedFromPrimary
escapeSpeedFromPrimary ( self )

The speed required to escape the primary. [m/s]

findCommonAncestor
findCommonAncestor ( self,  other )

Find the lowest world in the hierarchy that is an ancestor to both objects.

hierarchy
hierarchy ( self )

A list of the objects that are enumerated as one moves up the hierarchy, starting with this object.

instability
instability ( self )

The inherent instability of this orbital location, measured as the e-folding time of the positional error. None indicates no instability (an infinite e-folding time). [s, or None]

isAncestorOf
isAncestorOf ( self,  other )

Is this object an ancestor (parent, grandparent, etc.) of the other object?

isDescendentOf
isDescendentOf ( self,  other )

Is this object an descendent (child, grandchild, etc.) of the other object?

massicAngularMomentum
massicAngularMomentum ( self )

Orbital angular momentum per unit mass. [m^2/s]

massicKineticEnergy
massicKineticEnergy ( self )

Orbital kinetic energy per unit mass. [J/kg]

massicPotentialEnergy
massicPotentialEnergy ( self )

Orbital potential energy per unit mass. [J/kg]

massicTotalEnergy
massicTotalEnergy ( self )

Orbital total energy per unit mass. [J/kg]

nominalSpeed
nominalSpeed ( self )

This is the nominal speed of the object at this location. For orbits it is orbital speed; for non-orbits it is the instantaneous speed. [m/s]

opportunitiesPeriodWith
opportunitiesPeriodWith ( self,  other )

The period at which opportunities recur between the two bodies. [s]

opportunityAngleWith
opportunityAngleWith ( self,  other )

The opportunity angle that this body makes with the other. [rad]

orbitalAngularSpeedAroundPrimary
orbitalAngularSpeedAroundPrimary ( self )

The orbital angular speed around the primary. [rad/s]

orbitalCircumference
orbitalCircumference ( self )

The circumference of a circular orbit at this distance. [m]

orbitalPeriodAroundPrimary
orbitalPeriodAroundPrimary ( self )

The orbital period around the primary. [s]

orbitalSpeedAroundPrimary
orbitalSpeedAroundPrimary ( self )

The orbital speed around the primary. [m/s]

phaseAngle
phaseAngle ( self )

The base phase angle. [rad]

pressureAt
pressureAt ( self )

The pressure from the primary at this altitude. [Pa]

primaries
primaries ( self,  seq=None )

Return a list of primaries, from most distant to least distant.

primary
primary ( self )

relativeOrbitalAngularSpeedWith
relativeOrbitalAngularSpeedWith ( self,  other )

The relative orbital angular speed of the two objects [rad/s].

roundTripTimeWith
roundTripTimeWith ( self,  other )

The round trip time for a departure from self, arrival at other, wait for opportunity to return, and transfer from other back to self. [s]

roundTripWaitTimeWith
roundTripWaitTimeWith ( self,  other )

For a round trip of Hohmann transfers from self to other, a wait for opportunity, and a return from other to self, the time required to wait for the return opportunity. [s]

stationKeeping
stationKeeping ( self )

The amount of station keeping that must be exerted to keep a body from drifting here, measured as an acceleration. [m/s^2]