CoordinateTransform#
- class astropy.coordinates.CoordinateTransform(fromsys, tosys, priority=1, register_graph=None)[source]#
Bases:
objectAn object that transforms a coordinate from one system to another. Subclasses must implement
__call__with the provided signature. They should also call this superclass’s__init__in their__init__.- Parameters:
- fromsys
BaseCoordinateFramesubclass The coordinate frame class to start from.
- tosys
BaseCoordinateFramesubclass The coordinate frame class to transform into.
- priority
floatorint The priority if this transform when finding the shortest coordinate transform path - large numbers are lower priorities.
- register_graph
TransformGraphorNone A graph to register this transformation with on creation, or
Noneto leave it unregistered.
- fromsys
Methods Summary
__call__(fromcoord, toframe)Does the actual coordinate transformation from the
fromsysclass to thetosysclass.register(graph)Add this transformation to the requested Transformation graph, replacing anything already connecting these two coordinates.
unregister(graph)Remove this transformation from the requested transformation graph.
Methods Documentation
- abstract __call__(fromcoord, toframe)[source]#
Does the actual coordinate transformation from the
fromsysclass to thetosysclass.- Parameters:
- fromcoord
BaseCoordinateFramesubclass instance An object of class matching
fromsysthat is to be transformed.- toframe
object An object that has the attributes necessary to fully specify the frame. That is, it must have attributes with names that match the keys of the dictionary
tosys.frame_attributes. Typically this is of classtosys, but it might be some other class as long as it has the appropriate attributes.
- fromcoord
- Returns:
- tocoord
BaseCoordinateFramesubclass instance The new coordinate after the transform has been applied.
- tocoord
- register(graph)[source]#
Add this transformation to the requested Transformation graph, replacing anything already connecting these two coordinates.
- Parameters:
- graph
TransformGraphobject The graph to register this transformation with.
- graph
- unregister(graph)[source]#
Remove this transformation from the requested transformation graph.
- Parameters:
- graph
aTransformGraphobject The graph to unregister this transformation from.
- graph
- Raises:
ValueErrorIf this is not currently in the transform graph.