|
MERIS IDL General Purpose Tools |
Last modified: Wed Dec 05 10:45:15 2001.
NAME:
FOOTPRINT
PURPOSE:
projects a MERIS image footprint on a map
CATEGORY:
graphics
CALLING SEQUENCE:
FOOTPRINT,PRDFILE=prdfile,PSFILE=psfile,TIFFFILE=tifffile,TITLE=title,LIMIT=limit,DATABASE_DIR=database_dir, $
MLINETHICK=mlinethick,FACTOR=factor,/COASTS,/BORDERONLY,BOUNDARYCOLOR=boundarycolor,IMAGECOLOR=imagecolor
INPUTS:
None (all inputs are passed using keywords)
OPTIONAL INPUTS:
None
KEYWORD PARAMETERS:
PRDFILE - MERIS Level 1b or Level 2 product file scalar or array string
PSFILE - A scalar string containing the full pathname of the PS file to write
TIFFFILE - A scalar string containing the full pathname of the TIFF file to write
DATABASE_DIR - A scalar string containing the DATABASE_DIR environment variable
LIMIT - Limits of map display, [LATMIN,LONMIN,LATMAX,LONMAX]
(default is [MIN(LAT),MIN(LON),MAX(LAT),MAX(LON)] where
LAT and LON are latitude and longitude maps of the
MERIS scene)
CENTER - [lat,lon], center of the map projection
BORDERONLY - when set then only the border of the image is shown
COASTS - when set then coastlines, islands, and lakes are shown
MLINETHICK - thickness of continent and country boundary lines ; default thickness is 1.
FACTOR - value used to increase or decrease the number of tie
points of the image ; i.e. if factor is set to 2
for image holding 71*9 tie points then latitudes and
longitudes of tie points are interpolated to give
(2*71)*(2*9) tie points. When increasing the factor
value you are increasing the number of tiles that are
used to build the image footprint, and you are less
likely to see dots (symbolizing each tie point) on the
image.
BOUNDARYCOLOR - specifies the color of coastlines (by default set
to 170).
IMAGECOLOR - specifies the color of the MERIS image border when
BORDERONLY is set (by default set to 40)
XRESOL - When writing image to TIFF file, sets the horizontal
resolution, in pixels per inch. The default is 100.
YRESOL - When writing image to TIFF file, sets the vertical
resolution, in pixels per inch. The default is 100.
LATITUDE -
LONGITUDE -
OUTPUTS:
image with MERIS scene footprint on coastline/continent map
OPTIONAL OUTPUTS:
None
COMMON BLOCKS:
None
SIDE EFFECTS:
BUG BUG BUG --------------------->>>>>>>>>>>
1) MEGS_HOME needs to be positioned outside of IDL otherwise I get :
% CONVERT_COORD: Value of Latitude is out of allowed range.
% Program caused arithmetic error: Floating illegal operand
????????????????????
RESTRICTIONS:
Unknown
PROCEDURE:
MERIS level (L1b or L2) is interpreted from the product file header.
then latitude and longitude maps are retrieved from the annotations
(using the rd_prod function) and are passed over to the imagemap
function that displays coastlines and image footprint on the same map.
EXAMPLE:
PRDFILE='/megs/megs.4.2/folders/sat_L02_4_2/pacific_30/files/l2_rr.prd'
FOOTPRINT,PRDFILE=prdfile
FOOTPRINT,PRDFILE=prdfile,title='pacific_30 map',TIFFFILE='~/test.tiff'
FOOTPRINT,PRDFILE=prdfile,title='pacific_30 map',PSFILE='~/test.ps'
FOOTPRINT,LATITUDE=geometry.lat,LONGITUDE=geometry.lon,/BORDERONLY
MODIFICATION HISTORY:
created by Vincent Fournier-Sicre - November 1999 - vfs@acri.fr
ACRI S.A.
19 Jan. 2001 - vfs - uses FILE_TEST function to test file existence
(See $IDL_LOCAL\Meris\footprint.pro)