## NAME

         libmap - CVIPtools toolkit library containing utilities  for
         mapping data and manipulating data sets

## SYNOPSIS

         #include <CVIPmap.h>

## FUNCTIONS

         libmap includes the following functions:
                              condRemap_Image
                              linearTrans_Image
                              logMap_Image
                              remap_Image
                              trun_Image

## NAME

         ===================================================================
         Image *condRemap_Image(const Image *imageP, CVIP_TYPE dtype,
         unsigned            min,            unsigned            max)
         ===================================================================

## DESCRIPTION

         <imageP> - pointer to Image structure <dtype> - type of  the
         data  to  be  mapped to (e.g. CVIP_BYTE).  must be either as
         precise or less precise than that of the input image.  <min>
         -  minimum value in range (e.g. 0 ) <max> - maximum value in
         range (e.g. 255 )

         Returns: pointer to a new instance  of  the  Image  <imageP>
         that   has  been  mapped  into  the  range  [<min>...<max>].
         Description: Called if a non-byte image  is  passed  to  the
         image viewer. Performs conditional remapping procedure: data
         in range 0-255 is not remapped; data more than 0.499 outside
         specified range is completely remapped.  Author(s): Kun Luo,
         Arve Kjoelen.

## NAME

         ===================================================================
         void    linearTrans_Image(float    **cvecP,   unsigned   int
         no_of_vecs,  unsigned  int   vdim,   double   **transmatrix)
         ===================================================================

         <cvecP> - pointer to an array of band vectors <no_of_vecs> -
         number  of vectors <vdim> - dimension of each vector (number
         of pixels) <transmatrix> - transformation matrix

         Description: linearly  transforms  a  set  of  band  vectors
         <cvecP>  through  a transformation matrix <transmatrix>. The
         transformation  matrix  must  be   have   a   dimension   of
         <no_of_vecs> by <no_of_vecs>.  Author(s): Gregory Hance.

## NAME

         ===================================================================
         Image *logMap_Image(image *image, int band)
         ===================================================================

         <image> - Pointer to Image structure.
         <band> - the band to do logarithmic mapping;
                  -1=all bands, 0=1st band, 1=2nd band, etc.

## DESCRIPTION

         This function remaps a transformed image  using  logarithmic
         mapping.    The   resulting   spectra  Image   structure  is
         returned. The "band" specifies on which  band  to  do  loga-
         rithmic mapping. If band == -1, or band > [(number of bands)
         - 1] all bands will be remapped;  otherwise  only  one  band
         will  be remapped and the return Image is a grayscale image.
         For example, with a color, three-band, RGB image: 0 = Red, 1
         = Green, 2 = Blue.  Author(s): Simon Lowh, Yansheng Wei

## NAME

         ===================================================================
         Image  *remap_Image(const  Image  *imageP,  CVIP_TYPE dtype,
         unsigned           dmin,           unsigned            dmax)
         ===================================================================

## DESCRIPTION

         <imageP> - pointer to Image structure <dtype> - type of  the
         data  to  be  mapped to (e.g. CVIP_BYTE).  must be either as
         precise or less  precise  than  that  of  the  input  image.
         <dmin>  -  minimum value in range (e.g. 0 ) <dmax> - maximum
         value in range (e.g. 255 )

         Returns: pointer to a new instance  of  the  Image  <imageP>
         that  has  been  mapped  into  the  range [<dmin>...<dmax>].
         Description: performs remapping procedure in which the rela-
         tive  size of each data band is maintained.  Author(s): Gre-
         gory Hance.

## NAME

         ===================================================================
         void trun_Image(const Image *imageP, type dtype, long dmin, long dmax)
         ===================================================================

         <imageP> - Pointer to Image structure.
         <dtype> - type of the data to be mapped to (e.g. CVIP_BYTE). Must be either
         as precise or less precise.
         <dmin> - minimum value in range (e.g. 0 )
         <dmax> - maximum value in range (e.g. 255 )

## DESCRIPTION

         This function remaps an image, maintaining the relative size
         of each data band.

## PATH

         $CVIPHOME/Mapping/relremap.c

         Author(s): Kun Luo

## BUGS

         none known

## SEE ALSO

         CVIPtools library quick reference guide

## AUTHOR

         Copyright (C) 1992, 1993 SIUE - by Gregory Hance  and  Scott
         Umbaugh.