.\

cgmap_set.pro

top cgMap_Set

Graphics, Map Projections

cgMap_Set [, p0lat] [, p0lon] [, rot] [, /ADDCMD], ADVANCE=ADVANCE, AITOFF=AITOFF, ALBERS=ALBERS, AZIMUTHAL=AZIMUTHAL [, BACKGROUND=string], BOX_AXES=BOX_AXES, CENTRAL_AZIMUTH=CENTRAL_AZIMUTH, CHARSIZE=CHARSIZE, CLIP=CLIP, COASTS=COASTS [, COLOR=string], CON_COLOR=CON_COLOR, CONIC=CONIC [, /CONTINENTS], COUNTRIES=COUNTRIES, CYLINDRICAL=CYLINDRICAL, E_CONTINENTS=E_CONTINENTS, E_HORIZON=E_HORIZON, E_GRID=E_GRID, ELLIPSOID=ELLIPSOID [, /ERASE], FILL_CONTINENTS=FILL_CONTINENTS, GLINESTYLE=GLINESTYLE, GLINETHICK=GLINETHICK [, /GRID], GOODESHOMOLOSINE=GOODESHOMOLOSINE, GNOMIC=GNOMIC, HAMMER=HAMMER, HIRES=HIRES, HORIZON=HORIZON, ISOTROPIC=ISOTROPIC, LAMBERT=LAMBERT, LABEL=LABEL, LATALIGN=LATALIGN, LATDEL=LATDEL, LATLAB=LATLAB, LIMIT=LIMIT, LONALIGN=LONALIGN, LONDEL=LONDEL, LONLAB=LONLAB, MERCATOR=MERCATOR, MILLER_CYLINDRICAL=MILLER_CYLINDRICAL, MLINESTYLE=MLINESTYLE, MLINETHICK=MLINETHICK, MOLLWEIDE=MOLLWEIDE, NAME=NAME, NOBORDER=NOBORDER, NOERASE=NOERASE [, /ONIMAGE], ORTHOGRAPHIC=ORTHOGRAPHIC [, POSITION=FltArr(4)], PROJECTION=PROJECTION, RIVERS=RIVERS, REVERSE=REVERSE, ROBINSON=ROBINSON, SAT_P=SAT_P, SATELLITE=SATELLITE, SCALE=SCALE, STANDARD_PARALLELS=STANDARD_PARALLELS, STEREOGRAPHIC=STEREOGRAPHIC, SINUSOIDAL=SINUSOIDAL, T3D=T3D, TITLE=TITLE, TRANSVERSE_MERCATOR=TRANSVERSE_MERCATOR, USA=USA, WHOLE_MAP=WHOLE_MAP [, /WINDOW], XMARGIN=XMARGIN, YMARGIN=YMARGIN, ZVALUE=ZVALUE

Provides a modified MAP_SET command that can work together with other Coyote Graphics commands and be used in resizeable graphics windows. Any keyword appropriate for MAP_SET, MAP_CONTINENTS, or MAP_GRID can be used with this routine. Additional or modified keywords are documented.

Parameters

p0lat in optional type=float

The center latitude of the map projection.

p0lon in optional type=float

The center longitude of the map projection.

rot in optional type=float default=0.0

The angle through which the map projection should be rotated. Positve values are in a clockwise direction.

Keywords

ADDCMD in optional type=boolean default=0

If this keyword is set, the command is added to the resizeable graphics window, cgWindow.

ADVANCE

AITOFF

ALBERS

AZIMUTHAL

BACKGROUND in optional type=string default=white

The name of the background color. Using this keyword automatically sets the ERASE keyword to 1.

BOX_AXES

CENTRAL_AZIMUTH

CHARSIZE

CLIP

COASTS

COLOR in optional type=string default=opposite

The name of the drawing color for the program. erase: in, optional, type=boolean, default=0 Set this keyword if you wish to the current graphics content of the window before drawing the map projection. The graphics display will be erased in the background color. This is a more intuitive way to set this behavior than to set NOERASE to 0, which does the same thing.

CON_COLOR

CONIC

CONTINENTS in optional type=boolean default=0

Set this keyword to display continental outlines on the map projection. Any keyword appropriate to the IDL command Map_Continents can be used to modify the look of the continental outlines.

COUNTRIES

CYLINDRICAL

E_CONTINENTS

E_HORIZON

E_GRID

ELLIPSOID

ERASE in optional type=boolean default=0

A more intuitive way to set NOERASE=0. If ERASE is set, the display window is erased in the BACKGROUND color.

FILL_CONTINENTS

GLINESTYLE

GLINETHICK

GRID in optional type=boolean default=0

Set this keyword to display a map grid on the map projection. And keyword appropriate to the IDL command Map_Grid can be used to modify the look of the map grid.

GOODESHOMOLOSINE

GNOMIC

HAMMER

HIRES

HORIZON

ISOTROPIC

LAMBERT

LABEL

LATALIGN

LATDEL

LATLAB

LIMIT

LONALIGN

LONDEL

LONLAB

MERCATOR

MILLER_CYLINDRICAL

MLINESTYLE

MLINETHICK

MOLLWEIDE

NAME

NOBORDER

NOERASE

ONIMAGE in optional type=boolean default=0

If this keyword is set, the position of the map projection in the graphics window is obtained from the last image displayed with cgImage. This makes it extremely easy to display an image and immediately set up a map projection space that will allow you to annotate the image using map locations. This keyword is ignored if the 'Position keyword is used.

ORTHOGRAPHIC

POSITION in optional type=FltArr(4)

The normalized position of the map projection space in the graphics window. The default is [0.075, 0.075, 0.925, 0.925]

PROJECTION

RIVERS

REVERSE

ROBINSON

SAT_P

SATELLITE

SCALE

STANDARD_PARALLELS

STEREOGRAPHIC

SINUSOIDAL

T3D

TITLE

TRANSVERSE_MERCATOR

USA

WHOLE_MAP

WINDOW in optional type=boolean default=0

If this keyword is set, the command replaces any commands in a current cgWindow or it opens a new cgWindow and adds itself to it.

XMARGIN

YMARGIN

ZVALUE

Author information

Author:

FANNING SOFTWARE CONSULTING:

  David W. Fanning
  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

Copyright:

History:

Written by David W. Fanning, 7 November 2011. Added ONIMAGE keyword to allow the position to be specified at the last image position from cgImage. 3 March 2012. DWF. Several MAP_CONTINENTS keywords seem to have gone missing. Added COASTS, COUNTRIES, FILL_CONTINENTS, and RIVERS. 4 Dec 2012. DWF. Forgot to pass the "extra" information in (e.g., E_HORIZON keyword) to Map_Set. 18 Jan 2013. DWF. HORIZON keyword not being passed along to Map_Set. 28 Feb 2013. DWF. Forgot to look at !P.Multi before setting a POSITION. Fixed. 11 March 2013. DWF. Modified the E_GRID and E_HORIZON structure code to allow color names. 29 April 2013. Joe Sapp. In some situations, the "extra" continents structure was not being passed along. 29 May 2013. DWF. Now, when "extra" structures are passed along, they can have duplicate fields. Put check in place. 22 June 2013. DWF.

File attributes

Modification date:	Fri Mar 27 11:07:36 2015
Lines:	637
Docformat:	rst rst

Coyote Graphics Routines