Dataset Publication#

For this tutorial, we’ll be adapting the previous Multi-Session Tutorial to publish our data to the DANDI Archive.

Note

Creating an account on DANDI requires approval from the archive administrators. Separate approval is required for both the main archive and the staging server.

This tutorial requires an account on the DANDI staging server. You’ll want to publish your real data on the main archive, which will require a separate approval but otherwise follows the same workflow defined in this tutorial.

Once your account is approved, you can move on to the next steps.

Workflow Setup#

  1. Resume the conversion via the Convert page

  2. Navigate to the Workflow page using the navigation sidebar on the left.

    1. Specify that you’d like to publish your data to the DANDI Archive.

  3. Navigate back to the Conversion Review page

You’ll now notice that the Exit Pipeline button has been replaced with Next, allowing you to move forward with publication on the DANDI Archive.

DANDI Upload#

You’ll need to specify your DANDI API keys if you haven’t uploaded from the GUIDE before. These keys are unique between the Main and Staging servers.

A pop-up asking for DANDI API keys

To get your API key, visit the staging website and click on the profile icon in the top-right corner. This will show a dropdown with a copy button, which will assign your API key to the clipboard.

DANDI staging API key added

Provide this for the Staging API Key value on the GUIDE.

DANDI staging API key added

Press the Submit button to save your API key. This will populate the Dandiset input with a list of Dandisets associated with your account, which you can search by title or ID.

But what if you don’t have any Dandisets to upload to? No problem!

Creating a Dandiset#

If you don’t already have a Dandiset on the Staging server, you can create one directly from the GUIDE.

Press the Create New Dandiset button to open a pop-up that guides you through the required fields for Dandiset creation.

Dandiset creation pop-up

Once this pop-up form is submitted, the Dandiset input will now contain your new Dandiset.

DANDI upload page with Dandiset ID specified

Finally, press the Upload button to begin the upload process.

Final Review#

Once your upload to the DANDI Archive is complete, you will be able to review a quick overview of the associated Dandiset and a list of the uploaded files from this pipeline.

DANDI upload review page

Congratulations on your first upload to the DANDI Archive from the GUIDE!