Difference between revisions of "MarkUs"

(Private Key)
Line 6: Line 6:
 
MarkUs is a web server to assist the assessment of the biochemical function for a given protein structure. MarkUs identifies related protein structures and sequences, detects protein cavities, and calculates the surface electrostatic potentials and amino acid conservation profile. The results can be browsed by an interactive web interface that allows one to integrate Gene Ontology terms, UniProt features, and the Enzyme Classification.  The MarkUs website is at http://luna.bioc.columbia.edu/honiglab/mark-us/cgi-bin/submit.pl.
 
MarkUs is a web server to assist the assessment of the biochemical function for a given protein structure. MarkUs identifies related protein structures and sequences, detects protein cavities, and calculates the surface electrostatic potentials and amino acid conservation profile. The results can be browsed by an interactive web interface that allows one to integrate Gene Ontology terms, UniProt features, and the Enzyme Classification.  The MarkUs website is at http://luna.bioc.columbia.edu/honiglab/mark-us/cgi-bin/submit.pl.
  
MarkUs is available as a local or grid service in geWorkbench.  Details about running grid services are available in the [[Tutorial_-_Grid_Services | Grid Services]] tutorial.
+
MarkUs is available as a local or grid service in geWorkbench.  Details about running grid services are available in the [[Grid_Services | Grid Services]] tutorial.
 +
 
 +
 
 +
==MarkUs Server Documentation==
 +
 
 +
===Direct Submission of a job to the MarkUs server===
 +
http://luna.bioc.columbia.edu/honiglab/mark-us/cgi-bin/submit.pl
 +
 
 +
This page contains a concise description of the goals of the MarkUs server and a link to the direct web job submission page.
 +
 
 +
 
 +
===MarkUs Server NESG tutorial===
 +
http://luna.bioc.columbia.edu/honiglab/nesg/documentation/tutorial.html
 +
 
 +
Step by step illustration of submitting a job and interpreting the results.
 +
 
 +
 
 +
===Detailed Overview of MarkUs Analysis===
 +
http://luna.bioc.columbia.edu/honiglab/nesg/documentation/index.html
 +
 
 +
Describes each aspect of the Markus analysis results and their presentation.
  
  
Line 32: Line 52:
  
 
[[Image:MarkUs_Retreive_Prior.png]]
 
[[Image:MarkUs_Retreive_Prior.png]]
 +
 +
 +
==Results==
 +
 +
===Private Key===
 +
 +
The figure below depicts three separate runs of MarkUs.  In the first two, the "Private Key" checkbox was checked in the Parameters tab.  The result node name in this case, e.g. "MUS2743&key=QZ860109" contains both the job name, e.g. MUS2743, as well as the private key following the label "key=", in this case "QZ860109". 
 +
 +
For jobs which requested a private key, you will need to supply that key in the "Retrieve Prior" tab if you wish to view the results in another invocation of geWorkbench.
 +
 +
 +
[[Image:MarkUs_Private_Keys.png]]
 +
 +
===Result Viewer===
 +
 +
The result of the analysis is returned to a web-browser window displayed within geWorkbench.  The run may take a considerable amount of time to finish, and partial results will be displayed.  The window does not auto-refresh.  To see the most recent results, right-click on the result display window and select "refresh".
 +
 +
 +
[[Image:MarkUs_1e09_Result.png]]
 +
 +
==Services (Grid)==
 +
See the [[Tutorial_-_Grid_Services | Grid Services]] section for further details on setting up a grid job.
  
  
Line 73: Line 115:
  
 
10. If the "Private Key" checkbox was checked, copy down the private key from the new result node in the Project Folders component.
 
10. If the "Private Key" checkbox was checked, copy down the private key from the new result node in the Project Folders component.
 
 
==Results==
 
 
===Private Key===
 
 
The figure below depicts three separate runs of MarkUs.  In the first two, the "Private Key" checkbox was checked in the Parameters tab.  The result node name in this case, e.g. "MUS2743&key=QZ860109" contains both the job name, e.g. MUS2743, as well as the private key following the label "key=", in this case "QZ860109". 
 
 
For jobs which requested a private key, you will need to supply that key in the "Retrieve Prior" tab if you wish to view the results in another invocation of geWorkbench.
 
 
 
[[Image:MarkUs_Private_Keys.png]]
 
 
===Result Viewer===
 
 
The result of the analysis is returned to a web-browser window displayed within geWorkbench.  The run may take a considerable amount of time to finish, and partial results will be displayed.  The window does not auto-refresh.  To see the most recent results, right-click on the result display window and select "refresh".
 
 
 
