Contributing Custom Data to the Data Exchange

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

RC apps like the LTPBR Explorer, the Riverscapes Viewer and QRiS all have commands and options that automate the uploading of Riverscapes Projects to the Data Exchange.  Also, for advanced users we have a Command Line.  

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.