next up previous
Next: AST_WRITE - Write an Object to a Channel
Up: AST Routine Descriptions
Previous: AST_WCSMAP - Create a WcsMap

AST_WINMAP - Create a WinMap   

Description:
This function creates a new WinMap and optionally initialises its attributes. A Winmap is a linear Mapping which transforms a rectangular window in one coordinate system into a similar window in another coordinate system by scaling and shifting each axis (the window edges being parallel to the coordinate axes).

A WinMap is specified by giving the coordinates of two opposite corners (A and B) of the window in both the input and output coordinate systems.

Invocation:
RESULT = AST_WINMAP( NCOORD, INA, INB, OUTA, OUTB, OPTIONS, STATUS )

Arguments:
NCOORD = INTEGER (Given)
The number of coordinate values for each point to be transformed (i.e. the number of dimensions of the space in which the points will reside). The same number is applicable to both input and output points.
INA( NCOORD ) = DOUBLE PRECISION (Given)
An array containing the coordinates of corner A of the window in the input coordinate system.
INB( NCOORD ) = DOUBLE PRECISION (Given)
An array containing the coordinates of corner B of the window in the input coordinate system.
OUTA( NCOORD ) = DOUBLE PRECISION (Given)
An array containing the coordinates of corner A of the window in the output coordinate system.
OUTB( NCOORD ) = DOUBLE PRECISION (Given)
An array containing the coordinates of corner B of the window in the output coordinate system.
OPTIONS = CHARACTER * ( * ) (Given)
A character string containing an optional comma-separated list of attribute assignments to be used for initialising the new WinMap. The syntax used is identical to that for the AST_SET routine.
STATUS = INTEGER (Given and Returned)
The global status.

Returned Value:
AST_WINMAP = INTEGER
A pointer to the new WinMap.

Notes:
  • A null Object pointer (AST__NULL) will be returned if this function is invoked with STATUS set to an error value, or if it should fail for any reason.



next up previous
Next: AST_WRITE - Write an Object to a Channel
Up: AST Routine Descriptions
Previous: AST_WCSMAP - Create a WcsMap

AST A Library for Handling World Coordinate Systems in Astronomy
Starlink User Note 210
R.F. Warren-Smith & D.S. Berry
30th April 2003
E-mail:ussc@star.rl.ac.uk

Copyright (C) 2003 Central Laboratory of the Research Councils