NIH | National Cancer Institute | NCI Wiki  

Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.
Comment: Migration of unmigrated content due to installation of a new plugin
Include Page
caIntegrator:Document DisclaimercaIntegrator:Document Disclaimer
Scrollbar
iconsfalse

Page info
title
title

Column
 
Section
 

This section chapter introduces general caIntegrator procedures and how to obtain help to use caIntegrator.

Topics in this chaptersection chapter include:

...

Table of Contents

...

minLevel2

About caIntegrator

NCI , Center for Biomedical informatics Informatics and Information Technology (CBIIT) is developing a novel translational informatics platform called AnchorRTF6361496e7465677261746f72RTF6361496e7465677261746f72 caIntegrator that allows researchers and bioinformaticians to access and analyze subject annotation and experimental data across multiple subject annotation trials and studies. The caIntegrator framework provides a mechanism for integrating and aggregating biomedical research data and provides access to a variety of data types (e.g. Immunohistochemistry for example, immunohistochemistry (IHC), microarray-based gene expression, SNPs, subject annotation trials data, imaging data, etc.) in a cohesive fashion.
AnchorRTF6361496e7465677261746f72RTF6361496e7465677261746f72

caIntegrator is a web based or locally installed portal that allows researchers and study managers to access the biomedical informatics infrastructure and data analysis tools established by caIntegrator from one common software platform. As a caIntegrator user, you can perform the following tasks:

  • Integrate subject annotation data with genomic and/or imaging data
  • Import data of various types in a predefined flat format, and create new studies with multiple study data
  • Update an existing study to add new attributes or to add/modify data
  • Perform analyses on study data

Registering as a New caIntegrator User

To request a caIntegrator usercaIntegrator:requesting user account; account, requesting new user;registering new user account, you must register as a new user, completing the following steps:

  1. Go to the CBIIT caIntegrator login page or use the URL provided by your System Administrator for the caIntegrator instance at your institution.
  2. Click the Register Now hypertext link, under the caIntegrator login section in the upper left lower center of the page. This opens the account registration form (). Image Removed
  • New user account registration form
  1. Enter the appropriate information. Fields

    In the Register form, enter the appropriate informationItems

    with an asterisk

    or highlight

    are required

    .

    .

    Security Information

...

  1. Entry

...

  1. Do

...

  1. you

...

  1. have

...

  1. an

...

  1. LDAP account?

    An LDAP

...

  1. account

...

  1. is a

...

  1. user

...

  1. profile

...

  1. you may have with

...

  1. your

...

  1. institution

...

  1. or CBIIT. If you answer Yes, enter your username and

...

  1. password

...

  1. . This allows caIntegrator to verify that your credentials are correct.

    If caIntegrator does not validate your LDAP profile, you are asked to reenter your credentials. You can choose to answer No. In this case, the System Administrator will manually ensure that you

...

  1. do not get a duplicate LDAP account during provisioning. You can

...

  1. then cancel the action or talk with your System Administrator about the problem.

...



  1. If

...

  1. you

...

  1. select

...

  1. No (you do not have an LDAP account), the text boxes for entering the LDAP account information disappear. You must indicate the role you would like to be assigned in caIntegrator, and continue entering the appropriate information in the Account Details section.

    Info
    titleNot logged in?

    After you submit your registration request, you can continue to use caIntegrator without an account to browse and search available data while your account is verified and activated.

    Username

    Enter your LDAP user name.

    LDAP Password

    Enter your password. Your password is case-sensitive.

    Anchor
    caIntegratorRoles
    caIntegratorRoles
    Requested role(s)

    Select one or more of the roles, described in this table:

    Include Page
    caIntegrator roles
    caIntegrator roles
    .

  2. Enter your account details. Field names followed by asterisks are required.
  3. Click Submit Registration Request. Click Cancel to terminate the registration. A Registration Request confirmation page appears if you submit the request.

The registration workflow continues as follows.

  1. The caIntegrator system administrator receives

...

Role

...

Description

...

Permissible Actions

...

Study Manager

...

Creates, owns and manages studies

...

Configures and deploys studies
Assign annotations to studies
Edits studies
Search studies
Perform analyses on study data

...

Study Investigator

...

Investigates and queries the study data

...

Query study data
Save queries
Analyze using K-M Plot
Analyze using Gene Expression Plots
Analyze using GenePattern

...

 

