root/MGET/Branches/Jason/PythonPackage/dist/TracOnlineDocumentation/Documentation/ArcGISReference/OceanColorLevel3SMITimeSeries.InterpolateAtArcGISPoints.html @ 840

Revision 840, 54.6 KB (checked in by jjr8, 19 months ago)

* Added support for R 2.13.2.
* Rebuilt installation packages. This will be merged with the Trunk and released as MGET 0.8a28.
Line 
1<?xml version="1.0" encoding="utf-8"?>
2<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
3<html xmlns="http://www.w3.org/1999/xhtml"><head><link rel="stylesheet" type="text/css" href="81help.css?format=raw" /><meta http-equiv="Content-Type" content="text/html; charset=UTF-8" /><title>Interpolate NASA OceanColor L3 SMI Product at Points</title></head><body><table style="margin-top:-1em; margin-bottom:0; padding:0; margin-left:-1em"><tr><td style="background:white"><img width="875" height="70" alt="ArcToolbox banner" src="AHBanner_ArcToolbox.gif?format=raw" /></td></tr></table><h1>Interpolate NASA OceanColor L3 SMI Product at Points</h1><p></p><p>Interpolates the values of a Level 3 Standard Mapped Image (SMI) product published by the NASA GSFC OceanColor Group at points.</p><p>Given a sensor name, temporal resolution, spatial resolution, and
4desired Level 3 SMI product, this tool interpolates the value of that
5product at the given points. This tool performs the same basic
6operation as the ArcGIS Spatial Analyst's Extract Values to Points
7tool, but it downloads and reads HDF files from NASA's servers rather
8than reading rasters stored on your machine.</p><p>The <a href="http://oceancolor.gsfc.nasa.gov/">NASA Goddard Space Flight Center (GSFC) OceanColor Group</a>
9publishes a variety of satellite image products derived from ocean
10color observations made by polar-orbiting sensors such as MODIS,
11SeaWiFS, OCTS, and CZCS. The most popular product is an estimate of
12chlorophyll-a concentration.</p><p>This tool accesses the Level 3 Standard Mapped Image (SMI)
13products, which have global spatial extent, use a geographic
14coordinate system with the WGS 1984 datum, and have square cells with
15either 1/12 or 1/24 degree resolution (about 9.3 km or 4.6 km at the
16equator).</p><p>NASA publishes the SMI products as collections of compressed HDF
17version 4 files that are downloadable from the OceanColor web site.
18This tool automatically downloads, decompresses, and reads HDF
19files as they are needed. Unless you specify a directory to cache the
20files, they will be stored in your user TEMP directory and deleted
21when processing is finished.</p><p><b>References</b></p><p>To cite the use of NASA OceanColor data in a publication, please see
22<a href="http://oceancolor.gsfc.nasa.gov/forum/oceancolor/topic_show.pl?tid=474">these instructions</a>.</p><p>For a list of publications from the NASA OceanColor Group, see
23<a href="http://oceancolor.gsfc.nasa.gov/cgi/obpgpubs.cgi">this page</a>.</p><br /><p><h2><img width="11" height="11" border="0" src="sm_arrow_down.gif?format=raw" /> Command line syntax</h2></p><div Class="expand" id="id103138">OceanColorLevel3SMITimeSeriesInterpolateAtArcGISPoints_GeoEco &lt;Aqua | CZCS | OCTS | SeaWiFS | Terra&gt; &lt;Daily | 8day | Monthly | Annual&gt; &lt;4km | 9km&gt; &lt;product&gt; &lt;points&gt; &lt;valueField&gt; &lt;tField&gt; {Nearest | Linear} {cacheDirectory} {where} {noDataValue} {timeout} {maxRetryTime} {orderByFields;orderByFields...} {numBlocksToCacheInMemory} {xBlockSize} {yBlockSize} {tBlockSize} <br /><br /><b>Parameters</b><br /><table width="100%" border="0" cellpadding="5"><tbody><tr><th width="40%"><b>Expression</b></th><th width="60%"><b>Explanation</b></th></tr><tr><td class="info">&lt;Aqua | CZCS | OCTS | SeaWiFS | Terra&gt;</td><td class="info" align="left"><p>Sensor to use, one of:</p><ul><li><p>Aqua - the Moderate Resolution Imaging Spectroradiometer (MODIS)
24sensor carried by the Aqua satellite. Aqua datasets start in July
252002 and were still being collected at the time this tool was
26written.</p></li></ul><ul><li><p>CZCS - the Coastal Zone Color Scanner (CZCS) carried by the Nimbus 7
27satellite. CZCS datasets start in September 1978 and end in June
281986.</p></li></ul><ul><li><p>OCTS - the Ocean Color and Temperature Scanner (OCTS) carried by the
29ADEOS-1 satellite. OCTS datasets start in November 1996 and end in
30June 1997. Although the mission was designed to last several years,
31ADEOS-1 stopped communicating after nine months due to the failure
32of its solar power system.</p></li></ul><ul><li><p>SeaWiFS - Sea-viewing Wide Field-of-view Sensor (SeaWiFS) carried by
33the SeaStar satellite. SeaWiFS datasets start in September 1997 and
34were still being collected at the time this tool was written.
35SeaWiFS has been operating far beyond its designed lifetime and has
36experienced periodic failures in recent years. In particular, as of
37this writing, little or no data are available for the time periods
38of January to March 2008, July and August 2008, late April to mid
39July 2009, and September to November 2009.</p></li></ul><ul><li><p>Terra - the Moderate Resolution Imaging Spectroradiometer (MODIS)
40sensor carried by the Terra satellite. Terra datasets start in
41February 2000 and were still being collected at the time this tool
42was written. <b>Warning:</b> Due to problems with the sensor scan
43mirror, ocean color observations from MODIS Terra are considered to
44be significantly less accurate than those from MODIS Aqua or
45SeaWiFS, and NASA recommends
46<a href="http://oceancolor.gsfc.nasa.gov/forum/oceancolor/topic_show.pl?tid=3734">here</a>
47that "if you have a choice between any other sensor and MODIS Terra,
48choose the other sensor." NASA devised statistical algorithms to
49correct the data somewhat; for more information, see Franz et al.
50(2008) and Kwiatkowska et al. (2008).</p></li></ul><p>The NASA OceanColor Group may publish data for other sensors, but they
51are not supported by this tool at this time. If you need one of those
52products, please contact the author of this tool to see if support may
53be added.</p><p><b>References</b></p><p>Kwiatkowska, E.J., B.A. Franz, G. Meister, C.R. McClain, and X. Xiong
54(2008). Cross-Calibration of ocean color bands from Moderate
55Resolution Imaging Spectroradiometer on Terra platform. Applied Optics
5647(36): 6796-6810.</p><p>Franz, B.A., E.J. Kwiatkowska, G. Meister, and C.R. McClain (2008).
57Moderate Resolution Imaging Spectroradiometer on Terra: limitations
58for ocean color applications, Journal of Applied Remote Sensing 2:
59023525.</p></td></tr><tr><td class="info">&lt;Daily | 8day | Monthly | Annual&gt;</td><td class="info" align="left"><p>Temporal resolution to use, one of:</p><ul><li><p>Daily - daily images. There are 365 during normal years and 366
60during leap years.</p></li></ul><ul><li><p>8day - 8-day images. There are 46 per year. The first image of the
61year starts on January 1. The duration of the last image of the year
62is five days during normal years and six days during leap years.</p></li></ul><ul><li><p>Monthly - monthly images.</p></li></ul><ul><li><p>Annual - annual images.</p></li></ul><p>Although NASA may publish MODIS SST images at other temporal
63resolutions, they are not supported at this time. If you need one of
64those products, please contact the author of this tool to see if
65support may be added.</p><p>The ocean color sensors experience occasional transient failures that
66prevent data from being collected, sometimes for an extended period.
67NASA opted not to produce any images for these periods. These missing
68images are represented as time slices filled with the NoData value.
69For example, during 2004, NASA produced only 43 8-day images of
70chlorophyll-a concentration for the Aqua satellite. Thus, of the 46
718-day time slices for 2004, 43 have some valid pixels while 3 are
72filled entirely with the NoData value.</p></td></tr><tr><td class="info">&lt;4km | 9km&gt;</td><td class="info" align="left"><p>Spatial resolution to use, one of:</p><ul><li><p>4km - the grid has a cell size of 1/24 geographic degree, or about
734.64 km at the equator, with 8640 columns and 4320 rows.</p></li></ul><ul><li><p>9km - the grid has a cell size of 1/12 geographic degree, or about
749.28 km at the equator, with 4320 columns and 2160 rows.</p></li></ul></td></tr><tr><td class="info">&lt;product&gt;</td><td class="info" align="left"><p>Product code of the NASA Level 3 Standard Mapped Image (SMI)
75product to use, such as CHL_chlor_a for chlorophyll concentration.</p><p>The products that are available depend on the sensor. Newer sensors
76such as SeaWiFS and MODIS provide more products. The product must be
77specified using a code assigned by NASA. Most users will be interested
78in the chlorophyll-a concentration product, which has the code
79CHL_chlor_a for all sensors except CZCS, which uses the code CHLO.</p><p>For all sensors, NASA provides a set of "standard" products that are
80well tested and believed to be of wide interest. For a few sensors,
81NASA also provides "evaluation" and "test" products, which are less
82well-tested and of narrower interest. Please see NASA documentation
83for more information on the products you are interested in.</p><p>Here, we list all of the products we were aware of when this tool was
84developed. If you are aware of product that is not listed here, you
85may try its product code. The product code is defined by the
86characters that appear in NASA's file name between the temporal
87resolution and spatial resolution codes. For example, in the file
88O1997164.L3m_DAY_CHL_chlor_a_9km.bz2, the product code is
89CHL_chlor_a.</p><p>This tool only supports L3 SMI products at 4 km and 9 km resolution.
90It does not support L0, L1, or L2 products. For those, please try the
91<a href="http://seadas.gsfc.nasa.gov/">SeaDAS tool</a>. It does not support
92binned products, or products at other spatial resolutions.</p><p><b>Aqua and Terra MODIS - Standard Products:</b></p><p>Most MODIS products are available at both 9 km and 4 km resolution.</p><ul><li><p>CDOM_cdom_index - Chromorphic dissolved organic matter index</p></li></ul><ul><li><p>CHL_chlor_a - Chlorophyll-a concentration (mg m-3)</p></li></ul><ul><li><p>FLH_ipar - Instantaneous photosynthetically available radiation (Einstein / m2 / sec)</p></li></ul><ul><li><p>FLH_nflh - Normalized flourescence line height (mW / cm2 / um / sr)</p></li></ul><ul><li><p>KD490_Kd_490 - Diffuse attenuation coefficient at 490 nm (m-1)</p></li></ul><ul><li><p>PAR_par - Photosynthetically available radiation (Einstein / m2 / day)</p></li></ul><ul><li><p>PIC_pic - Particulate inorganic carbon (mol / m3)</p></li></ul><ul><li><p>POC_poc - Particulate organic carbon (mol / m3)</p></li></ul><ul><li><p>RRS_Rrs_412 - Remote sensing reflectance at 412 nm (sr-1)</p></li></ul><ul><li><p>RRS_Rrs_443 - Remote sensing reflectance at 443 nm (sr-1)</p></li></ul><ul><li><p>RRS_Rrs_469 - Remote sensing reflectance at 469 nm (sr-1)</p></li></ul><ul><li><p>RRS_Rrs_488 - Remote sensing reflectance at 488 nm (sr-1)</p></li></ul><ul><li><p>RRS_Rrs_531 - Remote sensing reflectance at 531 nm (sr-1)</p></li></ul><ul><li><p>RRS_Rrs_547 - Remote sensing reflectance at 547 nm (sr-1)</p></li></ul><ul><li><p>RRS_Rrs_555 - Remote sensing reflectance at 555 nm (sr-1)</p></li></ul><ul><li><p>RRS_Rrs_645 - Remote sensing reflectance at 645 nm (sr-1)</p></li></ul><ul><li><p>RRS_Rrs_667 - Remote sensing reflectance at 667 nm (sr-1)</p></li></ul><ul><li><p>RRS_Rrs_678 - Remote sensing reflectance at 678 nm (sr-1)</p></li></ul><ul><li><p>RRS_angstrom - Angstrom coefficient</p></li></ul><ul><li><p>RRS_aot_869 - Aerosol optical thickness at 869 nm</p></li></ul><p><b>Aqua MODIS - Evaluation Products:</b></p><ul><li><p>GSM_adg_443_gsm - Absorption due to gelbstof and detritus at 443 nm (GSM) (m-1)</p></li></ul><ul><li><p>GSM_bbp_443_gsm - Particulate backscatter at 443 nm (GSM) (m-1)</p></li></ul><ul><li><p>GSM_chl_gsm - Chlorophyll-a concentration (GSM) (mg m-3)</p></li></ul><ul><li><p>KDLEE_Kd_412_lee - Diffuse attenuation at 412 nm (Lee) (m-1)</p></li></ul><ul><li><p>KDLEE_Kd_443_lee - Diffuse attenuation at 443 nm (Lee) (m-1)</p></li></ul><ul><li><p>KDLEE_Kd_488_lee - Diffuse attenuation at 488 nm (Lee) (m-1)</p></li></ul><ul><li><p>KDLEE_Zeu_lee - Euphotic depth (Lee) (m)</p></li></ul><ul><li><p>QAA_a_443_qaa - Total absorption at 443 nm (QAA) (m-1)</p></li></ul><ul><li><p>QAA_adg_443_qaa - Absorption due to gelbstof and detritus at 443 nm (QAA) (m-1)</p></li></ul><ul><li><p>QAA_aph_443_qaa - Absorption due to phytoplankton at 443 nm (QAA) (m-1)</p></li></ul><ul><li><p>QAA_bbp_443_qaa - Particulate backscatter at 443 nm (QAA) (m-1)</p></li></ul><ul><li><p>ZEU_KPAR - Diffuse attenuation coefficient for PAR (KPAR, Morel) (m-1)</p></li></ul><ul><li><p>ZEU_ZEUL - Euphotic depth (Lee) (m)</p></li></ul><ul><li><p>ZEU_ZEUM - Euphotic depth (Morel) (m)</p></li></ul><p><b>Aqua MODIS - Test Products:</b></p><ul><li><p>GIOP01_a_443_giop - Total absorption at 443 nm (m-1)</p></li></ul><ul><li><p>GIOP01_a_547_giop - Total absorption at 547 nm (m-1)</p></li></ul><ul><li><p>GIOP01_adg_443_giop - Absorption due to gelbstof and detritus at 443 nm (m-1)</p></li></ul><ul><li><p>GIOP01_adg_s_giop - Spectral slope for gelbstof and detrital absorption</p></li></ul><ul><li><p>GIOP01_aph_443_giop - Absorption due to phytoplankton at 443 nm (m-1)</p></li></ul><ul><li><p>GIOP01_aph_547_giop - Absorption due to phytoplankton at 547 nm (m-1)</p></li></ul><ul><li><p>GIOP01_bb_443_giop - Total backscatter at 443 nm (m-1)</p></li></ul><ul><li><p>GIOP01_bb_547_giop - Total backscatter at 547 nm (m-1)</p></li></ul><ul><li><p>GIOP01_bbp_443_giop - Particulate backscatter at 443 nm (m-1)</p></li></ul><ul><li><p>GIOP01_bbp_s_giop - Spectral slope for particulate backscatter</p></li></ul><ul><li><p>GIOP01_chl_giop - Chlorophyll-a concentration (mg m-3)</p></li></ul><ul><li><p>GIOP01_rrsdiff_giop - Relative remote sensing reflectance difference</p></li></ul><p><b>CZCS - Standard Products:</b></p><p>CZCS products are available at both 9 km and 4 km resolution.</p><ul><li><p>A520 - Aongstrom coefficient, 520 to 865 nm</p></li></ul><ul><li><p>CHLO - Chlorophyll-a concentration (mg / m3)</p></li></ul><ul><li><p>L550 - Normalized water-leaving radiance at 550 nm (mW / cm2 / um /sr)</p></li></ul><ul><li><p>T790 - Aerosol optical thickness at 670 nm</p></li></ul><p><b>OCTS - Standard Products:</b></p><p>OCTS products are available at only at 9 km resolution.</p><ul><li><p>CHL_chlor_a - Chlorophyll-a concentration (mg m-3)</p></li></ul><ul><li><p>KD490_Kd_490 - Diffuse attenuation coefficient at 490 nm (m-1)</p></li></ul><ul><li><p>PIC_pic - Particulate inorganic carbon (mol / m3)</p></li></ul><ul><li><p>RRS_Rrs_412 - Remote sensing reflectance at 412 nm (sr-1)</p></li></ul><ul><li><p>RRS_Rrs_443 - Remote sensing reflectance at 443 nm (sr-1)</p></li></ul><ul><li><p>RRS_Rrs_490 - Remote sensing reflectance at 490 nm (sr-1)</p></li></ul><ul><li><p>RRS_Rrs_516 - Remote sensing reflectance at 416 nm (sr-1)</p></li></ul><ul><li><p>RRS_Rrs_565 - Remote sensing reflectance at 565 nm (sr-1)</p></li></ul><ul><li><p>RRS_Rrs_667 - Remote sensing reflectance at 667 nm (sr-1)</p></li></ul><ul><li><p>RRS_angstrom - Angstrom coefficient</p></li></ul><ul><li><p>RRS_aot_862 - Aerosol optical thickness at 862 nm</p></li></ul><p><b>SeaWiFS - Standard Products:</b></p><p>All SeaWiFS products are available only at 9 km resolution, except for
93LAND_NDVI, which is also available at 4 km.</p><ul><li><p>CDOM_cdom_index - Chromorphic dissolved organic matter index</p></li></ul><ul><li><p>CHL_chlor_a - Chlorophyll-a concentration (mg m-3)</p></li></ul><ul><li><p>KD490_Kd_490 - Diffuse attenuation coefficient at 490 nm (m-1)</p></li></ul><ul><li><p>LAND_NDVI - Normalized difference vegetation index</p></li></ul><ul><li><p>PAR_par - Photosynthetically available radiation (Einstein / m2 / day)</p></li></ul><ul><li><p>PIC_pic - Particulate inorganic carbon (mol / m3)</p></li></ul><ul><li><p>POC_poc - Particulate organic carbon (mol / m3)</p></li></ul><ul><li><p>RRS_Rrs_412 - Remote sensing reflectance at 412 nm (sr-1)</p></li></ul><ul><li><p>RRS_Rrs_443 - Remote sensing reflectance at 443 nm (sr-1)</p></li></ul><ul><li><p>RRS_Rrs_490 - Remote sensing reflectance at 490 nm (sr-1)</p></li></ul><ul><li><p>RRS_Rrs_510 - Remote sensing reflectance at 410 nm (sr-1)</p></li></ul><ul><li><p>RRS_Rrs_555 - Remote sensing reflectance at 555 nm (sr-1)</p></li></ul><ul><li><p>RRS_Rrs_670 - Remote sensing reflectance at 670 nm (sr-1)</p></li></ul><ul><li><p>RRS_angstrom - Angstrom coefficient</p></li></ul><ul><li><p>RRS_aot_865 - Aerosol optical thickness at 865 nm</p></li></ul><p><b>SeaWiFS - Evaluation Products:</b></p><ul><li><p>GSM_adg_443_gsm - Absorption due to gelbstof and detritus at 443 nm (GSM) (m-1)</p></li></ul><ul><li><p>GSM_bbp_443_gsm - Particulate backscatter at 443 nm (GSM) (m-1)</p></li></ul><ul><li><p>GSM_chl_gsm - Chlorophyll-a concentration (GSM) (mg m-3)</p></li></ul><ul><li><p>KDLEE_Kd_412_lee - Diffuse attenuation at 412 nm (Lee) (m-1)</p></li></ul><ul><li><p>KDLEE_Kd_443_lee - Diffuse attenuation at 443 nm (Lee) (m-1)</p></li></ul><ul><li><p>KDLEE_Kd_490_lee - Diffuse attenuation at 490 nm (Lee) (m-1)</p></li></ul><ul><li><p>KDLEE_Zeu_lee - Euphotic depth (Lee) (m)</p></li></ul><ul><li><p>QAA_a_443_qaa - Total absorption at 443 nm (QAA) (m-1)</p></li></ul><ul><li><p>QAA_adg_443_qaa - Absorption due to gelbstof and detritus at 443 nm (QAA) (m-1)</p></li></ul><ul><li><p>QAA_aph_443_qaa - Absorption due to phytoplankton at 443 nm (QAA) (m-1)</p></li></ul><ul><li><p>QAA_bbp_443_qaa - Particulate backscatter at 443 nm (QAA) (m-1)</p></li></ul><p><b>SeaWiFS - Test Products:</b></p><ul><li><p>GIOP01_a_443_giop - Total absorption at 443 nm (m-1)</p></li></ul><ul><li><p>GIOP01_a_555_giop - Total absorption at 555 nm (m-1)</p></li></ul><ul><li><p>GIOP01_adg_443_giop - Absorption due to gelbstof and detritus at 443 nm (m-1)</p></li></ul><ul><li><p>GIOP01_adg_s_giop - Spectral slope for gelbstof and detrital absorption</p></li></ul><ul><li><p>GIOP01_aph_443_giop - Absorption due to phytoplankton at 443 nm (m-1)</p></li></ul><ul><li><p>GIOP01_aph_555_giop - Absorption due to phytoplankton at 555 nm (m-1)</p></li></ul><ul><li><p>GIOP01_bb_443_giop - Total backscatter at 443 nm (m-1)</p></li></ul><ul><li><p>GIOP01_bb_555_giop - Total backscatter at 555 nm (m-1)</p></li></ul><ul><li><p>GIOP01_bbp_443_giop - Particulate backscatter at 443 nm (m-1)</p></li></ul><ul><li><p>GIOP01_bbp_s_giop - Spectral slope for particulate backscatter</p></li></ul><ul><li><p>GIOP01_chl_giop - Chlorophyll-a concentration (mg m-3)</p></li></ul><ul><li><p>GIOP01_rrsdiff_giop - Relative remote sensing reflectance difference</p></li></ul></td></tr><tr><td class="info">&lt;points&gt;</td><td class="info" align="left"><p>Points at which values should be interpolated.</p><p>OceanColor images use a geographic coordinate system with the WGS 1984
94datum. It is recommended but not required that the points use the same
95coordinate system. If they do not, this tool will attempt to project
96the points to the OceanColor coordinate system prior to doing the
97interpolation. This may fail if a datum transformation is required, in
98which case you will have to manually project the points to the
99OceanColor coordinate system before using this tool.</p></td></tr><tr><td class="info">&lt;valueField&gt;</td><td class="info" align="left"><p>Field of the points to receive the interpolated values.</p><p>The field must have a floating-point or integer data type. If the
100field cannot represent the interpolated value at full precision, the
101closest approximation will be stored and a warning will be issued.
102This will happen, for example, when you interpolate values into an
103integer field.</p></td></tr><tr><td class="info">&lt;tField&gt;</td><td class="info" align="left"><p>Field of the points that specifies the date and time of the point.</p><p>The field must have a date or datetime data type. If the field can
104only represent dates with no time component, the time will assumed to
105be 00:00:00.</p></td></tr><tr><td class="info">{Nearest | Linear}</td><td class="info" align="left"><p>Interpolation method to use, one of:</p><ul><li><p>Nearest - nearest neighbor interpolation. The interpolated value
106will simply be the value of the cell that contains the point. This
107is the default.</p></li></ul><ul><li><p>Linear - linear interpolation (also known as trilinear
108interpolation). This method averages the values of the eight nearest
109cells in the x, y, and time dimensions, weighting the contribution
110of each cell by the area of it that would be covered by a
111hypothetical cell centered on the point being interpolated. If the
112cell containing the point contains NoData, the result is NoData. If
113any of the other seven cells contain NoData, they are omitted from
114the average, and the result is based on the weighted average of the
115cells that do contain data. This is the same algorithm implemented
116by the ArcGIS Spatial Analyst's Extract Values to Points tool.</p></li></ul></td></tr><tr><td class="info">{cacheDirectory}</td><td class="info" align="left"><p>Directory for caching local copies of downloaded files. A cache
117directory is optional but highly recommended if you plan to repeatedly
118access data for the same range of dates.</p><p>NASA partitions ocean color data into collections of compressed HDF
119files according to the sensor, temporal resolution, spatial
120resolution, product code, and date. These files have global spatial
121extent and typically range from 5 to 70 MB in size. Thus, even if you
122are only interested in a small region of the planet--even just a
123single point location--this tool must still download a global file
124each time slice that is needed. This can take a long time if many
125files are needed.</p><p>When this tool needs a file, it will first check the cache directory
126to see if the file was downloaded and cached during a prior run. If it
127was, data will be read directly from that file. If not, the file will
128be downloaded, decompressed, and stored in the cache directory for
129later use.</p><p>If you use a cache directory, be aware of these common pitfalls:</p><ul><li><p>The caching algorithm permits the directory to grow to infinite size
130and never deletes any cached files. If you access a large number of
131files (e.g. 10 years of daily images) they will all be added to the
132cache. Be careful that you do not fill up your hard disk. To
133mitigate this, manually delete the entire cache or specific files
134within it when they are no longer needed.</p></li></ul><ul><li><p>The caching algorithm stores uncompressed files so that they may be
135accessed quickly, without incuring a decompression step every time
136they are needed. To save space on your hard disk, we highly
137recommend you enable compression of the cache directory by the
138operating system. In Windows Explorer, right click on the directory,
139select Properties, click Advanced, and enable "Compress contents to
140save disk space".</p></li></ul><ul><li><p>Due to limitations in the caching algorithm, it cannot detect when
141NASA reprocesses data products and replaces files on the server with
142updated versions, thereby making the cached files obsolete. Thus, if
143NASA republishes a product with improved data values, the caching
144algorithm will continue to use the old, obsolete values. To mitigate
145this, you should monitor when NASA reprocesses their products and
146delete the cached files when they become obsolete.</p></li></ul></td></tr><tr><td class="info">{where}</td><td class="info" align="left"><p>SQL WHERE clause expression that specifies the subset of points to
147use. If this parameter is not provided, all of the points will be
148used.</p><p>The exact syntax of this expression depends on the type of feature
149class you're using. ESRI recommends you reference fields using the
150following syntax:</p><ul><li><p>For shapefiles, ArcInfo coverages, or feature classes stored in file
151geodatabases, ArcSDE geodatabases, or ArcIMS, enclose field names in
152double quotes: "MY_FIELD"</p></li></ul><ul><li><p>For feature classes stored in personal geodatabases, enclose field
153names in square brackets: [MY_FIELD].</p></li></ul></td></tr><tr><td class="info">{noDataValue}</td><td class="info" align="left"><p>Value to use when the interpolated value is NoData.</p><p>If a value is not provided for this parameter, a database NULL value
154will be stored in the field when the interpolated value is NoData. If
155the field cannot store NULL values, as is the case with shapefiles,
156the value -9999 will be used.</p></td></tr><tr><td class="info">{timeout}</td><td class="info" align="left"><p>Number of seconds to wait for the server to respond before failing
157with a timeout error.</p><p>If you also provide a Maximum Retry Time and it is larger than the
158timeout value, the failed request will be retried automatically (with
159the same timout value) until it succeeds or the Maximum Retry Time has
160elapsed.</p><p>If you receive a timeout error you should investigate the server to
161determine if it is malfunctioning or just slow. Check the OceanColor
162website to see if NASA has posted a notice about the problem, or
163contact the NASA directly. If the server just slow, increase the
164timeout value to a larger number, to give the server more time to
165respond.</p></td></tr><tr><td class="info">{maxRetryTime}</td><td class="info" align="left"><p>Number of seconds to retry requests to the server before giving
166up.</p><p>Use this parameter to cope with transient failures. For example, you
167may find that the server is rebooted nightly during a maintenance
168cycle. If you start a long running operation and want it to run
169overnight without failing, set the maximum retry time to a duration
170that is longer than the time that the server is offline during the
171maintenance cycle.</p><p>To maximize performance while minimizing load during failure
172situations, retries are scheduled with progressive delays:</p><ul><li><p>The first retry is issued immediately.</p></li></ul><ul><li><p>Then, so long as fewer than 10 seconds have elapsed since the
173original request was issued, retries are issued every second.</p></li></ul><ul><li><p>After that, retries are issued every 30 seconds until the maximum
174retry time is reached or the request succeeds.</p></li></ul></td></tr><tr><td class="info">{orderByFields;orderByFields...}</td><td class="info" align="left"><p>Fields for defining the order in which the points are processed.</p><p>The points may be processed faster if they are ordered
175spatiotemporally, such that points that are close in space and time
176are processed sequentially. Ordering the points this way increases the
177probability that the value of a given point can be interpolated from
178data that is cached in memory, rather than from data that must be read
179from the disk or network, which is much slower. Choose fields that
180faciliate this. For example, if your points represent the locations of
181animals tracked by satellite telemetry, order the processing first by
182the animal ID and then by the transmission date or number.</p><p>If you omit this parameter, the Date Field will be used automatically.</p><p>This parameter requires ArcGIS 9.2 or later.</p></td></tr><tr><td class="info">{numBlocksToCacheInMemory}</td><td class="info" align="left"><p>Maximum number of blocks of data to cache in memory.</p><p>To minimize the number of times that the disk or network must be
183accessed, this tool employs a simple caching strategy, in addition to
184disk caching described by the Cache Directory parameter. When it
185processes the first point, it reads a square block of cells centered
186on that point and caches it in memory. When it processes the second
187and subsequent points, it first checks whether the cells needed for
188that point are contained by the block cached in memory. If so, it
189processes that point using the in-memory block, rather than reading
190from disk or the network again. If not, it reads another square block
191centered on that point and adds it to the cache.</p><p>The tool processes the remaining points, adding additional blocks to
192the cache, as needed. To prevent the cache from exhausing all memory,
193it is only permitted to grow to the size specified by this parameter.
194When the cache is full but a new block is needed, the oldest block is
195discarded to make room for the newest block.</p><p>The maximum size of the cache in bytes may be calculated by
196multiplying this parameter by 4 and by the block size parameters. For
197example, if this parameter is 128 and the blocks are x=32 by y=32 by
198t=2, the maximum size of the cache is 1048576 bytes (1 MB).</p><p>If this parameter is 0, no blocks will be cached in memory.</p></td></tr><tr><td class="info">{xBlockSize}</td><td class="info" align="left"><p>Size of the blocks of data to cache in memory, in the x direction
199(longitude). The size is given as the number of cells.</p><p>If this parameter is 0, no blocks will be cached in memory.</p></td></tr><tr><td class="info">{yBlockSize}</td><td class="info" align="left"><p>Size of the blocks of data to cache in memory, in the y direction
200(latitude). The size is given as the number of cells.</p><p>If this parameter is 0, no blocks will be cached in memory.</p></td></tr><tr><td class="info">{tBlockSize}</td><td class="info" align="left"><p>Size of the blocks of data to cache in memory, in the t direction
201(time). The size is given as the number of cells.</p><p>If this parameter is 0, no blocks will be cached in memory.</p></td></tr></tbody></table></div><p><h2><img width="11" height="11" border="0" src="sm_arrow_down.gif?format=raw" /> Scripting syntax</h2></p><div Class="expand" id="TEST">OceanColorLevel3SMITimeSeriesInterpolateAtArcGISPoints_GeoEco (sensor, temporalResolution, spatialResolution, product, points, valueField, tField, method, cacheDirectory, where, noDataValue, timeout, maxRetryTime, orderByFields, numBlocksToCacheInMemory, xBlockSize, yBlockSize, tBlockSize) <br /><br /><b>Parameters</b><br /><table width="100%" border="0" cellpadding="5"><tbody><tr><th width="40%"><b>Expression</b></th><th width="60%"><b>Explanation</b></th></tr><tr><td class="info">Sensor (Required) </td><td class="info" align="left"><p>Sensor to use, one of:</p><ul><li><p>Aqua - the Moderate Resolution Imaging Spectroradiometer (MODIS)
202sensor carried by the Aqua satellite. Aqua datasets start in July
2032002 and were still being collected at the time this tool was
204written.</p></li></ul><ul><li><p>CZCS - the Coastal Zone Color Scanner (CZCS) carried by the Nimbus 7
205satellite. CZCS datasets start in September 1978 and end in June
2061986.</p></li></ul><ul><li><p>OCTS - the Ocean Color and Temperature Scanner (OCTS) carried by the
207ADEOS-1 satellite. OCTS datasets start in November 1996 and end in
208June 1997. Although the mission was designed to last several years,
209ADEOS-1 stopped communicating after nine months due to the failure
210of its solar power system.</p></li></ul><ul><li><p>SeaWiFS - Sea-viewing Wide Field-of-view Sensor (SeaWiFS) carried by
211the SeaStar satellite. SeaWiFS datasets start in September 1997 and
212were still being collected at the time this tool was written.
213SeaWiFS has been operating far beyond its designed lifetime and has
214experienced periodic failures in recent years. In particular, as of
215this writing, little or no data are available for the time periods
216of January to March 2008, July and August 2008, late April to mid
217July 2009, and September to November 2009.</p></li></ul><ul><li><p>Terra - the Moderate Resolution Imaging Spectroradiometer (MODIS)
218sensor carried by the Terra satellite. Terra datasets start in
219February 2000 and were still being collected at the time this tool
220was written. <b>Warning:</b> Due to problems with the sensor scan
221mirror, ocean color observations from MODIS Terra are considered to
222be significantly less accurate than those from MODIS Aqua or
223SeaWiFS, and NASA recommends
224<a href="http://oceancolor.gsfc.nasa.gov/forum/oceancolor/topic_show.pl?tid=3734">here</a>
225that "if you have a choice between any other sensor and MODIS Terra,
226choose the other sensor." NASA devised statistical algorithms to
227correct the data somewhat; for more information, see Franz et al.
228(2008) and Kwiatkowska et al. (2008).</p></li></ul><p>The NASA OceanColor Group may publish data for other sensors, but they
229are not supported by this tool at this time. If you need one of those
230products, please contact the author of this tool to see if support may
231be added.</p><p><b>References</b></p><p>Kwiatkowska, E.J., B.A. Franz, G. Meister, C.R. McClain, and X. Xiong
232(2008). Cross-Calibration of ocean color bands from Moderate
233Resolution Imaging Spectroradiometer on Terra platform. Applied Optics
23447(36): 6796-6810.</p><p>Franz, B.A., E.J. Kwiatkowska, G. Meister, and C.R. McClain (2008).
235Moderate Resolution Imaging Spectroradiometer on Terra: limitations
236for ocean color applications, Journal of Applied Remote Sensing 2:
237023525.</p></td></tr><tr><td class="info">Temporal resolution (Required) </td><td class="info" align="left"><p>Temporal resolution to use, one of:</p><ul><li><p>Daily - daily images. There are 365 during normal years and 366
238during leap years.</p></li></ul><ul><li><p>8day - 8-day images. There are 46 per year. The first image of the
239year starts on January 1. The duration of the last image of the year
240is five days during normal years and six days during leap years.</p></li></ul><ul><li><p>Monthly - monthly images.</p></li></ul><ul><li><p>Annual - annual images.</p></li></ul><p>Although NASA may publish MODIS SST images at other temporal
241resolutions, they are not supported at this time. If you need one of
242those products, please contact the author of this tool to see if
243support may be added.</p><p>The ocean color sensors experience occasional transient failures that
244prevent data from being collected, sometimes for an extended period.
245NASA opted not to produce any images for these periods. These missing
246images are represented as time slices filled with the NoData value.
247For example, during 2004, NASA produced only 43 8-day images of
248chlorophyll-a concentration for the Aqua satellite. Thus, of the 46
2498-day time slices for 2004, 43 have some valid pixels while 3 are
250filled entirely with the NoData value.</p></td></tr><tr><td class="info">Spatial resolution (Required) </td><td class="info" align="left"><p>Spatial resolution to use, one of:</p><ul><li><p>4km - the grid has a cell size of 1/24 geographic degree, or about
2514.64 km at the equator, with 8640 columns and 4320 rows.</p></li></ul><ul><li><p>9km - the grid has a cell size of 1/12 geographic degree, or about
2529.28 km at the equator, with 4320 columns and 2160 rows.</p></li></ul></td></tr><tr><td class="info">Level 3 SMI product code (Required) </td><td class="info" align="left"><p>Product code of the NASA Level 3 Standard Mapped Image (SMI)
253product to use, such as CHL_chlor_a for chlorophyll concentration.</p><p>The products that are available depend on the sensor. Newer sensors
254such as SeaWiFS and MODIS provide more products. The product must be
255specified using a code assigned by NASA. Most users will be interested
256in the chlorophyll-a concentration product, which has the code
257CHL_chlor_a for all sensors except CZCS, which uses the code CHLO.</p><p>For all sensors, NASA provides a set of "standard" products that are
258well tested and believed to be of wide interest. For a few sensors,
259NASA also provides "evaluation" and "test" products, which are less
260well-tested and of narrower interest. Please see NASA documentation
261for more information on the products you are interested in.</p><p>Here, we list all of the products we were aware of when this tool was
262developed. If you are aware of product that is not listed here, you
263may try its product code. The product code is defined by the
264characters that appear in NASA's file name between the temporal
265resolution and spatial resolution codes. For example, in the file
266O1997164.L3m_DAY_CHL_chlor_a_9km.bz2, the product code is
267CHL_chlor_a.</p><p>This tool only supports L3 SMI products at 4 km and 9 km resolution.
268It does not support L0, L1, or L2 products. For those, please try the
269<a href="http://seadas.gsfc.nasa.gov/">SeaDAS tool</a>. It does not support
270binned products, or products at other spatial resolutions.</p><p><b>Aqua and Terra MODIS - Standard Products:</b></p><p>Most MODIS products are available at both 9 km and 4 km resolution.</p><ul><li><p>CDOM_cdom_index - Chromorphic dissolved organic matter index</p></li></ul><ul><li><p>CHL_chlor_a - Chlorophyll-a concentration (mg m-3)</p></li></ul><ul><li><p>FLH_ipar - Instantaneous photosynthetically available radiation (Einstein / m2 / sec)</p></li></ul><ul><li><p>FLH_nflh - Normalized flourescence line height (mW / cm2 / um / sr)</p></li></ul><ul><li><p>KD490_Kd_490 - Diffuse attenuation coefficient at 490 nm (m-1)</p></li></ul><ul><li><p>PAR_par - Photosynthetically available radiation (Einstein / m2 / day)</p></li></ul><ul><li><p>PIC_pic - Particulate inorganic carbon (mol / m3)</p></li></ul><ul><li><p>POC_poc - Particulate organic carbon (mol / m3)</p></li></ul><ul><li><p>RRS_Rrs_412 - Remote sensing reflectance at 412 nm (sr-1)</p></li></ul><ul><li><p>RRS_Rrs_443 - Remote sensing reflectance at 443 nm (sr-1)</p></li></ul><ul><li><p>RRS_Rrs_469 - Remote sensing reflectance at 469 nm (sr-1)</p></li></ul><ul><li><p>RRS_Rrs_488 - Remote sensing reflectance at 488 nm (sr-1)</p></li></ul><ul><li><p>RRS_Rrs_531 - Remote sensing reflectance at 531 nm (sr-1)</p></li></ul><ul><li><p>RRS_Rrs_547 - Remote sensing reflectance at 547 nm (sr-1)</p></li></ul><ul><li><p>RRS_Rrs_555 - Remote sensing reflectance at 555 nm (sr-1)</p></li></ul><ul><li><p>RRS_Rrs_645 - Remote sensing reflectance at 645 nm (sr-1)</p></li></ul><ul><li><p>RRS_Rrs_667 - Remote sensing reflectance at 667 nm (sr-1)</p></li></ul><ul><li><p>RRS_Rrs_678 - Remote sensing reflectance at 678 nm (sr-1)</p></li></ul><ul><li><p>RRS_angstrom - Angstrom coefficient</p></li></ul><ul><li><p>RRS_aot_869 - Aerosol optical thickness at 869 nm</p></li></ul><p><b>Aqua MODIS - Evaluation Products:</b></p><ul><li><p>GSM_adg_443_gsm - Absorption due to gelbstof and detritus at 443 nm (GSM) (m-1)</p></li></ul><ul><li><p>GSM_bbp_443_gsm - Particulate backscatter at 443 nm (GSM) (m-1)</p></li></ul><ul><li><p>GSM_chl_gsm - Chlorophyll-a concentration (GSM) (mg m-3)</p></li></ul><ul><li><p>KDLEE_Kd_412_lee - Diffuse attenuation at 412 nm (Lee) (m-1)</p></li></ul><ul><li><p>KDLEE_Kd_443_lee - Diffuse attenuation at 443 nm (Lee) (m-1)</p></li></ul><ul><li><p>KDLEE_Kd_488_lee - Diffuse attenuation at 488 nm (Lee) (m-1)</p></li></ul><ul><li><p>KDLEE_Zeu_lee - Euphotic depth (Lee) (m)</p></li></ul><ul><li><p>QAA_a_443_qaa - Total absorption at 443 nm (QAA) (m-1)</p></li></ul><ul><li><p>QAA_adg_443_qaa - Absorption due to gelbstof and detritus at 443 nm (QAA) (m-1)</p></li></ul><ul><li><p>QAA_aph_443_qaa - Absorption due to phytoplankton at 443 nm (QAA) (m-1)</p></li></ul><ul><li><p>QAA_bbp_443_qaa - Particulate backscatter at 443 nm (QAA) (m-1)</p></li></ul><ul><li><p>ZEU_KPAR - Diffuse attenuation coefficient for PAR (KPAR, Morel) (m-1)</p></li></ul><ul><li><p>ZEU_ZEUL - Euphotic depth (Lee) (m)</p></li></ul><ul><li><p>ZEU_ZEUM - Euphotic depth (Morel) (m)</p></li></ul><p><b>Aqua MODIS - Test Products:</b></p><ul><li><p>GIOP01_a_443_giop - Total absorption at 443 nm (m-1)</p></li></ul><ul><li><p>GIOP01_a_547_giop - Total absorption at 547 nm (m-1)</p></li></ul><ul><li><p>GIOP01_adg_443_giop - Absorption due to gelbstof and detritus at 443 nm (m-1)</p></li></ul><ul><li><p>GIOP01_adg_s_giop - Spectral slope for gelbstof and detrital absorption</p></li></ul><ul><li><p>GIOP01_aph_443_giop - Absorption due to phytoplankton at 443 nm (m-1)</p></li></ul><ul><li><p>GIOP01_aph_547_giop - Absorption due to phytoplankton at 547 nm (m-1)</p></li></ul><ul><li><p>GIOP01_bb_443_giop - Total backscatter at 443 nm (m-1)</p></li></ul><ul><li><p>GIOP01_bb_547_giop - Total backscatter at 547 nm (m-1)</p></li></ul><ul><li><p>GIOP01_bbp_443_giop - Particulate backscatter at 443 nm (m-1)</p></li></ul><ul><li><p>GIOP01_bbp_s_giop - Spectral slope for particulate backscatter</p></li></ul><ul><li><p>GIOP01_chl_giop - Chlorophyll-a concentration (mg m-3)</p></li></ul><ul><li><p>GIOP01_rrsdiff_giop - Relative remote sensing reflectance difference</p></li></ul><p><b>CZCS - Standard Products:</b></p><p>CZCS products are available at both 9 km and 4 km resolution.</p><ul><li><p>A520 - Aongstrom coefficient, 520 to 865 nm</p></li></ul><ul><li><p>CHLO - Chlorophyll-a concentration (mg / m3)</p></li></ul><ul><li><p>L550 - Normalized water-leaving radiance at 550 nm (mW / cm2 / um /sr)</p></li></ul><ul><li><p>T790 - Aerosol optical thickness at 670 nm</p></li></ul><p><b>OCTS - Standard Products:</b></p><p>OCTS products are available at only at 9 km resolution.</p><ul><li><p>CHL_chlor_a - Chlorophyll-a concentration (mg m-3)</p></li></ul><ul><li><p>KD490_Kd_490 - Diffuse attenuation coefficient at 490 nm (m-1)</p></li></ul><ul><li><p>PIC_pic - Particulate inorganic carbon (mol / m3)</p></li></ul><ul><li><p>RRS_Rrs_412 - Remote sensing reflectance at 412 nm (sr-1)</p></li></ul><ul><li><p>RRS_Rrs_443 - Remote sensing reflectance at 443 nm (sr-1)</p></li></ul><ul><li><p>RRS_Rrs_490 - Remote sensing reflectance at 490 nm (sr-1)</p></li></ul><ul><li><p>RRS_Rrs_516 - Remote sensing reflectance at 416 nm (sr-1)</p></li></ul><ul><li><p>RRS_Rrs_565 - Remote sensing reflectance at 565 nm (sr-1)</p></li></ul><ul><li><p>RRS_Rrs_667 - Remote sensing reflectance at 667 nm (sr-1)</p></li></ul><ul><li><p>RRS_angstrom - Angstrom coefficient</p></li></ul><ul><li><p>RRS_aot_862 - Aerosol optical thickness at 862 nm</p></li></ul><p><b>SeaWiFS - Standard Products:</b></p><p>All SeaWiFS products are available only at 9 km resolution, except for
271LAND_NDVI, which is also available at 4 km.</p><ul><li><p>CDOM_cdom_index - Chromorphic dissolved organic matter index</p></li></ul><ul><li><p>CHL_chlor_a - Chlorophyll-a concentration (mg m-3)</p></li></ul><ul><li><p>KD490_Kd_490 - Diffuse attenuation coefficient at 490 nm (m-1)</p></li></ul><ul><li><p>LAND_NDVI - Normalized difference vegetation index</p></li></ul><ul><li><p>PAR_par - Photosynthetically available radiation (Einstein / m2 / day)</p></li></ul><ul><li><p>PIC_pic - Particulate inorganic carbon (mol / m3)</p></li></ul><ul><li><p>POC_poc - Particulate organic carbon (mol / m3)</p></li></ul><ul><li><p>RRS_Rrs_412 - Remote sensing reflectance at 412 nm (sr-1)</p></li></ul><ul><li><p>RRS_Rrs_443 - Remote sensing reflectance at 443 nm (sr-1)</p></li></ul><ul><li><p>RRS_Rrs_490 - Remote sensing reflectance at 490 nm (sr-1)</p></li></ul><ul><li><p>RRS_Rrs_510 - Remote sensing reflectance at 410 nm (sr-1)</p></li></ul><ul><li><p>RRS_Rrs_555 - Remote sensing reflectance at 555 nm (sr-1)</p></li></ul><ul><li><p>RRS_Rrs_670 - Remote sensing reflectance at 670 nm (sr-1)</p></li></ul><ul><li><p>RRS_angstrom - Angstrom coefficient</p></li></ul><ul><li><p>RRS_aot_865 - Aerosol optical thickness at 865 nm</p></li></ul><p><b>SeaWiFS - Evaluation Products:</b></p><ul><li><p>GSM_adg_443_gsm - Absorption due to gelbstof and detritus at 443 nm (GSM) (m-1)</p></li></ul><ul><li><p>GSM_bbp_443_gsm - Particulate backscatter at 443 nm (GSM) (m-1)</p></li></ul><ul><li><p>GSM_chl_gsm - Chlorophyll-a concentration (GSM) (mg m-3)</p></li></ul><ul><li><p>KDLEE_Kd_412_lee - Diffuse attenuation at 412 nm (Lee) (m-1)</p></li></ul><ul><li><p>KDLEE_Kd_443_lee - Diffuse attenuation at 443 nm (Lee) (m-1)</p></li></ul><ul><li><p>KDLEE_Kd_490_lee - Diffuse attenuation at 490 nm (Lee) (m-1)</p></li></ul><ul><li><p>KDLEE_Zeu_lee - Euphotic depth (Lee) (m)</p></li></ul><ul><li><p>QAA_a_443_qaa - Total absorption at 443 nm (QAA) (m-1)</p></li></ul><ul><li><p>QAA_adg_443_qaa - Absorption due to gelbstof and detritus at 443 nm (QAA) (m-1)</p></li></ul><ul><li><p>QAA_aph_443_qaa - Absorption due to phytoplankton at 443 nm (QAA) (m-1)</p></li></ul><ul><li><p>QAA_bbp_443_qaa - Particulate backscatter at 443 nm (QAA) (m-1)</p></li></ul><p><b>SeaWiFS - Test Products:</b></p><ul><li><p>GIOP01_a_443_giop - Total absorption at 443 nm (m-1)</p></li></ul><ul><li><p>GIOP01_a_555_giop - Total absorption at 555 nm (m-1)</p></li></ul><ul><li><p>GIOP01_adg_443_giop - Absorption due to gelbstof and detritus at 443 nm (m-1)</p></li></ul><ul><li><p>GIOP01_adg_s_giop - Spectral slope for gelbstof and detrital absorption</p></li></ul><ul><li><p>GIOP01_aph_443_giop - Absorption due to phytoplankton at 443 nm (m-1)</p></li></ul><ul><li><p>GIOP01_aph_555_giop - Absorption due to phytoplankton at 555 nm (m-1)</p></li></ul><ul><li><p>GIOP01_bb_443_giop - Total backscatter at 443 nm (m-1)</p></li></ul><ul><li><p>GIOP01_bb_555_giop - Total backscatter at 555 nm (m-1)</p></li></ul><ul><li><p>GIOP01_bbp_443_giop - Particulate backscatter at 443 nm (m-1)</p></li></ul><ul><li><p>GIOP01_bbp_s_giop - Spectral slope for particulate backscatter</p></li></ul><ul><li><p>GIOP01_chl_giop - Chlorophyll-a concentration (mg m-3)</p></li></ul><ul><li><p>GIOP01_rrsdiff_giop - Relative remote sensing reflectance difference</p></li></ul></td></tr><tr><td class="info">Point features (Required) </td><td class="info" align="left"><p>Points at which values should be interpolated.</p><p>OceanColor images use a geographic coordinate system with the WGS 1984
272datum. It is recommended but not required that the points use the same
273coordinate system. If they do not, this tool will attempt to project
274the points to the OceanColor coordinate system prior to doing the
275interpolation. This may fail if a datum transformation is required, in
276which case you will have to manually project the points to the
277OceanColor coordinate system before using this tool.</p></td></tr><tr><td class="info">Field to receive the interpolated values (Required) </td><td class="info" align="left"><p>Field of the points to receive the interpolated values.</p><p>The field must have a floating-point or integer data type. If the
278field cannot represent the interpolated value at full precision, the
279closest approximation will be stored and a warning will be issued.
280This will happen, for example, when you interpolate values into an
281integer field.</p></td></tr><tr><td class="info">Date field (Required) </td><td class="info" align="left"><p>Field of the points that specifies the date and time of the point.</p><p>The field must have a date or datetime data type. If the field can
282only represent dates with no time component, the time will assumed to
283be 00:00:00.</p></td></tr><tr><td class="info">Interpolation method (Optional) </td><td class="info" align="left"><p>Interpolation method to use, one of:</p><ul><li><p>Nearest - nearest neighbor interpolation. The interpolated value
284will simply be the value of the cell that contains the point. This
285is the default.</p></li></ul><ul><li><p>Linear - linear interpolation (also known as trilinear
286interpolation). This method averages the values of the eight nearest
287cells in the x, y, and time dimensions, weighting the contribution
288of each cell by the area of it that would be covered by a
289hypothetical cell centered on the point being interpolated. If the
290cell containing the point contains NoData, the result is NoData. If
291any of the other seven cells contain NoData, they are omitted from
292the average, and the result is based on the weighted average of the
293cells that do contain data. This is the same algorithm implemented
294by the ArcGIS Spatial Analyst's Extract Values to Points tool.</p></li></ul></td></tr><tr><td class="info">Cache directory (Optional) </td><td class="info" align="left"><p>Directory for caching local copies of downloaded files. A cache
295directory is optional but highly recommended if you plan to repeatedly
296access data for the same range of dates.</p><p>NASA partitions ocean color data into collections of compressed HDF
297files according to the sensor, temporal resolution, spatial
298resolution, product code, and date. These files have global spatial
299extent and typically range from 5 to 70 MB in size. Thus, even if you
300are only interested in a small region of the planet--even just a
301single point location--this tool must still download a global file
302each time slice that is needed. This can take a long time if many
303files are needed.</p><p>When this tool needs a file, it will first check the cache directory
304to see if the file was downloaded and cached during a prior run. If it
305was, data will be read directly from that file. If not, the file will
306be downloaded, decompressed, and stored in the cache directory for
307later use.</p><p>If you use a cache directory, be aware of these common pitfalls:</p><ul><li><p>The caching algorithm permits the directory to grow to infinite size
308and never deletes any cached files. If you access a large number of
309files (e.g. 10 years of daily images) they will all be added to the
310cache. Be careful that you do not fill up your hard disk. To
311mitigate this, manually delete the entire cache or specific files
312within it when they are no longer needed.</p></li></ul><ul><li><p>The caching algorithm stores uncompressed files so that they may be
313accessed quickly, without incuring a decompression step every time
314they are needed. To save space on your hard disk, we highly
315recommend you enable compression of the cache directory by the
316operating system. In Windows Explorer, right click on the directory,
317select Properties, click Advanced, and enable "Compress contents to
318save disk space".</p></li></ul><ul><li><p>Due to limitations in the caching algorithm, it cannot detect when
319NASA reprocesses data products and replaces files on the server with
320updated versions, thereby making the cached files obsolete. Thus, if
321NASA republishes a product with improved data values, the caching
322algorithm will continue to use the old, obsolete values. To mitigate
323this, you should monitor when NASA reprocesses their products and
324delete the cached files when they become obsolete.</p></li></ul></td></tr><tr><td class="info">Where clause (Optional) </td><td class="info" align="left"><p>SQL WHERE clause expression that specifies the subset of points to
325use. If this parameter is not provided, all of the points will be
326used.</p><p>The exact syntax of this expression depends on the type of feature
327class you're using. ESRI recommends you reference fields using the
328following syntax:</p><ul><li><p>For shapefiles, ArcInfo coverages, or feature classes stored in file
329geodatabases, ArcSDE geodatabases, or ArcIMS, enclose field names in
330double quotes: "MY_FIELD"</p></li></ul><ul><li><p>For feature classes stored in personal geodatabases, enclose field
331names in square brackets: [MY_FIELD].</p></li></ul></td></tr><tr><td class="info">Value to use when the interpolated value is NoData (Optional) </td><td class="info" align="left"><p>Value to use when the interpolated value is NoData.</p><p>If a value is not provided for this parameter, a database NULL value
332will be stored in the field when the interpolated value is NoData. If
333the field cannot store NULL values, as is the case with shapefiles,
334the value -9999 will be used.</p></td></tr><tr><td class="info">Timeout value (Optional) </td><td class="info" align="left"><p>Number of seconds to wait for the server to respond before failing
335with a timeout error.</p><p>If you also provide a Maximum Retry Time and it is larger than the
336timeout value, the failed request will be retried automatically (with
337the same timout value) until it succeeds or the Maximum Retry Time has
338elapsed.</p><p>If you receive a timeout error you should investigate the server to
339determine if it is malfunctioning or just slow. Check the OceanColor
340website to see if NASA has posted a notice about the problem, or
341contact the NASA directly. If the server just slow, increase the
342timeout value to a larger number, to give the server more time to
343respond.</p></td></tr><tr><td class="info">Maximum retry time (Optional) </td><td class="info" align="left"><p>Number of seconds to retry requests to the server before giving
344up.</p><p>Use this parameter to cope with transient failures. For example, you
345may find that the server is rebooted nightly during a maintenance
346cycle. If you start a long running operation and want it to run
347overnight without failing, set the maximum retry time to a duration
348that is longer than the time that the server is offline during the
349maintenance cycle.</p><p>To maximize performance while minimizing load during failure
350situations, retries are scheduled with progressive delays:</p><ul><li><p>The first retry is issued immediately.</p></li></ul><ul><li><p>Then, so long as fewer than 10 seconds have elapsed since the
351original request was issued, retries are issued every second.</p></li></ul><ul><li><p>After that, retries are issued every 30 seconds until the maximum
352retry time is reached or the request succeeds.</p></li></ul></td></tr><tr><td class="info">Order by fields (Optional) </td><td class="info" align="left"><p>Fields for defining the order in which the points are processed.</p><p>The points may be processed faster if they are ordered
353spatiotemporally, such that points that are close in space and time
354are processed sequentially. Ordering the points this way increases the
355probability that the value of a given point can be interpolated from
356data that is cached in memory, rather than from data that must be read
357from the disk or network, which is much slower. Choose fields that
358faciliate this. For example, if your points represent the locations of
359animals tracked by satellite telemetry, order the processing first by
360the animal ID and then by the transmission date or number.</p><p>If you omit this parameter, the Date Field will be used automatically.</p><p>This parameter requires ArcGIS 9.2 or later.</p></td></tr><tr><td class="info">Number of blocks of data to cache in memory (Optional) </td><td class="info" align="left"><p>Maximum number of blocks of data to cache in memory.</p><p>To minimize the number of times that the disk or network must be
361accessed, this tool employs a simple caching strategy, in addition to
362disk caching described by the Cache Directory parameter. When it
363processes the first point, it reads a square block of cells centered
364on that point and caches it in memory. When it processes the second
365and subsequent points, it first checks whether the cells needed for
366that point are contained by the block cached in memory. If so, it
367processes that point using the in-memory block, rather than reading
368from disk or the network again. If not, it reads another square block
369centered on that point and adds it to the cache.</p><p>The tool processes the remaining points, adding additional blocks to
370the cache, as needed. To prevent the cache from exhausing all memory,
371it is only permitted to grow to the size specified by this parameter.
372When the cache is full but a new block is needed, the oldest block is
373discarded to make room for the newest block.</p><p>The maximum size of the cache in bytes may be calculated by
374multiplying this parameter by 4 and by the block size parameters. For
375example, if this parameter is 128 and the blocks are x=32 by y=32 by
376t=2, the maximum size of the cache is 1048576 bytes (1 MB).</p><p>If this parameter is 0, no blocks will be cached in memory.</p></td></tr><tr><td class="info">In-memory cache block size, in X direction (Optional) </td><td class="info" align="left"><p>Size of the blocks of data to cache in memory, in the x direction
377(longitude). The size is given as the number of cells.</p><p>If this parameter is 0, no blocks will be cached in memory.</p></td></tr><tr><td class="info">In-memory cache block size, in Y direction (Optional) </td><td class="info" align="left"><p>Size of the blocks of data to cache in memory, in the y direction
378(latitude). The size is given as the number of cells.</p><p>If this parameter is 0, no blocks will be cached in memory.</p></td></tr><tr><td class="info">In-memory cache block size, in T direction (Optional) </td><td class="info" align="left"><p>Size of the blocks of data to cache in memory, in the t direction
379(time). The size is given as the number of cells.</p><p>If this parameter is 0, no blocks will be cached in memory.</p></td></tr></tbody></table></div></body></html>
Note: See TracBrowser for help on using the browser.