Difference between revisions of "Workspace"

(Overview)
 
(55 intermediate revisions by the same user not shown)
Line 1: Line 1:
 
{{TutorialsTopNav}}
 
{{TutorialsTopNav}}
  
=Outline=
+
==Overview==
In this tutorial, you will learn how to:
 
  
*Create a new Project.
 
*Rename a project and/or project node.
 
*Remove a project and/or project node.
 
*Save project files that you have created.
 
  
 +
The Workspace is located in the upper-left-hand corner of the application. It is used to contain open data files and store analysis results during a geWorkbench session. When geWorkbench is launched, an empty Workspace folder is displayed.
  
  
==Workspaces and Projects==
+
[[Image:Workspace.png]]
In the '''Project Folders''' component there is a top-level object called a workspace.  The workspace can contain one or more separate projects, and each project can contain opened data files and analysis results. An analogy might be that a workspace is like a drawer in a filing cabinet, and projects are individual folders in that drawer. Projects allow data to be grouped, for example by experiment.  A project can contain many different types of data, for example microarray data, FASTA sequence files and graphical images.  The workspace as a whole, with all its projects and data nodes, can be saved and restored.  However, only one workspace can be open at one time.
 
  
All data must belong to a project.
 
  
 +
The workspace as a whole, with all its projects and data nodes, can be saved and restored.  However, only one workspace can be open at one time.  Creating a new workspace or loading a saved workspace will overwrite the current workspace.
  
==Creating a new project==
 
  
There are two ways to create a new project.  First, select the Workspace node in the Project Folders component. Then, either
 
  
(1) In the top-level Menu, select '''File->New->Project'''.
+
* To view the next level down in the hierarchy, click on the “+” icon to expand the branch.
  
[[Image:File_New_Project.png]]
+
* To collapse a branch, click on the “-” icon.
  
or,
 
  
(2) In the Project Folders component, right-click on the '''Workspace''' and select "'''New Project'''".
+
The Workspace may contain several heterologous datasets. These datasets can include input (source) data and derived data (results) associated with an experiment as well as image files. Source data can be loaded from the user’s local storage or from remote servers.  Loading datasets into the geWorkbench Workspace does not change their physical storage locations.
  
 +
