Difference between revisions of "Documentation/Nightly/Developers/Tutorials/UploadTestData"

From Slicer Wiki
Jump to: navigation, search
 
(19 intermediate revisions by 2 users not shown)
Line 1: Line 1:
 +
<noinclude>{{documentation/versioncheck}}</noinclude>
 
= Introduction =
 
= Introduction =
  
Line 12: Line 13:
 
* <code>4.3</code>
 
* <code>4.3</code>
  
{{note}} Each time a  release of Slicer is done, for both the <code>Application</code> and <code>Modules/&lt;ModuleName&gt;<code> folders, the current <code>Nightly</code> is copied into an <code>X.Y</code> folders where X and Y corresponds to the major and minor release number of Slicer.
+
Test data are expected to be stored in folders like:
 +
 
 +
* <code>Data/Application/Nightly/Testing/Baseline</code>
 +
* <code>Data/Application/Nightly/Testing/Input</code>
 +
* <code>Data/Modules/&lt;NameOfYourModule&gt;/Nightly/Testing/Baseline</code>
 +
* <code>Data/Modules/&lt;NameOfYourModule&gt;/Nightly/Testing/Input</code>
  
Test data are expected to be stored in folders like:
+
* <code>Data/Application/X.Y/Testing/Baseline</code>
 +
* <code>Data/Application/X.Y/Testing/Input</code>
 +
* <code>Data/Modules/&lt;NameOfYourModule&gt;/X.Y/Testing/Baseline</code>
 +
* <code>Data/Modules/&lt;NameOfYourModule&gt;/X.Y/Testing/Input</code>
  
* <code>Nightly/Testing/Baseline</code>
+
where
* <code>Nightly/Testing/Input</code>
 
* <code>X.Y/Testing/Baseline</code>
 
* <code>X.Y/Testing/Input</code>
 
  
#'''Input data folder''': Used to store testing input data.
+
* <code>&lt;NameOfYourModule&gt;</code>: name of the folder in the source repository, it should also match the module pages created on the slicer wiki.
#'''Baseline dataset folder''': Used to store the baseline images for regression tests.
+
* <code>Input</code>: Used to store testing input data.
 +
* <code>Baseline</code>: Used to store the baseline images for regression tests.
  
 
= Upload test data =
 
= Upload test data =
  
# Ask to be added to the DataManager group on NA-MIC community. That will grant you read/write in the Data folder.
+
<ol start="1" style="list-style-type: decimal;">
# Create a sub folder for your Module.  
+
 
# Create a <code>Nightly</code> sub-folder.  
+
{{:Documentation/{{documentation/version}}/Developers/Tutorials/CreateMidasAccount/steps}}
# Upload data in folders <code>Nightly/Testing/Baseline</code> and <code>Nightly/Testing/Input</code>
+
 
 +
<li>Send an email on the developer list asking to be added to the <code>DataManager</code> group on NA-MIC community. That will grant you read/write permissions to the <code>Data</code> folder and sub-folders.</li>
 +
<li>Create a sub folder for your Module.</li>
 +
<li>Create a <code>Nightly</code> sub-folder.</li>
 +
<li>Upload data in folders <code>Nightly/Testing/Baseline</code> and <code>Nightly/Testing/Input</code></li>
 +
 
 +
</ol>
 +
 
 +
<gallery widths=330px heights=220px perrow=4>
 +
File:Midas-test-data-upload-1.png|Browse, select the destination folder (1) and click on View (2)
 +
File:Midas-test-data-upload-2.png|Select an item (3) and click "Upload here" (4)
 +
File:Midas-test-data-upload-3.png|Select one or more files (5) and click "Upload" button (6)
 +
</gallery>
 +
 
 +
= FAQ =
 +
 
 +
== What happen when Slicer is released ? ==
 +
 
 +
Each time a  release of Slicer is done, for both the <code>Application</code> and <code>Modules/&lt;NameOfYourModule&gt;</code> folders, the current <code>Nightly</code> is copied into an <code>X.Y</code> folders where X and Y corresponds to the major and minor release number of Slicer.
 +
 
 +
