NAME

tascale - Scale aperture parameters.

USAGE

tascale intable outtable

DESCRIPTION

This routine applies coordinate transformations to an aperture parameter table previously generated by the tamode task. The following transformations are performed:

     x'    = (x - xoffset) * xscale
     y'    = (y - yoffset) * yscale
     xout  = x' * cos(theta) - y' * sin(theta) 
     yout  = x' * sin(theta) + y' * cos(theta)
     flux' = (flux - foffset) * fscale
     area' = area * xscale * yscale
where:
     x and y are the input positions.
     area and flux are the input 'AREA' and 'FLUX' columns.
     xout, yout, flux' and area' are the output values.
	The rotation is not applied to the edge positions.
	The output values of aperture and edge positions
	are x' and y'.
     xscale, yscale, fscale, xoffset, yoffset, foffset, and
	theta are input parameters

PARAMETERS

intable [file name]

The name of the input aperture table that was previously generated by the tamode task. This table has the following columns: TIME, APERTURE, RIGHT_EDGE, LEFT_EDGE, UPPER_EDGE, LOWER_EDGE, X_CENTER, Y_CENTER, X_CENTROID, Y_CENTROID, X_CROSSCOR, Y_CROSSCOR, AREA, and FLUX.

outtable [file name]

The name of the output table of scaled values produced by tascale. This table has the same columns as the input table, which was itself created by the tamode task. (Type "help tamode" for a detailed description of the column names and contents.)

(xoffset = 0.0) [real]

Value of the X-offset to be applied to the RIGHT_EDGE, LEFT_EDGE, X_CENTER, X_CENTROID, and X_CROSSCOR columns.

(xscale = 1.0) [real]

Value of the scale factor to be applied to the RIGHT_EDGE, LEFT_EDGE, X_CENTER, X_CENTROID, X_CROSSCOR, and AREA columns.

(yoffset = 0.0) [real]

Value of the Y offset to be applied the the UPPER_EDGE, LOWER_EDGE, Y_CENTER, Y_CENTROID, AND Y_CROSSCOR columns.

(yscale = 1.0) [real]

The scale factor value to be applied to the UPPER_EDGE, LOWER_EDGE, Y_CENTER, Y_CENTROID, Y_CROSSCOR, and AREA columns.

(theta = 0.0) [real]

The angle by which to rotate the axis (counter clockwise). It should be specified in degrees. It is applied to the Y_CENTER, Y_CENTROID, and Y_CROSSCOR columns.

(foffset = 0.0) [real]

Value of the offset to be applied to the FLUX column.

(fscale = 1.0) [real]

Value of the scale factor to be applied to the FLUX column.

(xunits = " ") [string]

String describing the X units after the scale change. Maximum length is 19 characters.

(yunits = " ") [string]

String describing the Y units after the scale change. Maximum length is 19 characters.

(funits = " ") [string]

String giving the flux units after the scale change. Maximum length is 19 characters.

EXAMPLES:

1. Move the origin of the aperture parameters to the location of SC1 at deflections 3050.0 and 2011.0 for the table mytab. Place the results in a table called newtab.

	hr> tascale mytab newtab xoffset=3050 yoffset=2011

2. Convert the previous run to micron units with a scale factor of 6.25 microns per deflection unit in both directions.

	hr> xunits = "microns"
	hr> yunits = "microns"
	hr> tascale newtab microntab xscale=6.25 yscale=6.25

BUGS

REFERENCES

HELP

For assistance using this or any other tasks, please contact help@stsci.edu or call the help desk at 410-338-1082.

SEE ALSO

tamode