An official website of the United States government.

We've made some changes to EPA.gov. If the information you are looking for is not here, you may be able to find it on the EPA Web Archive or the January 19, 2017 Web Snapshot.

HMS: Hydrologic Micro Services

HMS Help


If you wish to make a comment or suggestion please use the contact us form here: Submit a comment


Frequently Asked Questions

What is HMS?

Hydrologic Micro Services, HMS, is a watershed modeling system comprised of data provisioning and modeling components and workflows to facilitate environmental modeling.

How can I use the HMS?

The components can be accessed through the web interface or directly through the web API, desktop libraries Exit, request details are provided through the Swagger OpenAPI Documentation.

How do I use the HMS web interface?

All HMS component and workflow web pages have a consistent presentation structure consisting of four pages: Overview, Data Request, Output Data, and Data Algorithms.

The Overview page has five panels: Description panel with a brief description of the component/workflow, Input Parameters panel with details of the input parameters on the Data Request page, Output Parameters with a brief description of output objects produced by the component/workflow, Web Service Details panel with link to the swagger OpenAPI documentation, and Code Samples panel with links to web services sample client codes.

Data Request page has the web form where the user can enter values of input parameters and run the component/workflow. When the user submits a request for a previously submitted task, by the task ID, the user will be directed to the Output Data page showing the data for the specified task ID provided by HMS. The user has the option of waiting on the Output Data page until the task finishes and the outputs are shown. The other option for the user is to copy the Task ID and leave the page and come back later and click on the Data Request page where outputs can be retrieved by entering the task ID.

Data Algorithms page provides details about the algorithms and sources of data related to the component/workflow.

Who are the intended users for HMS?

The target users are hydrological and water quality modelers and analysts.

Can I build my own custom workflow within the HMS website?

HMS users can use the system components and workflows directly or build their own workflows by linking the components. Workflows can be either desktop or web-based applications outside HMS web site. Workflows on HMS web site are simple and mostly serve the purpose of demonstration. Only HMS web site developers can build workflows on HMS web site.

What is Constant Volume algorithm in stream flow hydrology?

Constant Volume stream flow hydrology assumes that the volume in the stream remains constant i.e. flow-in=flow-out. More details are available in Flow Routing Techniques for Environmental Modeling.