'''Note''' - The top menu-bar items [[Menu_Bar#File|File]] and [[Menu_Bar#Edit|Edit]] also apply to items in the Workspace.  They offer many of the same options shown below, except e.g. Microarray merging is only available from the top level [[Menu_Bar#File|File]] menu.
  
[[Image:Project_Folders_Workspace_New_Project.png]]
+
==Workspace Menu Options==
  
 +
Right-clicking on the Workspace node gives a menu with the following options
  
Either way, the new Project is placed into the workspace:
 
  
 +
[[Image:Workspace_right_click_menu.png]]
  
[[Image:Project_Folders_Project.png]]
 
  
 +
===Open Files===
 +
* Loading data from local files is covered in the chapter [[Local_Data_Files | Local Data Files]]
 +
* Retrieving data from remote sources (caArray) is covered in [[Remote_Data_Sources | Remote Data Sources]]
  
==Project Menu Options==
 
  
Right-clicking on a Project node gives a menu with the following options
+
===Open PDB File from RCSB Protein Data Bank===
 +
If '''Open PDB File from RCSB Protein Data Bank''' is chosen, a dialog box appears.
  
* Open File(s)
 
* Open PDB File from RCSB Protein Data Bank
 
* Rename Project
 
* Remove Project
 
  
 +
[[Image:Project_Folders_Project_Open_RCSB_PDB.png]]
  
[[Image:Project_Folders_Project_Options.png]]
 
  
 +
Type in the name of a PDB structure entry and it will be retrieved from the RCSB Protein Data Bank and loaded into geWorkbench.
  
===Renaming a project===
+
==Workspace Data Node Menu Options==
  
'''1.''' Right-click on '''Project''' folder.
+
Right-clicking on a data node will produce a popup menu with the following options:
  
'''2.''' Select '''Rename'''.
 
  
 +
[[Image:Workspace_data_node_right_click.png]]
  
[[Image:T_ProjectFolder_RenameProject.png]]
 
  
 +
===Save===
  
'''3.''' In the pop-up screen rename your project.
+
Save the currently selected data node.  This is implemented for at least the below data types. If saving of a particular type has not been implemented, the "Save" option will be disabled (grayed-out).
  
'''4.''' Click on the '''OK''' button
+
* '''Microarray gene expression''' -  data is saved using the geWorkbench ".exp" format, regardless of the original format. This allows saving e.g. a merged dataset, and/or any array and marker sets that may have been created.
 +
* '''FASTA''' - saved in FASTA format (.fasta).
 +
* '''PDB''' - saved in PDB format (.pdb).
 +
* '''Network''' - saved using the Adjacency Matrix "ADJ" format (.adj).
 +
* '''t-test result''' - saved as comma separated value (.csv) file.
 +
* '''Image''' - saved as PNG file (.png).
  
 +
For each file type, a file browser with a filter for the target file type extension (e.g. .fasta) will be opened.
  
===Removing a project===
+
===Export to tab-delim===
 +
This option will only appear for microarray gene expression datasets.  It allows the microarray dataset to be exported in a spreadsheet format, as a tab-delimited text file.  The first row contains array names and the first column contains the marker names.
  
'''1.''' Right-click on '''Project''' folder.
+
This export format does not preserve array or marker sets that may have been defined in geWorkbench for the dataset. However, it can be used to save a copy of e.g. merged, filtered, and/or normalized data in a format easily used by other programs.
  
'''2.''' Select '''Remove'''.
+
When exporting, the file save dialog will display the name of the dataset, minus any recognized file-type suffixes that may be present (e.g. .soft).
  
 +
===Rename===
  
==Project Data Node Menu Options==
+
A dialog box will appear in which a new name can be entered.
  
===Renaming a data node===
 
  
'''1.''' Right-click on a Project Folder data node.
+
[[Image:Workspace_Rename_Node.png]]
  
'''2.''' Select '''Rename'''.
+
===Remove===
  
[[Image:T_RenameNode.png]]
+
The selected data nodes and any child data nodes will be removed.  Multiple selections can be made.
  
 +
==Data Node Hover-text Information==
  
 +
For microarray datasets, adjacency matrices (network nodes), sequence and pattern nodes, moving the mouse cursor over the data nodes will display additional details about a dataset.
  
'''3.''' In the pop-up screen rename your data node.
+
Microarray datasets: hover text displays number of markers and arrays.
  
[[Image:T_ProjectFolder_RenameDataset2.png]]
 
  
 +
[[Image:Dataset_hover_microarray.png]]
  
'''4.''' Click on the '''OK''' button.
 
  
 +
Adjacency Matrix: hover text displays number of nodes and edges in the network.
  
  
 +
[[Image:Workspace_Dataset_hover_network.png]]
  
==Removing a project data node==
 
  
'''1.''' Right-click on the data node.
+
Sequence node:
  
'''2.''' Select '''Remove'''.
 
  
 +
[[Image:Workspace_hover_sequences.png]]
  
==Saving a data node to a file==
 
  
It is here that, among other things, you can create the matrix multi-experiment file format used by geWorkbench from a merged dataset.
+
Pattern node:
  
'''1.''' Right-click on data node that you want to save.
 
  
'''2.''' Click '''Save'''.
+
[[Image:Workspace_Pattern_Hover.png]]
  
[[Image:T_NodeOptionsMenu.png]]
+
==Workspaces==
  
 +
===Saving the Workspace===
  
A standard file '''Save''' screen will come up.
+
Saving the workspace saves all its data to a file on disk. The workspace can later be reloaded to resume work. 
  
'''3.''' Choose a location.
+
====Special considerations on saving and restoring workspaces====
 +
* '''Versions''' - Workspaces in general may not be compatible across different versions of geWorkbench.
 +
* '''Loaded components''' - The configuration in the [[Component_Configuration_Manager| CCM]] of which components are loaded and which are not is not saved when the workspace is saved; it is maintained separately.
 +
* '''Changes to loaded components''' - If a workspace is saved, and then changes are made to which components are loaded in the [[Component_Configuration_Manager| CCM]], then in rare cases problems may occur when one attempts to reload the saved workspace.
  
'''4.''' Enter a name.
 
  
'''5.''' Click on the '''Save''' button.
+
[[Image:File_Save_Workspace.png]]
 +
 
 +
===Opening a Saved Workspace===
 +
 
 +
File->Open-Workspace.
 +
 
 +
Only one workspace at a time can be loaded in geWorkbench.  Opening a saved workspace will destroy the existing workspace.  For this reason, if you opt to open a workspace, you will be prompted as to whether to save the existing workspace first.
 +
 
 +
 
 +
[[Image:File_Open_Workspace.png]]
 +
 
 +
 
 +
A dialog box will appear in which the location and file name to which to save the workspace can be chosen.
 +
 
 +
 
 +
[[Image:File_Save_Workspace_Dialog.png]]
 +
 
 +
===Creating a New Workspace===
 +
 
 +
Only one workspace at a time can be loaded in geWorkbench.  Creating a new workspace will destroy the existing workspace.  For this reason, if you opt to create a new workspace, you will be prompted as to whether to save the existing workspace first.
 +
 
 +
A new workspace can only be created from the top level menu bar.
 +
 
 +
 
 +
[[Image:File_New_Workspace.png]]
 +
 
 +
 
 +
Select '''File->New->Workspace'''.

Latest revision as of 17:07, 10 January 2014

Home | Quick Start | Basics | Menu Bar | Preferences | Component Configuration Manager | Workspace | Information Panel | Local Data Files | File Formats | caArray | Array Sets | Marker Sets | Microarray Dataset Viewers | Filtering | Normalization | Tutorial Data | geWorkbench-web Tutorials

Analysis Framework | ANOVA | ARACNe | BLAST | Cellular Networks KnowledgeBase | CeRNA/Hermes Query | Classification (KNN, WV) | Color Mosaic | Consensus Clustering | Cytoscape | Cupid | DeMAND | Expression Value Distribution | Fold-Change | Gene Ontology Term Analysis | Gene Ontology Viewer | GenomeSpace | genSpace | Grid Services | GSEA | Hierarchical Clustering | IDEA | Jmol | K-Means Clustering | LINCS Query | Marker Annotations | MarkUs | Master Regulator Analysis | (MRA-FET Method) | (MRA-MARINa Method) | MatrixREDUCE | MINDy | Pattern Discovery | PCA | Promoter Analysis | Pudge | SAM | Sequence Retriever | SkyBase | SkyLine | SOM | SVM | T-Test | Viper Analysis | Volcano Plot


Overview

The Workspace is located in the upper-left-hand corner of the application. It is used to contain open data files and store analysis results during a geWorkbench session. When geWorkbench is launched, an empty Workspace folder is displayed.


Workspace.png


The workspace as a whole, with all its projects and data nodes, can be saved and restored. However, only one workspace can be open at one time. Creating a new workspace or loading a saved workspace will overwrite the current workspace.


  • To view the next level down in the hierarchy, click on the “+” icon to expand the branch.
  • To collapse a branch, click on the “-” icon.


The Workspace may contain several heterologous datasets. These datasets can include input (source) data and derived data (results) associated with an experiment as well as image files. Source data can be loaded from the user’s local storage or from remote servers. Loading datasets into the geWorkbench Workspace does not change their physical storage locations.

Note - The top menu-bar items File and Edit also apply to items in the Workspace. They offer many of the same options shown below, except e.g. Microarray merging is only available from the top level File menu.

Workspace Menu Options

Right-clicking on the Workspace node gives a menu with the following options


Workspace right click menu.png


Open Files


Open PDB File from RCSB Protein Data Bank

If Open PDB File from RCSB Protein Data Bank is chosen, a dialog box appears.


Project Folders Project Open RCSB PDB.png


Type in the name of a PDB structure entry and it will be retrieved from the RCSB Protein Data Bank and loaded into geWorkbench.

Workspace Data Node Menu Options

Right-clicking on a data node will produce a popup menu with the following options:


Workspace data node right click.png


Save

Save the currently selected data node. This is implemented for at least the below data types. If saving of a particular type has not been implemented, the "Save" option will be disabled (grayed-out).

  • Microarray gene expression - data is saved using the geWorkbench ".exp" format, regardless of the original format. This allows saving e.g. a merged dataset, and/or any array and marker sets that may have been created.
  • FASTA - saved in FASTA format (.fasta).
  • PDB - saved in PDB format (.pdb).
  • Network - saved using the Adjacency Matrix "ADJ" format (.adj).
  • t-test result - saved as comma separated value (.csv) file.
  • Image - saved as PNG file (.png).

For each file type, a file browser with a filter for the target file type extension (e.g. .fasta) will be opened.

Export to tab-delim

This option will only appear for microarray gene expression datasets. It allows the microarray dataset to be exported in a spreadsheet format, as a tab-delimited text file. The first row contains array names and the first column contains the marker names.

This export format does not preserve array or marker sets that may have been defined in geWorkbench for the dataset. However, it can be used to save a copy of e.g. merged, filtered, and/or normalized data in a format easily used by other programs.

When exporting, the file save dialog will display the name of the dataset, minus any recognized file-type suffixes that may be present (e.g. .soft).

Rename

A dialog box will appear in which a new name can be entered.


Workspace Rename Node.png

Remove

The selected data nodes and any child data nodes will be removed. Multiple selections can be made.

Data Node Hover-text Information

For microarray datasets, adjacency matrices (network nodes), sequence and pattern nodes, moving the mouse cursor over the data nodes will display additional details about a dataset.

Microarray datasets: hover text displays number of markers and arrays.


Dataset hover microarray.png


Adjacency Matrix: hover text displays number of nodes and edges in the network.


Workspace Dataset hover network.png


Sequence node:


Workspace hover sequences.png


Pattern node:


Workspace Pattern Hover.png

Workspaces

Saving the Workspace

Saving the workspace saves all its data to a file on disk. The workspace can later be reloaded to resume work.

Special considerations on saving and restoring workspaces

  • Versions - Workspaces in general may not be compatible across different versions of geWorkbench.
  • Loaded components - The configuration in the CCM of which components are loaded and which are not is not saved when the workspace is saved; it is maintained separately.
  • Changes to loaded components - If a workspace is saved, and then changes are made to which components are loaded in the CCM, then in rare cases problems may occur when one attempts to reload the saved workspace.


File Save Workspace.png

Opening a Saved Workspace

File->Open-Workspace.

Only one workspace at a time can be loaded in geWorkbench. Opening a saved workspace will destroy the existing workspace. For this reason, if you opt to open a workspace, you will be prompted as to whether to save the existing workspace first.


File Open Workspace.png


A dialog box will appear in which the location and file name to which to save the workspace can be chosen.


File Save Workspace Dialog.png

Creating a New Workspace

Only one workspace at a time can be loaded in geWorkbench. Creating a new workspace will destroy the existing workspace. For this reason, if you opt to create a new workspace, you will be prompted as to whether to save the existing workspace first.

A new workspace can only be created from the top level menu bar.


File New Workspace.png


Select File->New->Workspace.