About HydroShare

What?

HydroShare is an online collaborative environment for sharing hydrologic data and models and aims at providing hydrologists the cyberinfrastructure needed to innovate and collaborate in research to solve water problems. HydroShare addresses the challenges of sharing hydrologic data and models by supporting collaboration and reproducible hydrologic science through the publication of hydrologic data and models. With HydroShare, users can:

  1. Share data and models with colleagues
  2. Manage who has access to shared content
  3. Share, access, visualize, and manipulate a broad set of hydrologic data types and models
  4. Use the web services API to program automated and client access
  5. Publish data and models to meet the requirements of research project data management plans
  6. Discover and access data and models published by others
  7. Use web apps to visualize, analyze, and run models on data in HydroShare.

Why?

The main goal of HydroShare is to facilitate creation, collaboration around, discovery and reproducibility of, and access to data and model resources shared by members of the Hydrology community. HydroShare aims to provide collaborative social functions for datasets and models, including both private and public sharing, formation of collaborative groups, and value-added annotation of digital content. Content that can be shared within HydroShare is diverse, including digital objects that represent multiple hydrologic data types, models and model instances, documents, and other content types commonly used in hydrologic research. These include hydrologic time series, geographic features (vector data), geographic rasters (gridded data), multidimensional space-time data sets (e.g., NetCDF), and composite resources that represent complex datasets such as river geometry. Model Programs and Model Instances are additional types of content that can be shared and manipulated within HydroShare.

How?

HydroShare is open source and being collaboratively developed with code in GitHub.  HydroShare is being developed using a combination of Python 2.7, Django 1.8, iRODS 4.1, and JetBrains PyCharm.   If you want to participate in code development join GitHub and email us (support at hydroshare.org) to request access to the code repository.  We are happy to consider code contributions from anyone but will generally ask you to demonstrate your coding ability and discuss your plans with us before giving you commit access to the GitHub repository.  Use the code from GitHub according to the terms of the New BSD Open Source license.

What is a Resource?

A “resource” is the discrete unit of digital content within HydroShare. Resources are social objects that can be created, modified, versioned, shared, annotated, discovered, and accessed. In this resource-centric approach, a resource is the granular unit used for management and access control within HydroShare. The following are properties of HydroShare resources:

  1. A resource may be made up of a single content file (e.g., in the case of a file containing a single hydrologic time series) or may be an aggregation of multiple content files (e.g., in the case of a hydrologic Model Instance with various input files necessary for its execution).
  2. A resource containing multiple content files may have a hierarchical file/directory structure.
  3. A resource may conform to a standardized content data model that is specific to a particular resource type and may define specific file formats, syntax, and/or file hierarchies.
  4. A resource is described by resource-level metadata that detail its properties. Resource-level metadata may contain extensions that are specific to a particular resource type.
  5. Each content file within a resource may be separately described by content-level metadata (e.g., a separate metadata document that describes a specific file or group of files within a resource).