[[Image:MarkUs_1e09_Result.png]]
 
 
==Services (Grid)==
 
See the [[Tutorial_-_Grid_Services | Grid Services]] section for further details on setting up a grid job.
 
 
==MarkUs Server Documentation==
 
 
===Direct Submission of a job to the MarkUs server===
 
http://luna.bioc.columbia.edu/honiglab/mark-us/cgi-bin/submit.pl
 
 
This page contains a concise description of the goals of the MarkUs server and a link to the direct web job submission page.
 
 
 
===MarkUs Server NESG tutorial===
 
http://luna.bioc.columbia.edu/honiglab/nesg/documentation/tutorial.html
 
 
Step by step illustration of submitting a job and interpreting the results.
 
 
 
===Detailed Overview of MarkUs Analysis===
 
http://luna.bioc.columbia.edu/honiglab/nesg/documentation/index.html
 
 
Describes each aspect of the Markus analysis results and their presentation.
 

Revision as of 16:26, 16 June 2011

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

MarkUs is a web server to assist the assessment of the biochemical function for a given protein structure. MarkUs identifies related protein structures and sequences, detects protein cavities, and calculates the surface electrostatic potentials and amino acid conservation profile. The results can be browsed by an interactive web interface that allows one to integrate Gene Ontology terms, UniProt features, and the Enzyme Classification. The MarkUs website is at http://luna.bioc.columbia.edu/honiglab/mark-us/cgi-bin/submit.pl.

MarkUs is available as a local or grid service in geWorkbench. Details about running grid services are available in the Grid Services tutorial.


MarkUs Server Documentation

Direct Submission of a job to the MarkUs server

http://luna.bioc.columbia.edu/honiglab/mark-us/cgi-bin/submit.pl

This page contains a concise description of the goals of the MarkUs server and a link to the direct web job submission page.


MarkUs Server NESG tutorial

http://luna.bioc.columbia.edu/honiglab/nesg/documentation/tutorial.html

Step by step illustration of submitting a job and interpreting the results.


Detailed Overview of MarkUs Analysis

http://luna.bioc.columbia.edu/honiglab/nesg/documentation/index.html

Describes each aspect of the Markus analysis results and their presentation.


Parameters

Main

MarkUs Parameters.png


DelPhi

MarkUs DelPhi Parameters.png


ConSurf

MarkUs ConSurf Parameters.png


Retrieve Prior Jobs

MarkUs Retreive Prior.png


Results

Private Key

The figure below depicts three separate runs of MarkUs. In the first two, the "Private Key" checkbox was checked in the Parameters tab. The result node name in this case, e.g. "MUS2743&key=QZ860109" contains both the job name, e.g. MUS2743, as well as the private key following the label "key=", in this case "QZ860109".

For jobs which requested a private key, you will need to supply that key in the "Retrieve Prior" tab if you wish to view the results in another invocation of geWorkbench.


MarkUs Private Keys.png

Result Viewer

The result of the analysis is returned to a web-browser window displayed within geWorkbench. The run may take a considerable amount of time to finish, and partial results will be displayed. The window does not auto-refresh. To see the most recent results, right-click on the result display window and select "refresh".


MarkUs 1e09 Result.png

Services (Grid)

See the Grid Services section for further details on setting up a grid job.


Running MarkUs

The starting point for a MarkUs analysis is a PDB protein structure file.

1. If the MarkUs component has not been loaded in the Component Configuration Manager (CCM), first do so.

2. Load a PDB file for the protein whose structure you would like to analyze.

3. Set the desired parameters. Note that some analyses have check-boxes next to them which are grayed-out. These analyses are always run as part of a MarkUs job and cannot be left out.

4. If the "private key" checkbox is checked, MarkUs will generate a private key which will be displayed in the result node in the Project Folders compnent.

5. Inspect and adjust if desired the parameters to DelPhi. DelPhi calculates the electrostatic field around the molecule.

6. MarkUs is available in geWorkbench as a local or grid service. Both local and grid job submission are asynchronous and to the same server, so there is no advantage to using the grid service.

The figure below shows the local service as selected.

MarkUs Services empty.png


To select the grid service for MarkUs,

  • Click on the Services tab.
  • Push the "Grid Services" button. This will retrieve available MarkUs grid services from an index server.
  • Select the radio button for the desired grid service.


MarkUs Services grid selected.png


7. Return to the Parameters tab.

8. Push the "Analyze" button.

9. A result node will be created in the Project Folders component.

10. If the "Private Key" checkbox was checked, copy down the private key from the new result node in the Project Folders component.