TDS Services

Available Services

The THREDDS Data Server (TDS) supports a variety of web services. Each of the available services are listed below with some configuration details.

Since the TDS provides data access services at predefined URL base paths, services whose access is listed as a THREDDS Catalog service element must use the exact values listed below for the serviceType and service base URL. The value of the service name attribute, on the other hand, is completely configurable. (See below for more details.)

Notes:

Server Information Services

Name TDS Configuration Description
Server Information (HTML)
Basic Configuration
Default Availability Enabled
Access Point /thredds/serverInfo.html
Provide human and machine readable access to information about the server installation. E.g., an abstract and a list of keywords summarizing the services and data available on the server, contact information and other information about the group hosting the server, and the version of the THREDDS Data Server (TDS) running.
Server Information (XML)
Basic Configuration
Default Availability Enabled
Access Point /thredds/serverInfo.xml
Server Version Information (Text)
Basic Configuration
Default Availability Enabled
Access Point /thredds/serverVersion.txt

Catalog Services

Name TDS Configuration Description
THREDDS Catalog Services
Basic Configuration
Default Availability Enabled
Access Point /thredds/catalog.{xml|html}
/thredds/catalog/*/catalog.{xml|html}
/thredds/*/*.{xml|html}
Provide subsetting and HTML conversion services for THREDDS catalogs. Catalogs served by the TDS can be subset and/or viewed as HTML. Remote catalogs, if allowed/enabled, can be validated, displayed as HTML, or subset.
  • More details are available here.
  • Services for remote catalogs can be enabled with the TDS Configuration File (threddsConfig.xml).
Remote THREDDS Catalog Service
Basic Configuration
Default Availability Disabled
Access Point /thredds/remoteCatalogService

Metadata Services

