Program:      SCALE

Purpose:      Program to scale the data in subsets by a factor and an
              offset.

Category:     MANIPULATION, UTILITY

File:         scale.shl

Author:       K.G. Begeman

Keywords:

   INSET=     Set (and subset(s)) to scale. Maximum number of input
              and output subsets is 2048.

   BOX=       Frame in subsets to scale [entire subset].

   OUTSET=    Set and subset(s) where to store the scaled data.
              [input set].

** A=         Enter scaling factor(s) [1.0]. If you need different
              scaling factors for each subset, you should use this
              keyword.

** B=         Enter offset(s) [0.0]. Only asked if different scaling
              factors are wanted.

   AB=        Give scaling factor and offset [1.0,0.0]. Output
              subsets will be: A * input subset + B.

** OPTION=    Option which determines what to do with the data outside
              BOX [0]. The different options are:
              0  Scale inside BOX and set to blank outside BOX.
              1  Scale outside BOX and set BOX to blank.
              2  Scale BOX and transfer unscaled outside BOX.
              3  Scale outside BOX and transfer BOX unscaled.

Example:      <USER  >SCALE
              <USER  >SCALE    ,INSET=AURORA FREQ
              Set AURORA has 3 axes
              RA-NCP             from    -7 to     8
              DEC-NCP            from    -7 to     8
              FREQ-OHEL          from     1 to    59
              <USER  >SCALE    ,BOX=PC D 8 8
              BOX range for set AURORA :
              RA-NCP             from    -3 to     4
              DEC-NCP            from    -3 to     4
              <USER  >SCALE    ,OUTSET=
              <USER  >SCALE    ,OKAY=
              Set AURORA has 3 axes
              RA-NCP             from    -7 to     8
              DEC-NCP            from    -7 to     8
              FREQ-OHEL          from     1 to    59
              <USER  >SCALE    ,AB=1.1 -0.1 OPTION=2
              Data inside BOX will be scaled
              Data outside BOX will be transferred unscaled
              <STATUS>  SCALE   +++ FINISHED +++

Updates:      Jan 31, 1990: KGB Document created.
              Dec 11, 1991: KGB Cancel replaced by reject.
              Jul 12, 1994: KGB Allow for different scaling factors.