Configuring the NetCDF Subset Service

---

Overview

The Netcdf Subset Service is one of the ways that the TDS can serve data. It is an experimental REST protocol for returning subsets of CDM datasets. Currently, only the service for Gridded Data is mature enough for other users to try. The service for Point Data is still under development, contact us if you are eager to try it on your datasets.

This documentation is for TDS administrators. If you are a client wanting to access data through the Netcdf Subset Service, look at NetCDF Subset Service Reference.

Enabling the Netcdf Subset Service in the TDS

1. In your configuration catalogs, you must define the service like this:

  <service name="subsetServer" serviceType="NetcdfSubset" base="/thredds/ncss/grid/" suffix="/dataset.html"/>

Then as usual, add the service to any datasets that you want served, eg:

    <dataset name="datasetName" ID="datasetID" urlPath="/my/urlPath"> 
       <serviceName>subsetServer</serviceName> 
    </dataset> 

Note that the name of the service ( subsetServer in this example) is arbitrary, but the serviceType and base must be exactly as shown. The suffix is currently needed to make the TDS web pages work correctly.

2. In the threddsConfig.xml file, enable the NetcdfSubsetService.

 

Restrictions on what files can be served

Only Gridded Data can be served, e.g. model data and non-swath sattelite data. The datasets must be in a format that the CDM can read. To check both of these, open your file in the NetCDF ToolsUI program, using the Grids Tab. Any fields identified as grids will show up in the top table. To be sure, go into the viewer (click to bring up the Viewer, then click again to show the data) and make sure the data is displayed correctly. If all that works, then the data should be served correctly by the TDS.

 

---

This document is maintained by John Caron and was last updated on Oct 5, 2007