Name TDS Configuration Description
ISO
Basic Configuration
Default Availability Disabled
Access Point /thredds/iso/*
Catalog Service Configuration
(exact values required)
Service Type ISO
Service Base URL /thredds/iso/
Provide ISO 19115 metadata representation of a dataset's structure and metadata
NCML
Basic Configuration
Default Availability Disabled
Access Point /thredds/ncml/*
Catalog Service Configuration
(exact values required)
Service Type NCML
Service Base URL /thredds/ncml/
Provide NCML representation of a dataset
UDDC
Basic Configuration
Default Availability Disabled
Access Point /thredds/uddc/*
Catalog Service Configuration
(exact values required)
Service Type UDDC
Service Base URL /thredds/uddc/
Provide an evaluation of how well the metadata contained in a dataset conforms to the NetCDF Attribute Convention for Data Discovery (NACDD)

Data Access Services

Name TDS Configuration Description
OPeNDAP DAP2
Basic Configuration
Default Availability Enabled
Access Point /thredds/dodsC/*
Catalog Service Configuration
(exact values required)
Service Type OPeNDAP
Service Base URL /thredds/dodsC/
OPeNDAP DAP2 data access protocol.
  • Several configuration options are available (details).
NetCDF Subset Service
Basic Configuration
Default Availability Disabled
Access Point /thredds/ncss/*
Catalog Service Configuration
(exact values required)
Service Type NetcdfSubset
Service Base URL /thredds/ncss/
NetCDF Subset Service: a data access protocol.
  • More details are available here.
  • Enable NCSS and set other configuration options with the TDS Configuration File (threddsConfig.xml). More setup and configuration details are available here.
CDM Remote
Basic Configuration
Default Availability Disabled
Access Point /thredds/cdmremote/*
Catalog Service Configuration
(exact values required)
Service Type cdmremote
Service Base URL /thredds/cdmremote/
cdmremote/ncstream data access service. This service is disabled by default. It is automatically enabled when an appropriate FeatureCollection is used.
  • More details are available here.
OGC Web Coverage Service (WCS)
Basic Configuration
Default Availability Disabled
Access Point /thredds/wcs/*
Catalog Service Configuration
(exact values required)
Service Type WCS
Service Base URL /thredds/wcs/
OGC WCS supports access to geospatial data as "coverages".
  • More details about the OGC WCS are available here.
  • Enable OGC WCS and set other configuration options with the TDS Configuration File (threddsConfig.xml). More setup, configuration, and implementation details for the TDS's OGC WCS implementation are available here.
OGC Web Map Service (WMS)
Basic Configuration
Default Availability Disabled
Access Point /thredds/wms/*
Catalog Service Configuration
(exact values required)
Service Type WMS
Service Base URL /thredds/wms/
OGC WMS supports access to georegistered map images from geoscience datasets.
  • More details about the OGC WMS are available here.
  • Enable OGC WMS and set other configuration options with the TDS Configuration File (threddsConfig.xml). More setup, configuration, and implementation details for the TDS's OGC WMS implementation are available here. Including a link to configuration information for the underlying WMS implementation (ncWMS: "Detailed ncWMS Configuration")
HTTP File Download
Basic Configuration
Default Availability Disabled
Access Point /thredds/fileServer/*
Catalog Service Configuration
(exact values required)
Service Type HTTPServer
Service Base URL /thredds/fileServer/
HTTP File Download (HTTP byte ranges are supported)
  • Files accessed through the HTTP file download have their file handles cached by default. Configuration settings for this caching can be set with the TDS Configuration File (threddsConfig.xml).
OGC Sensor Observation Service (SOS)
Basic Configuration
Default Availability Disabled
Access Point /thredds/sos/*
Catalog Service Configuration
(exact values required)
Service Type Sensor Observation Service (SOS)
Service Base URL /thredds/sos/
Sensor Observation Service
  • The SOS standard is applicable to use cases in which sensor data needs to be managed in an interoperable way. For more information, see the OGC SOS page, or the ncSOS wiki, maintained by the developers of the ncSOS plugin, Applied Science Associates.

TDS Requirements for THREDDS Catalog service Elements

Since the TDS provides data access services at predefined URL base paths, services whose access is listed as a THREDDS Catalog service element:

Examples of All Individual Services

Note: The required serviceType and base values are shown in bold.

OPeNDAP

<service name="odap" serviceType="OPeNDAP" base="/thredds/dodsC/"/>

NetCDF Subset Service

<service name="ncss" serviceType="NetcdfSubset" base="/thredds/ncss/"/>

WCS

 <service name="wcs" serviceType="WCS" base="/thredds/wcs/"/>

WMS

 <service name="wms" serviceType="WMS" base="/thredds/wms/" />

HTTP Bulk File Service

<service name="fileServer" serviceType="HTTPServer" base="/thredds/fileServer/" />

ncISO

<service name="iso" serviceType="ISO" base="/thredds/iso/" />
<service name="ncml" serviceType="NCML" base="/thredds/ncml/" />
<service name="uddc" serviceType="UDDC" base="/thredds/uddc/" />

SOS

<service name="sos" serviceType="SOS" base="/thredds/sos/" />

Example compound service Element

<service name="all" serviceType="Compound" base="">
    <service name="HTTPServer" serviceType="HTTPServer" base="/thredds/fileServer/"/>
    <service name="opendap" serviceType="OPENDAP" base="/thredds/dodsC/"/>
    <service name="ncss" serviceType="NetcdfSubset" base="/thredds/ncss/"/>
    <service name="cdmremote" serviceType="CdmRemote" base="/thredds/cdmremote/"/>

    <service name="wcs" serviceType="WCS" base="/thredds/wcs/"/>
    <service name="wms" serviceType="WMS" base="/thredds/wms/"/>

    <service name="iso" serviceType="ISO" base="/thredds/iso/"/>
    <service name="ncml" serviceType="NCML" base="/thredds/ncml/"/>
    <service name="uddc" serviceType="UDDC" base="/thredds/uddc/"/>

    <service name="sos" serviceType="SOS" base="/thredds/sos/"/>

  </service>
THREDDS This document is maintained by Unidata. Send comments to THREDDS support.