Skip to Content

Wiki source code of 6.6 Dataset Versioning

Last modified by publicadmin on 2025/12/16 13:04
Show last authors
1 === About Dataset Versioning ===
2
3 Changes made to a Dataset are tracked in real time and can be viewed at any time in the [[Dataset Provenance>>doc:Main.user_guide.Working with Datasets.Data Explorer.WebHome]] Activity Stream.  From time to time, however, you may want to save a snapshot of your Dataset in its current state to be able to refer back to in the future or to make it available for other researchers to reference and use for their own analyses.
4
5 The// //**Dataset Versioning** feature allows you to create a snapshot of your Dataset at a specific point in time.  When a new Dataset version is released, the data files and folders and the annotations stored in its [[metadata schemas >>doc:Main.user_guide.Working with Datasets.Metadata Schemas.WebHome]]are bundled together and saved.  The version is now locked so that no additional changes can be made.  This version can be downloaded as a zip file from the [[Dataset Explorer>>doc:Main.user_guide.Working with Datasets.Dataset Explorer.WebHome]]. 
6
7
8 === How to release a new Dataset Version ===
9
10 1. Open the Datasets feature from the top VRE menu bar, then navigate to your Dataset.
11 1. After making any desired updates to the Dataset, click **Release new version.**
12 1. Select //Minor //or //Major //Release.  The version numbering applied automatically based on the last Version you published, starting with Version 1.0.  The distinction of Minor vs. Major is entirely at your discretion.
13 1. Enter a brief description of this Dataset release in the //Version Notes// box.  A high-level summary of the changes made to the Dataset since the last release is recommended.
14 1. Click **Publish Version**.
15
16 === How to download a Dataset Version ===
17
18 1. Open the Datasets feature from the top VRE menu bar, then navigate to your Dataset.
19 1. Click **Versions **in the top left corner of the Dataset Canvas.  A list of the previous versions will appear in the right-side panel.
20 1. Click the Download icon next to the version you wish to download.  A .zip archive will be generated that contains:
21 1*. all the files and folders in Dataset Version in their original folder hierarchies
22 1*. all the metadata annotations added to the Dataset at the time the Version was created
23
24 {{warning}}
25 **NOTE: **When you use the Download function, the data leaves the VRE and will be stored on your local computer.  For Datasets that contain personal data governed by GDPR, it is the Data Controller's responsibility to ensure that this action is consistent with the data processing activities stated in your project's Data Protection Impact Assessment.
26 {{/warning}}
27
28
29
30 ----
31
32 **See Also: **
33
34 [[Dataset Organization and Validation>>doc:Main.user_guide.Working with Datasets.Dataset Explorer.WebHome]]
35
36 [[Dataset Provenance>>doc:Main.user_guide.Working with Datasets.Data Explorer.WebHome]]
37 ----
38
39 {{box}}
40 (% style="text-align:center" %)
41 image:https://i.creativecommons.org/l/by-sa/4.0/88x31.png
42
43 (% style="text-align: center;" %)
44 Copyright © 2022, Indoc Research. This work is licensed under a [[Creative Commons Attribution-ShareAlike 4.0>>http://creativecommons.org/licenses/by-sa/4.0/ ||rel="noopener noreferrer" target="blank"]] International License.
45 {{/box}}