SURF_REQUEST_OUTPUT_COORDS - Request longitude and latitude of output map from user

Description:

Prompts user for output coordinates of map in the specified coordinate frame. The default values are derived from the supplied apparent RA/Dec centre. The selected centre is returned (in apparent ra/dec).

Invocation:

CALL SURF_REQUEST_OUTPUT_COORDS( TASK, PARLONG, PARLAT, OUT_COORDS, LAT_OBS, DEF_RA_CEN, DEF_DEC_CEN, MJD, HOURS, OUT_RA_CEN, OUT_DEC_CEN, OUT_ROTATION, OUT_LONG, OUT_LAT, STATUS)

Arguments:

TASK = CHARACTER (Given)

Description of task to be used in error messages

PARLONG = CHARACTER (Given)

Name of the parameter used to request the LONGITUDE

PARLAT = CHARACTER (Given)

Name of the parameter used to request the LATITUDE

OUT_COORDS = CHARACTER (Given)

Coordinate frame of output coordinates.

LAT_OBS = DOUBLE (Given)

Latitude of observatory (Radians)

DEF_RA_CEN = DOUBLE (Given)

Apparent RA of the default map centre (radians)

DEF_DEC_CEN = DOUBLE (Given)

Apparent Dec of the default map centre (radians)

MJD = DOUBLE (Given)

Modified Julian date to be used as reference for apparent RA/Dec coordinates

HOURS = LOGICAL (Given)

Flag to decide whether longitude is expressed as hours or degrees

OUT_RA_CEN = DOUBLE (Returned)

Apparent RA of output map centre (radians)

OUT_DEC_CEN = DOUBLE (Returned)

Apparent Dec of output map centre (radians)

OUT_ROTATION = DOUBLE (Returned)

angle between apparent N and N of output coord system (radians)

OUT_LONG = DOUBLE (Returned)

longitude of output map centre in the selected coordinate frame (rad)

OUT_LAT = DOUBLE (Returned)

latitude of output map centre in the selected coordinate frame (rad)

STATUS = INTEGER (Given & Returned)

Global status

Notes:

• The output coordinates are always slightly different from the when defaults are accepted since there is a loss of precision converting the ra/dec to and from a string form.

Copyright

Copyright ©1995,1996,1997,1998,1999 Particle Physics and Astronomy Research Council. All Rights Reserved.