# coyote: PRECIPMAP

- coyote/Map Projections
- [Source code]

NAME

      PrecipMap

PURPOSE

      This is a program that demonstrates how to place an IDL map projection
      onto an image that is already in a map projection space. It uses a NOAA
      precipitation image that is in a polar stereographic map projection, and
      for which the latitudes and longitudes of its four corners are known.
      For additional details, see http://www.idlcoyote.com/map_tips/precipmap.html.

AUTHOR

      FANNING SOFTWARE CONSULTING
      David Fanning, Ph.D.
      1645 Sheely Drive
      Fort Collins, CO 80526 USA
      Phone: 970-221-0438
      E-mail: david@idlcoyote.com
      Coyote's Guide to IDL Programming: http://www.idlcoyote.com/

CATEGORY

      Map Projection

CALLING SEQUENCE

      IDL> PrecipMap, filename

INPUTS

      filename:   The name of the precipitation file. For demo, download
                  ST4.2005010112.24h.bin from http://www.idlcoyote.com/data/ST4.2005010112.24h.bin.

KEYWORDS

      DATA:   Set this keyword to a named variable that on output will contain the scaled data.
      PALETTE:    Set this keyword to a named variable that on output will contain the color
                  palette used to display the data.

RESTRICTIONS

      Requires files from the Coyote Library:
      http://www.idlcoyote.com/documents/programs.html

MODIFICATION HISTORY

      Written by David W. Fanning, 28 April 2006 from code and discussion supplied
           by James Kuyper in the IDL newsgroup.
      Renamed Colorbar procedure to cgColorbar to avoid conflict with IDL 8 Colorbar function.
            26 September 2010. DWF.
      Got the polar stereo map projection correct. 5 September 2011. DWF.
      Added DATA, MAP, and PALETTE output keywords and updated to use more modern Coyote
            Library mapping routines. 2 November 2012. DWF.