REFERENCES · HELP · SEE_ALSO

## 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.