EMMAWiki/WebDocumentation/GeneralUsage/ImportDatafromArrayLIMS: Difference between revisions

From BRF-Software
Jump to navigation Jump to search
imported>VirginieMittard
No edit summary
 
(5 intermediate revisions by 3 users not shown)
Line 1: Line 1:
__NOTOC__
__NOTOC__
<!-- ## page was renamed from [[ImportingData]] -->
<!-- ## page was renamed from [[ImportingData]] -->
= [[HowTo]] Import Data From the ArrayLIMS =
= HowTo Import Data From the ArrayLIMS =


After you have created a new experiment in your project you might want to import data to it. Therefore please use the ImportWizzard.
This page describes how to import data from [[ArrayLIMSWiki|ArrayLIMS]] to the [[EMMAWiki|EMMA System]].
Before you can import data you need an existing experiment. So either create one or use an existing one.
To be able to import data to [[EMMAWiki|EMMA]] one has to select an Experiment first or to create a new experiment in your project you might want to import data to it. All imported Arrays will be appended to the selected Experiment. After selecting an Experiment, there is a "Import from ArrayLIMS" link in the BasicMenu.


* While you are working with the experiment, you will find following navigation buttons on the left:
[[File:MainMenul.png]]


[[Image:EMMAWiki$$WebDocumentation$$GeneralUsage$$ImportDatafromArrayLIMS$MainMenul.png]]
Use this link to get to the main import page.
Just follow the instructions at the top. It will guide you through a six step process.


* Click on ''Import from ArrayLIMS''
== Step 1 Select an ArrayLIMS Project ==
------
* You will see the following screen:
Just follow the instructions at the top. It will guide you through a six step process.
* Select the appropriate ArrayLIMS project. If you see no project, you are not member of project. Ask your ArrayLIMS administrator for access.
[[Image:EMMAWiki$$WebDocumentation$$GeneralUsage$$ImportDatafromArrayLIMS$import1.png]]


------
Step one is the selection of an appropriate [[ArrayLIMSWiki|ArrayLIMS]] Project. The selection box lists all accessible [[ArrayLIMSWiki|ArrayLIMS]] Projects.  
* Select one or many slides from the arraylims you want to import:
Now you have to select the one you want to import arrays from. If you see no project, you are not member of project. Ask your ArrayLIMS administrator for access.
[[Image:EMMAWiki$$WebDocumentation$$GeneralUsage$$ImportDatafromArrayLIMS$import1b.png]]
[[File:import1.png]]
* Note: This is an example. Which slides you actually see depends on your project.  
------
* For each array you have selected in the previous step, select the channel assignment for each data file. Be careful to select the correct channel for each slide.
* If you have scanned more than one image per channel you will see four or more rows per slide
* Select two files for each slide. If you select one on the left the corresponding image on the right will be highlighted.
[[Image:EMMAWiki$$WebDocumentation$$GeneralUsage$$ImportDatafromArrayLIMS$import2.png]]
------
* Select the appropriate [[ArrayLayout]] for this slide. Normally only one will fit each slide, but you have to select it anyway.
[[Image:EMMAWiki$$WebDocumentation$$GeneralUsage$$ImportDatafromArrayLIMS$import3.png]]
------
* Check your settings and enter an appropriate common name for your slides:


[[Image:EMMAWiki$$WebDocumentation$$GeneralUsage$$ImportDatafromArrayLIMS$import4.png]]
== Step 2 Select Slides ==


= Import Data from ArrayLIMS =
After the project selection is done you have to select the slides you want to import. The list shows all slides available in the selected project and lists there slide names and optionally a type and some remarks. To be listed here the slides also have to contain valid images to be importable. Use the checkboxes to select one or more slides and continue with step 3.
[[File:import1b.png]]