...

 

  • Wiki Markup
    \[jpm\] study manager configures and deploys the study, adds or removes study data.  Study Investigator - queries the study after the study manager deploys it.
  • Account Details
  • First Name{}*
  • Last Name{}*
  • Wiki Markup
    *Email \[address\]{*}<span style="color: #ff0000">{<strong>}</strong>*</span>
  • Organization{}*
  • Wiki Markup
    *Address \[Lines 1{*}<span style="color: #ff0000">{<strong>}</strong>*</span> *and 2\}*
  • City{}*
  • State{}*
  • Country{}*
  • Wiki Markup
    *Postal \[or Zip\] Code{*}<span style="color: #ff0000">{<strong>}</strong>*</span>
  • Phone{}*
  • Fax
  1. Click Submit Registration Request to execute the request, or click Cancel to abort the registration.

After registration is sent, the screen displays a confirmation message.

...

  1. an email containing all of the information you specified in the new user request form

...

  1. .
  2. An account request confirmation email is also sent to you, the prospective user, at your specified email address.

...

  1. The system administrator

...

  1. creates your user account and

...

  1. sends you an email verification.
  2. You can log in to caIntegrator.

    Info
    titleWhile your account is activated

    Once you register, you can continue to use caIntegrator without an account to browse and search publicly available data and download data while your account is being activated.

When your account is registered, the user ID UserID and password you are assigned determine determines your access rights for the softwarefor the data in the system. Access rights include roles for the application as well as instance level security; they are provisioned to your account by the system administrator.

For information about administering user accounts, see 7 - Administering User Accounts.

Welcome to the caIntegrator Workspace

The caIntegrator :workspacecaIntegrator:using workspacecaIntegrator Welcome workspace enables quick access to all caIntegrator functions and information before and after you login. The Welcome page also displays after you log in, before you open any studies (). Image Removed

Anchor

...

login

...

login
Logging In

  • Without logging in, you can browse any public studies. To do so, select from the drop-down list of

...

  • Public Studies in the upper

...

  • center of your browser

...

  • .

...

  • Use the customary steps to log into caIntegrator

...

  • . If your login is successful, the Welcome to Browse/Study page appears.
Info
titleSingle Sign-on (SSO).

If your local installation of caIntegrator is configured with single sign-on, when you click the login button, you are redirected to the single sign-on login page hosted by a separate SSO server. Once you enter your credentials there, you are logged into both caIntegrator and caArray. You can navigate between the two applications without being challenged to provide login credentials again.

  • If SSO is not enabled, continue working in caIntegrator after you log-in as you always have done.
  • If SSO is enabled, you might want to check for data updates in caArray upon user login. This is applicable only to studies that you have access to.

caIntegrator Functions

...

To access caIntegrator functions, use the options listed on the left sidebar of the workspace .

caIntegrator Functions

Once a study is created, its caIntegrator sidebar on the left side of the page. The following table describes each caIntegrator option in the workspace ()and described in the following table.

<ac:structured-macro ac:name="unmigrated-wiki-markup" ac:schema-version="1" ac:macro-id="a82ebdc1-4d50-47e5-b86f-cfb92fcc24fd"><ac:plain-text-body><![CDATA[

Sidebar Option

Function

[Study Name]

When you log in, one study displays in the left sidebar by default. Any study that you select in the My Studies drop-down list in the upper right of the page replaces this default selection.]]></ac:plain-text-body></ac:structured-macro>

Home

Click this to return to the home page for the selected study.

<ac:structured-macro ac:name="unmigrated-wiki-markup" ac:schema-version="1" ac:macro-id="a636d0b0-14eb-421a-8e37-f102b99f1c89"><ac:plain-text-body><![CDATA[

Search [Study Name]

Click this option to open the Search [Study Name] page from which you can launch queries into your selected study. For more information, see .]]></ac:plain-text-body></ac:structured-macro> 4 - Searching a caIntegrator Study.

Study Data

Click Saved Queries > My Queries to open the list of previous queries you saved. Click any item in the list to open the saved query, which displays on the Criteria, Columns and Sorting tabs. From those tabs, you can modify criteria and/or launch the query again. For more information, see on page 62 Saving a Query.
Click Saved Lists > Global Lists or > My Lists to open gene lists that have been saved for a study. From any page in caIntegrator that shows such a group, you can save a such a list of genes to be used for searches or analyses. See on page 69 Creating a Gene or Subject List.
Click Saved Copy Number Analysis to open an Edit GISTIC Analysis page. You can review genes retrived retrieved from the analysis or, with appropriate permissions, you can edit the metadata for the analysis. See on page 74 Editing a GISTICAnalysis.

