• Documentation
• Find anythingGenomesGenesLiteratureOntologyMarkersPathwaysProteinsQTLDiversityDocuments

Gramene Maps and CMap Database Help Document

A. Maps Concepts

B. Searching/Browsing

C. Comparing and Customizing Maps

D. Other Help

Maps Concepts

A. Maps and Map Sets

In Maps, a map is a linear array of interconnected features. This could represent a single linkage group in the case of a genetic map, or a single contig for physical maps. Related maps are grouped into map sets. Generally, these are the result of a particular study, such as the set of linkage groups produced by a genetic mapping study. For more information about the map sets contained in the database, visit the Map Set Info page.

B. Reference and Comparative Maps

In Maps, you can use the CMap tool to compare maps. (For more information on CMap see http://www.gmod.org/cmap.) To set up a comparison, first select a reference map set, then a reference map. This serves as the basis for any comparisons that will be made. Once the reference map image has been rendered, select one or two comparative maps. These comparative maps may be added to both the left and the right of the reference map. Additional maps may be added for as long as valid comparisons are available.

C. Features and Feature Types

Any item that is positioned on a map is called a feature. The position may be either a point or an interval. Different feature types are displayed on the map image and represented by different shapes (such as horizontal tick marks [for points], line intervals, boxes, arrows, etc.) or different colors, and will be identified on the map legend. For more information on any feature, click on it to view the corresponding feature detail page.

D. Correspondences

The lines that connect features on one map to features on another map denote correspondences. These correspondences are assigned either automatically (based on feature name) or manually by the data curator to designate features on different maps that are equivalent in some manner. Different colors represent different correspondence types, and will be identified on the map legend.

Go to Top of Page

Map search/browse options

1. Maps

This page is used to view and compare maps.
1. Map searches will result in your map being displayed in the CMap Viewer. Viewer Options will be discussed in the next section.
2. Select a species from the drop-down list. Oryza sativa is the default, if you change species you will need to click "Change Species". Only map sets from this species will be displayed in the next drop-down list. Note that selecting a new reference species will reset all other map options.
3. Select a reference map set from the drop-down list, and click on "Show Selected Set's Maps". For descriptions of all the map sets, see the Map Sets link in the Maps menu above, Info page. You must select a reference map set before any of the other options become available. Note that selecting a new reference map set will reset all other map options. For example, the Gramene Annotated Nipponbare Sequence map (formerly the Gramene IRGSP Assembly) is specifically created as an ideal reference map because all maps in CMap have a reference to this map, and this allows you to compare maps without direct correlations.
4. Select a reference map from the drop-down list. The list is limited to maps that are part of the selected map set. You must first select a reference map set before this option becomes available. Choosing a reference map allows other options to become available.
5. If only one map is selected from the reference maps list, a start and stop can be specified for the map.
6. If you don't want to accept the default settings you may select how each feature type will be displayed, if at all. Choose to ignore, display or display only those features that have correspondences displayed. The "Other" value tells Maps how to handle feature types that are not on the current maps but may be on comparative maps added later. These can be changed at any time.
7. Click on "Draw Maps".

2. Map Search

• The Map Search page allows searching for a map based on species, map set, and map name (if known). For searching multiple maps by name, separate them with whitespace or commas.The results give you information about the maps, such as the Map Name, Number of related maps, Number of related maps per unit, Number of correspondences, start, stop, and numbers of each feature type on the map. This information is sortable.
• If you want to search maps with a minimum number of correspondences to other maps, use the Map Search method, which is conducted similarly to the above search, but in fewer steps.

3. Feature Search

• Type in one or more names or accession ID's in the "Feature Names" box, separating them with whitespace or commas. Names with multiple words should be enclosed with "double quotes". Use "*" or "%" as wildcards. Optionally filter by one or more species, and by one or more feature types. By default, both the feature name and alternate name fields will be searched, but this may be restricted to one or the other.
• Results are sortable by clicking on hyperlinked column headers, and returns links to the map set, map. and feature detail.

4. Matrix

The matrix will show the number of correlations between the selected reference map(s) and all maps in CMap.
1. Select your reference set options - these maps will be compared to all the maps in CMap. It is recommended to limit your reference map(s) to at least a species and/or map type or your results will be overwhelmingly large. For example, if you are looking for rice QTL maps with correlations other species, select map typs "QTL" and species "Rice".
• Select "Use Colors" and the results will be color-coded by number of correspondences.
• Select "hide empty rows" to omit those mapsets with "0" correlations
• In its initial view, the matrix shows the number of correspondences between pairs of map sets. Selected reference maps will be listed down the right hand side of the page, and across the top of the matrix will list the maps in CMap organized by map type and then species.
• The table will display the total number of correlations between each map set.There are two numbers. The first number is the number of correlations, the second number is the number of maps that contain these correlations.
2. Click on a number in a cell to view a more detailed comparison between a specific pair of map sets, broken down by map.
3. Click on a number in a cell to go to the map viewer showing a comparison of the two maps.

5. Browse by:

a. Map Sets - lists all maps in CMap, organized by species. This page displays the full and abbreviated names of the map set. (For more information on what constitutes a map set, see the map viewer help section.) Also shown are the species, map type, map units, any remarks the curator has added, and the listing of the maps in the set if the maps are allowed to act as reference maps. Optionally you may restrict the list by species and/or map type. Links to Map Set and Map details, Matrix, and map viewer.

b. Feature TypesThis page displays each feature type's name, shape, color and description; and links to search results for each feature type, from which you sort results by column, or link to the map set and map viewer, and returns you to the Feature Search (see above).

c. Map Types - Map types give Accession ID, map unit, and brief map type and map legend descriptions. Additionally, each map type is flagged as to whether or not it is considered by the curators as a "relational only" map, meaning that maps of this type can only be viewed in relation to some reference map. Links from here lead to a map type search leads back to Map Set information.

d. Species - Groups map sets by species type and map type. Links to map set data and info (for accessing the map viewer), as well as the matrix (for exploring correlations with other maps.)

Go to Top of Page

Viewing Maps and Customizing Map Options

1. Viewing Maps - CMap

Once a user has selected a reference map set and a reference map, it is immediately rendered as a map image. By default, the entire length of the map is displayed.
• At the top of the image is a box in which is printed the species, map set name, and map name as well as a combination of the following controls:
  • i: View the info page for the map set
  • ?: View the map details page for the map (for "relational" maps, click directly on the map glyph for this action)
  • X: Delete the map set from the viewer
  • x: Delete the map from the viewer
  • L: Limit this slot on only this map
  • F: Flip the map
  • UF: Unflip the map
  • M: View the Matrix for this map.
  • N: Create a new map viewer with the map as the reference
• A vertical scale bar indicates positions along the length of the map. The distance measure (e.g., cM) being used is printed at the bottom of the scale bar. Features are drawn at appropriate positions. A legend for the various feature types shown on the map is printed at the bottom of the image. Click on a feature label to view the feature details page for that feature.
  Feature Details - The feature details page lists what is known about a feature and its correspondences.
  • Acc ID -Unique accession ID.
  • Feature Type - The type of a feature.
  • Feature Name - The name of the feature. This is the text that is displayed as the feature label in the map image.
  • Aliases - Synonyms, aliases, or other names by which a feature may be known.
    • The feature alias details page shows the alias for a given feature name along with any defined attributes and cross-references.
  • Map - Map on which this feature may be found. Click on "View on Map" to see the map with the feature highlighted.
  • Start - The start position of a feature.
  • Stop - The stop position of a feature. No entry ("NULL") means that the feature is a point.
  • Cross-References and Attributes - Any links to external databases or additional attributes the curator has defined.
  • Correspondences - This table lists all the corresponding features from other maps associated with the feature. Click on the feature's name to view the feature details page for the corresponding feature. "View On Map" takes you to the appropriate map with the corresponding feature highlighted. "Comparative View" also takes you to the Map Viewer, but with both the original reference map and the corresponding map being compared.
    • The Correspondence detail page provides details about a correspondence between two features in Maps. At the top, the features are listed along with their maps, positions and feature types. There are links present to take you to the details on the map sets, maps, or the features themselves. Also present are any attributes and cross-references which have been defined by the curators. Below it you will see all the evidence supporting the correspondence along with a link to the details on each evidence.
• Note that not every feature may be labeled. The drawing algorithm will try to fit as many labels as it can, until there is no more available space. To see more labels, you may wish to increase the image size or decrease the font size. You may also specify "Start" and "End" positions to zoom in to a particular region on the reference map.
• If two or more maps are being compared, each map will be drawn in a separate regions. Adjacent maps will have correspondence lines that connect corresponding features. The color of the line depends on the type of correspondence, indicated in the legend at the bottom of the map image.
• In the lower-right-hand corner is a watermark indicating the version of CMap used to draw the map. This is also hyperlinked to the CMap homepage, http://www.gmod.org/cmap.

Go to Top of Page

2. Customizing and Comparing Maps

Once you have a map in the map viewer there are many options for customizing the view and comparing the map to other maps in CMap.
• Save Link - Links can be created using the "Save Link" button on the map viewer page. SEE Saved Link help
• Dotplot
• eliminate Orphans
• New Reference Maps

a. Map Options Menu

Each Map set displayed on the image is represented in this table. The individual maps are also displayed unless there are a large number in the slot. The reference map set is shaded a different color. This is where you can add comparative maps to your reference map.
• Add Maps Left/Add Maps Right - Click on these to add comparative maps to either/both sides.
  • Min. Correspondences - Optional, Indicate an integer value of the minimum number of correspondences that a map must have to another map in order to be displayed. Click "Refresh Menu".
  • Compare Maps (Left/Right) - Select the comparative map set (number in Brackets indicates the number of maps within the maps set with correspondences to your current reference map.
  • Select one or more of the maps to add to the viewer. Only maps which have some correspondence to the neighboring map are listed. The number of correspondences is shown in square brackets.
• Min. Correspondences - Once a comparative map has been added, this box will reflect the number you entered above when adding the map. If this number is changed, be sure to redraw map. This may be used when you have multiple maps from a map set as comparative maps, and you decide to increase the minimum number of correspondences, then maps with fewer correspondences will be dropped. HOWEVER, this does not work in reverse - if you decrease the minimum correspondences, it will not increase the number of maps from that mapset that are displayed - in this case you should delete the map set and add it again with the new minimum number of correspondences.
• Align Vertically - This option is available only for the reference set. If there are multiple reference maps, you can choose to have them side by side or stacked vertically. Click "redraw".
• Start/Stop - Each individual map has this option. It dictates the start and stop can be specified for the map.
• Magnification Each individual map has this option. It dictates the magnification of this map compared to it's original size.
• Flip Each individual map has this option. It dictates if this map is flipped. This option can also be accessed from the map, itself.

b. Feature Options Menu

• Highlight Features Enter features to highlight on the map. Separate multiple features with commas or spaces. If you wish to highlight a feature that has spaces in its name, then enclose the feature name in double quotes.
• Feature Types Select how each feature types will be handled. Choose to ignore, display or display only those features that have correspondences displayed. The "Default" value tells Maps how to handle feature types that are not on the current maps but may be on comparative maps.
• Show Labels Select which class of feature labels to show. None: Show no labels. Landmarks: Show labels of features designated as landmarks or those with correspondences. All: Show all labels that will fit in the image.
• Collapse Overlapping Features Allows you to collapse spanning features of the same type which occupy the exact same coordinates as other features.
• Include Correspondence Types Selecte how each correspondence type will be handled. Choose to ignore, use or use only those correspondences that have a score greater than or less than the specified score.
• Aggregate Correspondences Choose to draw all of the correspondences individually or draw all the correspondenses between each map as one line (the average location on each map) or two lines (the span of locations on each map).
• Correspondence lines drawn to Have the individual correspondence lines drawn to either the feature or the map.
• View Intra-slot Correspondences If correspondences have been created between maps in the same map set, you can select this to display them.
• Aggregate Evidence Types Separately - When aggregating correspondences, correspondences with different evidence types can be separated.

c. Display Options Menu

• Map Size Select the desired size of a reference map.
• Font Size Select the desired size of the fonts.
• Image Type Select the image format you prefer.
• Clean View Do not display the navigation buttons on the image. This is useful for publications.

d. Advanced Options Menu

• Draw Maps to Scale Draw the maps that have the same base units to scale with respect to each other. The base units must be defined as scalable in the config file.
• Clickable Image - To increase render time for views that display a lot of features, you can choose not to have clickable features (which leaves the navigation buttons intact) or to remove all clickable elements from the image.
• Menu Order of Comparative Maps - Order the maps in the comparative map menu by their predefined order (specified in the database) or by the number of correspondences.
• Ignore Image Map Sanity Check - If an image has an insane number of clickable elements on it this can cause a browser (IE) to crash and increases transmission and render time. When a threshold of the number of elements on an image is crossed (the number defined in the config file), Maps will disable all clickable elements and print a warning. The user can ignore this warning (at the user's peril).

Go to Top of Page

Other Help

Evidence Types	This page lists the name an evidence type, its accession ID, rank (in relation to other evidence types), the color of the line representing the correspondence, and any attributes or cross-references established by the curators.
Saved Links	Links can be created using the "Save Link" button on the map viewer page. Links are organized and accessed by link group. This can be anything the user wants. Some suggestions are some combination of user, project, department or date. Permanent Links have the session information stored in the server's database which makes it stable to use for bookmarking and for sharing. Legacy Links use the legacy link parameters. The advantage of this link is that it will be stable across different servers (with the same data). The disadvantages are that it can get longer than a browser (IE) can handle. It also cannot handle the complex options such as minimum correspondences (which can be different for each map set added in the image). Hidden links - When there are a lot of saved links, the saved link viewer page might get cluttered. Hidding a link makes it invisible to the saved link viewer (unless specifically looking for hidden links) but is still in the database so that it can be accessed (via bookmark or other system). Importing Links - Links can be imported from xml file using the cmap_admin.pl script on the server. Ask you administrator to view the ADMINISTRATION document if you wish to utilize this feature.
Tutorial	More in-depth than the help pages, use the tutorial for an exaple of using the database, see how it integrates other datasets, and get tips to increase your data search efficiency.
FAQ	Frequently Asked Questions - see what questions users have asked, and get the developers answers.
Release Notes	For more information about the most recent release.

Go to Top of Page

• Cite Gramene
• About
• Site Map
• Home