A dataset is a modular construction that provides flexible and standardized descriptions of various aspects of experiments. The dataset has a number of direct fields, but is primarily described by below module data.
Dataset module data:
Experiment Data: Description of the data acquisition files. The Experiment Data module is highly flexible and can be used to describe many types of experimental data, such as Extracellular and Intracellular Electrophysiology, 2-photon microscopy, Miniscope, Audio Recordings, and Behavioral Video Recordings. Details are tailored to each experiment type.
Manipulations: Description of any manipulations performed during an experiment. This is a crusial module as manipulations alters the physiological conditions of a recording. The Manipulations module is flexible and can describe many types of manipulations, such as Optogenetic Stimulation, Micro Perfusion, Pharmacological Injection, Thermal Perturbation, Transcranial Electrical Stimulation, and Ultrasound Stimulation. A manipulation is described by a manipulation protocol, typically consisting of a description of the manipulation profile, its power, duration, duty cycle, and the number of repetitions.
Behavior: Description of the behavior the animal subject(s) is doing during the collection of the dataset. A behavior is described by two personal attributes: the experimental setup and the behavioral paradigm.
Epochs: Temporal aspects of a dataset. An epoch is characterized by a name, a start and end time relative to the start of the dataset. The other modules (Experiment Data, Manipulations, and Behavior) can be linked to epochs, allowing for temporal segmentation of a dataset.
Two-Part Form with Autosave
The submission form consists of two parts. First, you fill in the required fields. Once you click "Create and continue," the project entry is created, and you can continue editing it on the second part of the form, which contains all the fields.
The second part of the form automatically keeps track of your changes and saves as you fill out the form.
Dataset fields:
Name: The dataset name must be unique across BrainSTEM (required).
Projects: You can only select projects for which you have change-permissions. If the project list is empty, you must create a project first on the project page. The selected project also defines which subjects, actions, and personal attributes you can choose from on the second part of the form (required).
Description: A text description of the dataset.
Date and time: The onset of the dataset.
Tags: Tags for the dataset. Tags are useful for organizational purposes, allowing you to quickly label a subject and use them as filters. Tags are shared among users.
Data repositories: Describes where the data is stored.
Name used in repository: Optional custom name for the dataset for data handling. As the dataset name must be unique across BrainSTEM, this allows for greater flexibility in data handling.
Extra fields: Allows you to add additional fields to the dataset. The values can be strings or numeric values.
Public repositories: Allows you to add additional fields to the dataset. The values can be strings or numeric values.
Permissions
The dataset inherits permissions from projects associated with it. Data repositories are shared through the project's groups, and you can only add a data repository associated with the same groups as the selected projects. The relationships in module data also depend on the selected projects. For more information on permissions, please visit the permissions page.
Dataset API Access
The API allows for programmable access to datasets. For detailed information about the datasets' fields and data structure, please refer to the API documentation on the Dataset API endpoint.