== Should data for extension be organized differently ? ==
 +
 
 +
For now, let's keep all of them at the same level. We will have to coordinate with the development of the release script allowing to version the Data tree. See [http://slicer-devel.65872.n3.nabble.com/Versioning-of-test-data-tree-on-slicer-kitware-com-What-does-this-mean-for-you-tt4026608.html here]
 +
 
 +
It means if you develop an extension named <code>Salad</code> bundling two modules respectively named <code>Tomato</code> and <code> Mozzarella</code>, the following folders would have to be created:
 +
 
 +
* <code>Data/Modules/Tomato/Nightly/Testing/Baseline</code>
 +
* <code>Data/Modules/Tomato/Nightly/Testing/Input</code>
 +
* <code>Data/Modules/Mozzarella/Nightly/Testing/Baseline</code>
 +
* <code>Data/Modules/Mozzarella/Nightly/Testing/Input</code>
 +
 
 +
Consider also monitoring issue [http://www.na-mic.org/Bug/view.php?id=2722 #2722]: Think about organization of Data/Modules directory on midas to accomodate extension relationship

Latest revision as of 15:23, 27 August 2013

Home < Documentation < Nightly < Developers < Tutorials < UploadTestData


For the latest Slicer documentation, visit the read-the-docs.


Introduction

Slicer has adopted MIDAS to store testing and algorithm validation dataset. For this purpose, we have created a dedicated NA-MIC MIDAS community

In the NA-MIC community Slicer/Data folder, you will find:

To organize the test data based on Slicer major release, you will find sub folders like:

  • Nightly
  • 4.2
  • 4.3

Test data are expected to be stored in folders like:

  • Data/Application/Nightly/Testing/Baseline
  • Data/Application/Nightly/Testing/Input
  • Data/Modules/<NameOfYourModule>/Nightly/Testing/Baseline
  • Data/Modules/<NameOfYourModule>/Nightly/Testing/Input
  • Data/Application/X.Y/Testing/Baseline
  • Data/Application/X.Y/Testing/Input
  • Data/Modules/<NameOfYourModule>/X.Y/Testing/Baseline
  • Data/Modules/<NameOfYourModule>/X.Y/Testing/Input

where

  • <NameOfYourModule>: name of the folder in the source repository, it should also match the module pages created on the slicer wiki.
  • Input: Used to store testing input data.
  • Baseline: Used to store the baseline images for regression tests.

Upload test data

  1. Create an account on the extension server: http://slicer.kitware.com by clicking on the Register link in the top right corner

  2. Slicer-midas-extensions-server-registration.png

    This image shows the top portion of http://slicer.kitware.com after it has been expanded by clicking the Register button.

  3. Go to NA-MIC community and click on Join community

  4. Send an email on the developer list asking to be added to the DataManager group on NA-MIC community. That will grant you read/write permissions to the Data folder and sub-folders.
  5. Create a sub folder for your Module.
  6. Create a Nightly sub-folder.
  7. Upload data in folders Nightly/Testing/Baseline and Nightly/Testing/Input

FAQ

What happen when Slicer is released ?

Each time a release of Slicer is done, for both the Application and Modules/<NameOfYourModule> folders, the current Nightly is copied into an X.Y folders where X and Y corresponds to the major and minor release number of Slicer.

Should data for extension be organized differently ?

For now, let's keep all of them at the same level. We will have to coordinate with the development of the release script allowing to version the Data tree. See here

It means if you develop an extension named Salad bundling two modules respectively named Tomato and Mozzarella, the following folders would have to be created:

  • Data/Modules/Tomato/Nightly/Testing/Baseline
  • Data/Modules/Tomato/Nightly/Testing/Input
  • Data/Modules/Mozzarella/Nightly/Testing/Baseline
  • Data/Modules/Mozzarella/Nightly/Testing/Input

Consider also monitoring issue #2722: Think about organization of Data/Modules directory on midas to accomodate extension relationship