This page describes how to import data from [[ArrayLIMSWiki|ArrayLIMS]] to the [[EMMAWiki|EMMA System]].
* Note: This is an example. Which slides you actually see depends on your project.  
To be able to import data to [[EMMAWiki|EMMA]] one has to select an Experiment first. All imported Arrays will
be appended to the selected Experiment.
After selecting an Experiment, there is a "Import from ArrayLIMS" link in the BasicMenu.
Use this link to get to the main import page.


The ArrayLIMS import is devided into 6 steps.
== Step 3 Image Selection ==


== Step 1 Select an ArrayLIMS Project ==
Here you have to select appropriate [[Image and data upload|images]] from the selected slides and assign them to the channels. For each array you have selected in the previous step, select the channel assignment for each data file. If you have scanned with ImaGene, you will select two files for each slide.
Step one is the selection of an appropriate [[ArrayLIMSWiki|ArrayLIMS]] Project. The selection box lists all accessible [[ArrayLIMSWiki|ArrayLIMS]] Projects.  
In the following example, there are two channels, one for the "Experiment" (the first channel) and one for "Control" (the second channel). Each [[ArrayLIMSWiki|ArrayLIMS]] Slide contains two [[Image and data upload|images]] and now you have to assign the [[Image and data upload|images]] to the channels, that is, choose one [[Image and data upload|images]] for channel one and the other [[Image and data upload|images]] for channel two. The [[ArrayLIMSWiki|ArrayLIMS]] System tells you which color marker is used for which image (e.g. cy5 and cy3), and as long as you know what you did, you should be able to assign the correct [[Image and data upload|images]] to the channels, just be careful not to switch on channels if you don't want to. After the "image to channel" assignment you can continue to the next step, but don't be confused, it will take a while until the "Step 4" page is loaded, because we have to parse the appropriate data files and count the spot information and the files are quite large...
Now you have to select the one you want to import arrays from.


== Step 2 Select Slides ==
[[File:import2.png]]
After the project selection is done you have to select the slides you want to import. The list shows all slides available in the selected project and lists there slide names and optionally a type and some remarks. To be listed here the slides also have to contain valid images to be importable. Use the checkboxes to select one or more slides and continue with step 3.


== Step 3 Image Selection ==
* Note that if you have scanned more than one image per channel you will see four or more rows per slide.
Here you have to select appropriate [[Image and data upload|images]] from the selected slides and assign them to the channels. There are two channels, one for the "Experiment" (the first channel) and one for "Control" (the second channel). Each [[ArrayLIMSWiki|ArrayLIMS]] Slide contains two [[Image and data upload|images]] and now you have to assign the [[Image and data upload|images]] to the channels, that is, choose one [[Image and data upload|images]] for channel one and the other [[Image and data upload|images]] for channel two. The [[ArrayLIMSWiki|ArrayLIMS]] System tells you which color marker is used for which image (e.g. cy5 and cy3), and as long as you know what you did, you should be able to assign the correct [[Image and data upload|images]] to the channels, just be careful not to switch on channels if you don't want to. After the "image to channel" assignment you can continue to the next step, but don't be confused, it will take a while until the "Step 4" page is loaded, because we have to parse the appropriate data files and count the spot information and the files are quite large...


== Step 4 Choose [[ArrayLayout]] ==
== Step 4 Choose [[ArrayLayout]] ==
After the data file parsing is done, you have to select a proper ArrayLayout for each slide. In the normal case there will just be one Layout listed and you just have to select this one. If the list contains more than one layout for a slide, you have to select the correct one used for your Experiment. If you try to import slides where EMMA does not list any layouts, you have to import the appropriate layout first before you can import the [[ArrayLIMSWiki|ArrayLIMS]] slides according to the layout.
After the data file parsing is done, you have to select a proper ArrayLayout for each slide. In the normal case there will just be one Layout listed and you just have to select this one. If the list contains more than one layout for a slide, you have to select the correct one used for your Experiment. If you try to import slides where EMMA does not list any layouts, you have to import the appropriate layout first before you can import the [[ArrayLIMSWiki|ArrayLIMS]] slides according to the layout.
[[File:import3.png]]