Analysis Tools

Click any of the listed options to open a page where you can launch an analysis of the data in the selected study.

Study Management

Click either of the listed options to manage the selected study through editing or deleting it or by creating a new study.

Application Management

Click Manage Platforms to identify, add or remove platforms that caIntegrator supports. For more information, see on page 47 Managing Platforms.

caIntegrator Menu

  • Click Support to view contact information for Application Support.
  • Click Tutorials to view a tutorial to help you get started using caIntegrator.
    Click User Guide to open the caIntegrator v.1.3 User's Guide in PDF format User Guide to open the caIntegrator User's Guide.

Help

Click the Help icon at the top of each page to open a context-sensitive topic. The help page displays information (from this user's guide) that corresponds to the page from which help was opened.

In the My Studies drop-down list in the upper right of the page, select the study you want to use for your current session. (The list includes all studies to which you are subscribed as well as public studies.) As you do so, the following left sidebar contents change to reflect options relevant to your study selection:

  • the logo for the selected study (if it exists)
  • the name for the selected study
  • the list of saved queries and/or saved lists for that study

Viewing Existing Studies

  • If you have not logged into caIntegrator, you can view any public studies in your browser.
  • After logging in, you can view existing studies for which you have been granted permission as well as public studies. In the upper right corner of the page, in the My Studies drop down list, shown in the following figure, select the study you want to review or work in.

...

  • Drop-down list for selecting existing studiesImage Added

A study summary

...

The study you select opens in the browser. You can review the study data for which you have been granted permission.

After selecting the study name, in the My Studies drop-down list, a study summary should appear, including a status field should appear for the study you selected. If the status is not deployed, or if the study summary does not appear, then the study is not deployed and available for analysis.

When the annotations are uploaded during the creation of the study, each field is defined by the study manager.

  • Because in looking at the study, you may not know the meaning of all the annotations, you can open a reference page with a summary of the annotations. Click the Data Dictionary: View link on the study home page, as shown described in the following screen shotsection.
  • From the study summary page, you can also open a log for the study. Click the Study Log: View link on the page to see all log entries with descriptions. See Study Log for more information.

Data Dictionary

A link on a study home page, as shown by the arrow in the following screen shot, opens a data dictionary summary. Image Removed
The link to open the Data Dictionary is identified by an arrowImage Added

The Data Dictionary consists of a table that table, shown in the following figure, clarifies all annotations used in the study. It displays their field descriptors, descriptions, caDSR identifiers (if used), caDSR IDs and definitions, data type, and permissible settings, shown in the following figure. The Restrictions column indicates whether or not masks have been applied to numeric data in the study. For more information, see on page 23.. Image Removed

...

Assigning an Identifier or Annotation.
The table for viewing details in the data dictionaryImage Added

For more information about study details, see on page 17 Creating or Editing a Study.

Study Log

The study log which you can open by clicking the Study Log > View link on the study summary page lists the steps used to create a study. For more information, see on page 18.

...

Viewing or Editing a Log.

Logging Out

To log out of caIntegrator, click the logout link in the upper right-hand corner of the page.

Using caIntegrator Online Help

The caIntegrator online help is in user's guide /online help format. It explains how to use all of the features .
To access online help, click the help icon at the top of each page to open a context-sensitive topic. Context-sensitive help displays information that corresponds to the page from which help was opened.

Logging Out

To caIntegrator:logging outlog out of caIntegrator, click the link in the upper right-hand corner of the page.

Application Support

For any general information about the application, application support or to report a bug, contact NCICB Application Support.

...

Email:

...

When submitting support requests via email, please include:

  • Your contact information, including your telephone number.
  • The name of the application/tool you are using
  • The URL if it is a Web-based application
  • A description of the problem and steps to recreate it.
  • The text of any error messages you have received

...

Application Support URL

...

 

of the caIntegrator portal.

Info
titleNot logged in?

You can open the user's guide without being logged into caIntegrator.

To access the user's guide in caIntegrator, click the Help icon/menu options available in the upper right corner of the user interface (help buttonImage Added) and on the left sidebar under the caIntegrator Menu section. When you click the help icon, context sensitive topics relevant to the page open for your assistance.

Help and additional resource links remain fixed through all the user interface pages.

Scrollbar
iconsfalse

...

Telephone: 301-451-4384Toll free: 888-478-4423

...