Once you know the properties of your data necessary to create a dataset, project, and channels for your images, as we did in the get metadata tutorial, you can head over to the administrative process to being getting your data into ndstore.
Once you've picked a database server to use (i.e. a deployment of ndstore), you should navigate to the login page in your web browser and make your account. For this demonstration, we have elected to use http://openconnecto.me/.
Once you create an account you will get a confirmation email to activate it. Then, return to the website and log-in.
Once you've logged in, you should see a banner near the top of your screen with two buttons: datasets, and projects. Click on "Datasets", and then "Create dataset".
You will then be brought to a new screen in which you will be prompted for a lot of metadata about your data (which you acquired in the previous tutorial). You should enter all of the values you've obtained and press submit when your form looks like the one below. When entering resolution, the value provided is interpretted in nanometers, so if your images are millimeter resolution (as our demo data is), you should enter 1000000. Note: if you are using the same server you will get an error stating that a dataset already exists with this name - that is because, understandably, the service cannot have two datasets with the same identifier.
Once your form is complete, click "Create Dataset," and you should be brought to the Datasets page which lists all existing datasets in this instance of ndstore. If you scroll down to kki2009_demo, you should see that your dataset now exists in the database.
Once you have successfully created a dataset, you need to create a project upon it. You can think of a dataset as the "space" which an experiment took place in, and the project as an observation of an experiment in that space (somewhat akin in nature to probability, in which you have a random variables drawn from a sample space). On the top bar you should now click on the "Project" and then "Create project" buttons.
You should now see a form which prompts you to enter more information, this time about your specific project. You should select the dataset you defined earlier, and pick a descriptive name (with no spaces) for your project. In the previous section we looked at data from the kki2009_demo dataset, and in particular the subject 113_1, so we will use that as our project title. Unless you've been in contact with the administrator of your particular ndstore instance providing different instructions, you should leave the remaining dropdown menus at their default values. You want to tick the box providing you a default token, as that saves you a step later on when trying to access your data. Once you've completed filling out the form you should again see a form like that below.
You can now click "Create New Project" and will be redirected to the project page, where you can scroll down and find your newly created project under your previously created dataset.
In order to upload data to this project you need to create channels for it. For instance, if you have raw images and annotations, you would create two channels - one for each - each with properties specific with the to the data being represented. Here, we only have raw data, so we will create a single channel. To do this, click on the "Channels" button you see in the project window represented above.
You will be redirected to a page where you can see that no channels currently exist, but you are invited to create one. Click the "Add Channel" button.
You will then see fields pertaining to the remaining bit of metadata we collected. You should enter these values and select that this channel be the default channel for the project. Once your field looks like that shown below, you can click the "Create Channel" button.
You should then be returned to the channel page, where you will now see that your channel exists.
Now that you have a dataset, project, token, and channel all setup for your data, you should record these values and prepare to ingest your data. Note that when you selected to create a default token, the token name was created with the same name as your project. Summarizing the values for our example, we have:
| field | value |
|---|---|
| dataset | kki2009_demo |
| project | 113_1_demo |
| token | 113_1_demo |
| channel | image |
Now you can move on to one of our ingest tutorials to upload your data.