Skip to main content

HydroShare

HydroShare is a collaboration environment and repository for data, models, and other research products. Developed and maintained by the Consortium of Universities for the Advancement of Hydrologic Science, Inc. (CUAHSI), HydroShare is a file agnostic, general purpose repository for data, models, computational notebooks, and other content types that accepts upload of any file type. HydroShare allows users to publish data and other content and receive a citable Digital Object Identifier (DOI). Users can keep content files private, share individually with collaborators, make content public, or publish content permanently so that it can be easily cited. HydroShare users can also share their content with groups and communities, such as the CIROH Community, allowing for increased inter-group collaboration. Reach out to help@cuahsi.org for more information or see https://help.hydroshare.org/.

CIROH Portal

Software and Technologies​

HydroShare is an operational repository at https://www.hydroshare.org. HydroShare includes the following functionality:

  • A user-oriented web application for creation of "resources" within which you can share data, models, computational notebooks, and other content files.
  • A flexible, file-based data model for storing content created within HydroShare resources.
  • A REST application programming interface (API) for programmatic access to HydroShare resources. You can automate and code most everything through HydroShare's API that you can do through the web user interface.
  • A Python client package called "hsclient" that enables easier interaction with HydroShare's REST API
  • Ability to link to and launch computational notebooks, code, and content files into linked JupyterHub environments, including the CIROH JupyterHub, CUASHI JupyterHub, and CyberGIS JupyterHub.

Access​

Anyone can access HydroShare by navigating to https://www.hydroshare.org and creating a user account. All users are automatically allocated a 20GB quota for content within HydroShare, but if you need more space you can make a request to CUAHSI.

Open-Source Code Development​

HydroShare is an open source software development project, with repositories and source code available at https://github.com/hydroshare. HydroShare is developed as open-source software using the BSD 3-clause open source license.

Bugs and Issues​

Bugs, issues, and feature requests related to HydroShare can be reported via the main HydroShare GitHub repository at:

Development Team​

HydroShare is the work of many individuals and organizations who have contributed to its design and development over many years. For details, see https://github.com/orgs/hydroshare/people.

How to cite HydroShare​

The following citations should be used when citing HydroShare:

Tarboton, D. G., Ames, D. P., Horsburgh, J. S., Goodall, J. L., Couch, A., Hooper, R., Bales, J., Wang, S., Castronova, A., Seul, M., Idaszak, R., Li, Z., Dash, P., Black, S., Ramirez, M., Yi, H., Calloway, C., Cogswell, C. (2024). HydroShare Retrospective: A Review of Science and Technology Advances of a Comprehensive Data and Model Publication Environment for the Water Science Domain, Environmental Modelling & Software, 172, 105902, https://doi.org/10.1016/j.envsoft.2023.105902.

Horsburgh, J. S., M. M. Morsy, A. M. Castronova, J. L. Goodall, T. Gan, H. Yi, M. J. Stealey, and D. G. Tarboton (2016). HydroShare: Sharing diverse environmental data types and models as social objects with application to the hydrology domain, JAWRA Journal of the American Water Resources Association, 52(4), 873-889, https://doi.org/10.1111/1752-1688.12363.

Tarboton, D. G., R. Idaszak, J. S. Horsburgh, J. Heard, D. Ames, J. L. Goodall, L. Band, V. Merwade, A. Couch, J. Arrigo, R. Hooper, D. Valentine and D. Maidment (2014). HydroShare: Advancing Collaboration through Hydrologic Data and Model Sharing, in D. P. Ames, N. W. T. Quinn and A. E. Rizzoli (eds.), Proceedings of the 7th International Congress on Environmental Modelling and Software, San Diego, California, USA, International Environmental Modelling and Software Society (iEMSs), ISBN: 978-88-9035-744-2, https://scholarsarchive.byu.edu/iemssconference/2014/Stream-A/7/.