== Step 5 Selection Overview ==
== Step 5 Selection Overview ==
Line 61: Line 42:
to verify that all data are correct before you start the import.If you find a mistake in the selected data, please use your browser's back button
to verify that all data are correct before you start the import.If you find a mistake in the selected data, please use your browser's back button
and fix it, otherwise click the "Start Import" Button to submit the import job.
and fix it, otherwise click the "Start Import" Button to submit the import job.
[[File:import4.png]]


== Step 6 Job Submitted ==
== Step 6 Job Submitted ==
This is just an information page that tells you that the import job was successfully submitted and is running now. To view the status of the job, you can use the [[EMMAWiki/WebDocumentation/ViewResults|ViewResults]] page reachable from the [[EMMAWiki/WebDocumentation/BasicMenu|BasicMenu]].
This is just an information page that tells you that the import job was successfully submitted and is running now. To view the status of the job, you can use the ViewResults page reachable from the [[EMMAWiki/WebDocumentation/BasicMenu|BasicMenu]].

Latest revision as of 13:42, 26 October 2011

HowTo Import Data From the ArrayLIMS

This page describes how to import data from ArrayLIMS to the EMMA System. To be able to import data to EMMA one has to select an Experiment first or to create a new experiment in your project you might want to import data to it. All imported Arrays will be appended to the selected Experiment. After selecting an Experiment, there is a "Import from ArrayLIMS" link in the BasicMenu.

MainMenul.png

Use this link to get to the main import page. Just follow the instructions at the top. It will guide you through a six step process.

Step 1 Select an ArrayLIMS Project

Step one is the selection of an appropriate ArrayLIMS Project. The selection box lists all accessible ArrayLIMS Projects. Now you have to select the one you want to import arrays from. If you see no project, you are not member of project. Ask your ArrayLIMS administrator for access. Import1.png

Step 2 Select Slides

After the project selection is done you have to select the slides you want to import. The list shows all slides available in the selected project and lists there slide names and optionally a type and some remarks. To be listed here the slides also have to contain valid images to be importable. Use the checkboxes to select one or more slides and continue with step 3. Import1b.png

  • Note: This is an example. Which slides you actually see depends on your project.

Step 3 Image Selection

Here you have to select appropriate images from the selected slides and assign them to the channels. For each array you have selected in the previous step, select the channel assignment for each data file. If you have scanned with ImaGene, you will select two files for each slide. In the following example, there are two channels, one for the "Experiment" (the first channel) and one for "Control" (the second channel). Each ArrayLIMS Slide contains two images and now you have to assign the images to the channels, that is, choose one images for channel one and the other images for channel two. The ArrayLIMS System tells you which color marker is used for which image (e.g. cy5 and cy3), and as long as you know what you did, you should be able to assign the correct images to the channels, just be careful not to switch on channels if you don't want to. After the "image to channel" assignment you can continue to the next step, but don't be confused, it will take a while until the "Step 4" page is loaded, because we have to parse the appropriate data files and count the spot information and the files are quite large...

Import2.png

  • Note that if you have scanned more than one image per channel you will see four or more rows per slide.

Step 4 Choose ArrayLayout

After the data file parsing is done, you have to select a proper ArrayLayout for each slide. In the normal case there will just be one Layout listed and you just have to select this one. If the list contains more than one layout for a slide, you have to select the correct one used for your Experiment. If you try to import slides where EMMA does not list any layouts, you have to import the appropriate layout first before you can import the ArrayLIMS slides according to the layout.

Import3.png

Step 5 Selection Overview

Finally choose a name for the selected arrays and take a look at the overview shown on this page to verify that all data are correct before you start the import.If you find a mistake in the selected data, please use your browser's back button and fix it, otherwise click the "Start Import" Button to submit the import job.

Import4.png

Step 6 Job Submitted

This is just an information page that tells you that the import job was successfully submitted and is running now. To view the status of the job, you can use the ViewResults page reachable from the BasicMenu.