TDS Tutorial: OGC/ISO Services (WCS, WMS, and ncISO)

Setting up WCS, WMS, and ncISO

Configure TDS to Allow WCS, WMS, and ncISO Access

Out of the box, the TDS distribution will have WCS, WMS, and ncISO disabled. They must be explicitly allowed in the threddsConfig.xml file. The default threddsConfig.xml file (which should now be in your ${TOMCAT_HOME}/content/thredds directory) contains commented out sections for each of these services.

WCS Configuration

To enable the WCS service for locally served datasets, you will need the following in your threddsConfig.xml file: 

<WCS>
  <allow>true</allow>
</WCS>

Additional WCS configuration options can be set in the threddsConfig.xml file, more details are available in the WCS section of the threddsConfig.xml file documentation.

WMS Configuration

To enable the WMS service for locally served datasets, you will need the following in your threddsConfig.xml file: 

<WMS>
  <allow>true</allow>
</WMS>

Additional WMS configuration options can be set in the threddsConfig.xml file, more details are available in the WMS section of the threddsConfig.xml file documentation.

ncISO Configuration

To enable the ncISO services for locally served datasets, you will need the following in your threddsConfig.xml file: 

<NCISO>
  <ncmlAllow>true</ncmlAllow>
  <uddcAllow>true</uddcAllow>
  <isoAllow>true</isoAllow>
</NCISO>

Each "*Allow" element allows one of the three ncISO services.

Adding WCS and WMS Services

Once the WCS and WMS services are enabled, all that is required for the TDS to provide WCS and WMS access to datasets is for those datasets to reference WCS and WMS service elements. Adding them to an existing compound service would look something like this: 

<service name="grid" serviceType="Compound" base="" >
    <service name="odap" serviceType="OpenDAP" base="/thredds/dodsC/" />
    <service name="wcs" serviceType="WCS" base="/thredds/wcs/" />
    <service name="wms" serviceType="WMS" base="/thredds/wms/" />
    <service name="ncss" serviceType="NetcdfSubset" base="/thredds/ncss/grid/" />
    <service name="http" serviceType="HTTPServer" base="/thredds/fileServer/" />
</service>

Adding ncISO Services

Similar to above, once the ncISO services are enabled, all that is required for the TDS to provide ncISO services on datasets is for those datasets to reference the ncISO service elements. For instance, adding to the same compound service as above: 

<service name="grid" serviceType="Compound" base="" >
    <service name="odap" serviceType="OpenDAP" base="/thredds/dodsC/" />
    <service name="wcs" serviceType="WCS" base="/thredds/wcs/" />
    <service name="wms" serviceType="WMS" base="/thredds/wms/" />
    <service name="ncss" serviceType="NetcdfSubset" base="/thredds/ncss/grid/" />
    <service name="http" serviceType="HTTPServer" base="/thredds/fileServer/" />
    <service name="ncml" serviceType="NCML" base="/thredds/ncml/" />
    <service name="uddc" serviceType="UDDC" base="/thredds/uddc/" />
    <service name="iso" serviceType="ISO" base="/thredds/iso/" />
</service>

Exercise: Setup WCS and WMS Access for NAM Data

  1. Edit the TDS configuration file and allow WCS and WMS services as discussed above 
    [thredds@workshop00 ~]$ cd ${TOMCAT_HOME}/content/thredds
[thredds@workshop00 ~]$ vi threddsConfig.xml
    and add/replace the WCS and WMS elements (as described above) 
    <WCS>
  <allow>true </allow>
</WCS>
<WMS>
  <allow>true </allow>
</WMS>
  2. Edit the catalog.xml file and add WCS and WMS services to the NAM dataset 
    <service name="wcs" serviceType="WCS" base="/thredds/wcs/" />
<service name="wms" serviceType="WMS" base="/thredds/wms/" />
  3. Restart Tomcat so the TDS is reinitialized: 
    [thredds@workshop00 ~]$ cd ${TOMCAT_HOME}/bin
[thredds@workshop00 ~]$ ./shutdown.sh
[thredds@workshop00 ~]$ ./startup.sh
  4. Test that WCS and WMS are working:
    1. Bring the catalog up in a browser: http://localhost:8080/thredds/catalog.html
    2. Click down to one of the NAM dataset pages.
    3. Select the WCS Access link
    4. Go back, select the WMS Access link
  5. Check Dataset Viewer Links for Godiva2

    ToolsUI and Godiva2 are there but IDV is not.

Adding "Grid" DataType to Datasets

Once datasets are accessible over the WMS and WCS services, a quick look at the dataset pages shows several "Viewer" links available for each dataset (ToolsUI and Godiva2). The IDV "Viewer" link is only added for datasets with a "Grid" data type. This is not whether the dataset is recognized by the CDM as gridded but rather if the metadata in the catalog indicates that the dataset is a "Grid". This is accomplished with the dataType metadata element: 

<dataType>Grid</dataType>

Exercise: Add "Grid" DataType to the NAM Data

  1. Edit the catalog.xml file and add a Grid dataType element (as above) to the NAM dataset.
  2. Restart Tomcat so the TDS is reinitialized: 
      [thredds@workshop00 ~]$ cd ${TOMCAT_HOME}/bin
  [thredds@workshop00 ~]$ ./shutdown.sh
  [thredds@workshop00 ~]$ ./startup.sh
  3. Check the dataset pages for the IDV Viewer link.

Using WCS and WMS

Godiva2 WMS Client

The Godiva2 WMS client is part of the ncWMS code base and as such is included in the TDS distribution. It is a web application written in JavaScript using the OpenLayers library.

In the TDS, you can access the Godiva2 client from the "Viewers" section of all WMS accessible datasets. The Godiva2 User Guide is available from the ncWMS site.

Godiva2

More WMS Configuration

Besides the basic WMS configuration available in the threddsConfig.xml file, there are additional configuration settings for default image styling in the wmsConfig.xml file. This additional configuration includes settings for the default values of color scale range, palette name, and number of color bands as well as whether to use a linear or logarithmic scale. These settings can be applied globally, by dataset, or by variable in a dataset, or to variables in any dataset by CF standard name.

Detailed information is available from the ncWMS/MyOcean WMS Detailed Configuration web page.

Exercise: Try Modifying the wmsConfig.xml File

  1. Open a NAM dataset in Godiva2 and plot a parameter.
  2. Notice the default color scale range is [-50,50]. Decide on a better color scale range.
  3. Open the " WMS Detailed Configuration" page in your browser.
  4. Edit the wmsConfig.xml file 
    [thredds@workshop00 ~]$ cd ${TOMCAT_HOME}/content/thredds
[thredds@workshop00 ~]$ vi wmsConfig.xml
    and change the color scale range for the target parameter in the NAM datasets.
  5. Reopen Godiva2 on another NAM dataset and plot the target parameter. Check the new default color scale range.

THREDDS This document is maintained by Unidata and was last updated Send comments to THREDDS support.