autowisp.astrometry package

Class Inheritance Diagram

Inheritance diagram of AnmatchTransformation, Transformation

Module implementing the low-level astrometry.

class autowisp.astrometry.AnmatchTransformation(trans_file=None)[source]

Bases: object

Inheritance diagram of autowisp.astrometry.AnmatchTransformation

A clas that applies transformations generated by anmatch.

__call__(sources, save_intermediate=False)[source]

Return the x and y coordinates to which the given (ra, dec) project to.

Parameters:
  • sources – The sky position to project to frame coordinates. Should have keys named ‘RA’ and ‘Dec’ in degrees.

  • save_intermediate – Should the intermediate coordinates be saved. Those are the coordinates after apllying the sky projection and before applying the polynomial transformation.

Returns:

The position in pixels relative to the lower left frame of the corner to which the given sky position projects under the currently defined transformation, as a numpy array with fields named ‘x’ and ‘y’. If save_intermediate is True, the result also contains fields called ‘xi’ and ‘eta’ containing the intermediate coordinates.

Return type:

numpy.array(dtype=[(‘x’, float), (‘y’, float)])

__init__(trans_file=None)[source]

Parse the transformation to apply from the given file.

Parameters:

trans_file – The transformation file contaning the transformation to apply. If this is the name of an existing file, it is opened and parsed, otherwise this should be a sequence of the lines contained in the transfomation file.

Returns:

None

evaluate_polynomial(projected, transformed)[source]

Apply the currently defined polynomial transfomation to (xi, eta).

Parameters:
  • projected – The projected (c.f. gnomonic_projection()) coordinates to transform. Should have ‘xi’ and ‘eta’ keys containing the projected coordinates to transform in degrees.

  • transformed – A numpy array with ‘x’ and ‘y’ fields to fill with the transformed coordinates (in pixels).

Returns:

None

read_anmatch_transformation(trans_lines)[source]

Parse the transformation to apply from the given file.

Parameters:

trans_lines – A sequence of the individual lines of the trans file defining the transformation to apply.

Returns:

None

class autowisp.astrometry.Transformation(dr_fname=None, **dr_path_substitutions)[source]

Bases: object

Inheritance diagram of autowisp.astrometry.Transformation

A class that applies transformation stored in DR files.

pre_projection

One of the map projections in autowisp.astrometry.map_projections that is applied first to transform RA, Dec -> xi, eta. The latter are then projected to x, y.

Type:

callable

evaluate_transformation

Evaluator for the pre-projected catalog -> frame coordinates transformation.

Type:

fit_expression.Interface

__call__(sources, save_intermediate=False, in_place=False)[source]

Return the projected positions of the given catalogue sources.

Parameters:
  • sources (structured numpy array or pandas.DataFrame) – The catalogue sources to project.

  • save_intermediate (bool) – If True, the result includes the coordinate of the pre-projection, in addition to the final frame coordinates.

  • in_place (bool) – If True, the input sources are updated with the projected coordinates (sources must allow setting entries for x and y columns, also for xi and eta if save_intermediate is True).

Returns:

The projected source positions with labels ‘x’, ‘y’, and optionally (if save_intermediate == True) the pre-projected coordinates xi and eta. If in_place is True, return None.

Return type:

numpy structured array

__init__(dr_fname=None, **dr_path_substitutions)[source]

Prepare to apply the transformation stored in the given DR file.

Parameters:

dr_fname (str) – The filename of the data reduction file to read a transformation from. If not specified, read_transformation() must be called before using this class.

Returns:

None

static _create_projected_arrays(sources, save_intermediate, in_place)[source]

Create a numpy structured array to hold the projected sources.

inverse(x, y, result='equatorial', **source_properties)[source]

Return the sky coordinates of the given source.

read_transformation(dr_file, **dr_path_substitutions)[source]

Read the transformation from the given DR file (already opened).

set_transformation(pre_projection_center, terms_expression, coefficients, pre_projection_name='tan_projection')[source]

Set the projection to use.

Submodules