-
Notifications
You must be signed in to change notification settings - Fork 18
add docs for DANDI hub #95
New issue
Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.
By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.
Already on GitHub? Sign in to your account
Changes from all commits
9402f8e
e67b2cc
f03a22f
e75658b
d1db03d
7daa32e
9756ff3
551cbac
e4ea76c
d50b480
7a67a14
ca4f064
35917e1
File filter
Filter by extension
Conversations
Jump to
Diff view
Diff view
There are no files selected for viewing
| Original file line number | Diff line number | Diff line change |
|---|---|---|
| @@ -0,0 +1,28 @@ | ||
| # Using the DANDI Hub | ||
|
|
||
| [DANDI Hub](http://hub.dandiarchive.org) is a [JupyterHub](https://jupyterhub.readthedocs.io) instance in the cloud to interact with the data stored in DANDI, and is free to use for exploratory analysis of data on DANDI. | ||
| For instructions on how to navigate JupyterHub see this [YouTube tutorial](https://www.youtube.com/watch?v=5pf0_bpNbkw&t=09m20s). | ||
| Note that DANDI Hub is not intended for significant computation, but provides a place to introspect Dandisets and to perform some analysis and visualization of data. | ||
|
|
||
| ## Registration | ||
|
|
||
| To use the [DANDI Hub](http://hub.dandiarchive.org), you must first register for an account using the [DANDI website](http://dandiarchive.org). | ||
|
|
||
| ## Choosing a server option | ||
|
|
||
| When you start up the DANDI Hub, you will be asked to select across a number of server options. | ||
| For basic exploration, Tiny or Base would most likely be appropriate. | ||
| The DANDI Hub also currently offers Medium and Large options, which have more available memory and compute power. | ||
| The "T4 GPU inference" server comes with an associated T4 GPU, and is intended to be used for applications that require GPU for inference. | ||
| We request that users of this server be considerate of their usage of the DANDI Hub as a free community resource. | ||
| Training large deep neural networks is not appropriate. | ||
| A "Base (MATLAB)" server is also available, which provides a MATLAB cloud installation but you would be required to provide your own license. | ||
|
|
||
| ## Example notebooks | ||
|
|
||
| The best way to share analyses on DANDI data is through the DANDI example notebooks. | ||
bendichter marked this conversation as resolved.
Show resolved
Hide resolved
|
||
| These notebooks are maintained in the [dandi/example-notebooks](https://github.com/dandi/example-notebooks) repository which provides more information about their organization. | ||
| Dandiset contributors are encouraged to use these notebooks to demonstrate how to read, analyze, and visualize the data, and how to produce figures from associated scientific publications. | ||
|
Member
There was a problem hiding this comment. Choose a reason for hiding this commentThe reason will be displayed to describe this comment to others. Learn more. IMHO here it would be very valuable to show how to reference those from within dandiset metadata/meditor
Member
There was a problem hiding this comment. Choose a reason for hiding this commentThe reason will be displayed to describe this comment to others. Learn more. Hi @yarikoptic, would it be best to reference these notebooks in the
Member
There was a problem hiding this comment. Choose a reason for hiding this commentThe reason will be displayed to describe this comment to others. Learn more. here we are talking about hub... hub is particularly "good" for notebooks. I think it was a right call to mention them here (and may be elsewhere too).
Member
There was a problem hiding this comment. Choose a reason for hiding this commentThe reason will be displayed to describe this comment to others. Learn more. Hi @yarikoptic, sorry, I am confused regarding this suggestion. |
||
|
|
||
| Notebooks can be added and updated through a pull request to the [dandi/example-notebooks](https://github.com/dandi/example-notebooks) repository. | ||
| Once the pull request is merged, your contributed notebook will be available to all DANDI Hub users. | ||
Uh oh!
There was an error while loading. Please reload this page.