Contributing Data to the Data Exchange

So it is called a Data Exchange, so how do we actually "exchange" or contribute our own data?

In the near future, apps like Plux, the Riverscapes Viewer and QRiS will all have commands and options that automate the uploading of Riverscapes Projects to the Data Exchange.  For now (as of Winter 2024), this is an advanced feature available to users of the Data Exchange only from a Command Line currently.  

Riverscapes Project Wrappers

First off, it is important to understand that the Data Exchange only accepts data packaged in "Riverscapes Projects" and those have to be of a registered riverscape project type (available on home page of Data Exchange and in Search).

In the data exchange searching can be filtered by project type with the pull down or in advanced search:

It also shows up in the URL: e.g. https://data.riverscapes.net/s?type=Project&projectTypeId=brat filters for BRAT project types.

where the &projectTypeID= denotes the project type. 

 

Writing a Riverscapes Project around my Data

You can use the RSXML pip module to easily write Riverscapes Project wrappers around your datasets with Python.

How to upload Today with RSCLI

At some point, we may allow uploading of projects through a web interface, but because riverscapes projects are tricky to get right (hence RSXML pip module), this is a major development task.  It is far easier to write riverscapes projects from specific apps, models or tools. However, if you know how to properly write and format your own riverscapes projects, you can use the RSCLI - Riverscapes Command Line Interface.  You will need to have Node.js installed, but once that is installed you can upload projects. The RSCLI uses your RC Account credentials through OAuth to authorize your upload as a user. 

Once installed, use rscli upload -- help to see upload options.