Data Exchange Description
The Water Quality Exchange (WQX) data flow allows Network Partners to share ambient water quality data with EPA. As the primary framework for sharing data at the national level and compiling data in the STORET Data Warehouse, WQX replaces the distributed STORET database. EPA stopped accepting submissions via the distributed STORET database in September 2009. For more information, visit WQX and STORET and review the WQX Success Story.
Version 1.0 of the WQX framework allowed Partners to share the following data types:
- Physical conditions at the time of a site visit;
- Chemical and bacteriological analyses of the water sampled; and
- Chemical analyses of fish tissue collected.
Versions 2.0 and 2.1 expanded the WQX framework to allow sharing of the following additional parameters:
- Taxon abundance data including population census, frequency class, group summaries, and individual results;
- Toxicity data;
- Habitat assessment scores and their related metrics; and
- Biological index scores and their related metrics.
Because many water monitoring programs use biological and habitat data as the basis for assessing water quality, WQX v2.0 and v2.1 enhance the richness of information available for data sharing, analysis, and improved decision making by watershed managers.
Version 2.1 of the WQX schema is backwards compatible with v2.0, and provides expanded data element lengths for various key description text type elements. See the schema change log and Data Exchange Template for more details. EPA accepts test and production submissions using WQX v1.0, v2.0, and v2.1.
The WQX data flow supports both node and node client submissions. It also provides a custom web-based client application called WQX Web. WQX Web allows users to submit flat file submissions such as text files or comma separated files (txt or csv files), that the tool then maps to the WQX schema for WQX XML file generation. WQX Web then acts as a web-client and submits the data through the WQX data flow. All users of WQX Web must access the tool in the CDX Web environment.
All data shared using the WQX framework can be accessed in the STORET Data Warehouse.
The Data Flow Implementation Guide provides a high-level overview of the data flow.
Partners sharing WQX data via a node or node client will need to acquire a Network Authentication Authorization Service (NAAS) Account as well as a WQX Organization ID. NAAS Accounts must be set up for both test and production environments. Please ask your organization’s Node Administrator to obtain a NAAS Account for test and production.
Once you have a NAAS Account, request a WQX Organization ID from the STORET Help Desk. The STORET Team will set up a WQX ORG ID that associates with your test or production NAAS Account. Contact the STORET Help Desk at storet [at] epa.gov or 800.424.9067. The STORET Help Desk will require the following:
- ORG ID (may be up to 30 characters long)
- Organization Name
- Contact Name
- Contact Email
- Date Needed
Partners submitting data through WQX will require a new WQX Organization ID that is unique from any previous STORET ORG IDs. This ensures that users do not duplicate data already within an Organization in the STORET Warehouse when submitting data through WQX.
Partners submitting data via WQX Web must sign up for a CDX Web account in order to access the tool. Note that a CDX Web account is different from a NAAS Account. Request a CDX Web account from the STORET Help Desk by email at storet [at] epa.gov or phone at 800.424.9067.
The WQX schema and supporting flow documentation have been approved for use on the Exchange Network.
- Flow Configuration Document
- Node 2.0 FCD Addendum
- This addendum describes how the WQX services must be implemented on a Specification v2.0-compliant node. It provides a set of rules for implementing the WQX v2.0 data exchange to a Specification v2.0-compliant node without changes to functionality.
- XML Schema
- Data Exchange Template
- Sample XML Instance Files