The below section provides questions and answers regarding the installation and use of GenMAPP version 2 and associated applications. For detailed instructions on how to use the GenMAPP program, please refer to the Help page, where you will find tutorials, GenMAPP Help and advanced Help topics.

 
 
  Is there a Mac or Unix version of GenMAPP available?
  Why can't I download any data?
  I can't download via the Data Acquisition Tool. Do you have an alternative download site?

  How can I download MAPPs (pathways) and gene databases for GenMAPP version 2?
  How do I get a license to use GenMAPP?

  How do I update to a new version of GenMAPP from an older Installation?
  Are my old MAPPs compatible with later builds of GenMAPP?

 
   
 
  Can I include MAPP images and GenMAPP files within or with a publication?
  Can I redistribute official GenMAPP archive MAPP files?
  Did the definition of the GenMAPP acronym recently change?
  Is GenMAPP still being developed?
 
     
   
 
  What type of expression data does GenMAPP accept (i.e. oligonucleotide arrays, cDNA, protein, etc) and ?
  How do I include exceptions after importing a dataset?
  When I import my GenBank accession numbers into GenMAPP, the vast majority of IDs are not found, how can I get these IDs into GenMAPP?

  How do I include my own internal database in GenMAPP to link to my genes to my expression data?
  Which species do you support and what do the databases contain?

  MAPPFinder produces a runtime error #3346, "Number of query values and destination fields are not the same," on European configured Windows OS, how can I fix this?
  MAPPFinder produces a runtime Run-time error ‘3075’: Syntax error in date in query expression ‘1.#INF’, how can I fix this?
  MAPPFinder analysis takes too long. What can I do?

  What are the various MAPP archives that GenMAPP distributes?
  How were the KEGG pathways converted to GenMAPP MAPPs?
  Why do the pathways on the KEGG site show EC numbers while the GenMAPP MAPPs show gene names?
  How should I use the converted KEGG MAPPs?
  I have found that some objects on the converted KEGG MAPPs are overlapping with objects on the MAPP. Can you prevent this?

  How do I export a MAPP image as vector image (i.e. EPS, PDF)?
  How do I reduce the number of significant digits for the data I choose to display on the MAPPs?
  Can I run GenMAPP on an Intel-based Mac computer?
 
     
   
 
  Is there a Mac or Unix version of GenMAPP available?
   

The current GenMAPP has been written in Visual Basic and is therefore limited to computers running the Windows operating system. For other operating systems, we recommend the PathVisio program, which has the same functionality as GenMAPP in terms of pathway viewing and editing, data representation and analysis. For pathway and GO over-representation analysis, we also recommend the GO-Elite program.
The next version of GenMAPP will have a platform-independent implementation.
For information on current open-source development of GenMAPP and how to participate, click here.


  Why can't I download any data?
    The GenMAPP 2 databases are relatively large, ranging from 4-500MB. If downloading is failing in the Data Acquisition Tool, try switching your preferred download site. Consistently failed downloads might be due to your company's firewall protection, contact us at genmapp@gladstone.ucsf.edu or try our alternative download site http://root.genmapp.org/dtr/.

  I can't download via the Data Acquisition Tool. Do you have an alternative download site?
    It may not be possible for you to access the GenMAPP download site via the Data Acquisition Tool due to firewalls. Our alternative download site has Gene Databases, MAPP Archives and Expression Datasets for all GenMAPP supported species: http://root.genmapp.org/dtr/, where files are organized by species. By double-clicking on the downloaded archive files, the appropriate Gene Database, MAPP Archive, or example Expression Dataset file will be automatically extracted into the directory you downloaded to. Please note, it is recommended that users primarily use the Data Acquisition Tool for all downloads unless problems persist, as additional file information and download options are provided.

  How can I download MAPPs (pathways) and gene databases for GenMAPP version 2?
    Only a few tutorial MAPPs along with a tutorial expression dataset and gene database are provided by default with GenMAPP 2. However, gene databases and MAPPs for a number of species can be downloaded using the Data Acquisition Tool under the Data menu in GenMAPP. Select files for download and select the folder you want to download to. Immediately following download the files will automatically extract into the specified download folders.

  How do I get a license to use GenMAPP?
    GenMAPP is free of charge to the entire scientific community. To download GenMAPP, simply register here.
Source code for GenMAPP 2 applications is available at SourceForge.net (
http://sourceforge.net/projects/genmapp), under an Apache open source license agreement. In addition to GenMAPP 2, source code contributed by the GenMAPP development community will be posted here. To post new source code here, please contact us at: genmapp@gladstone.ucsf.edu.

  How do I update to a new version of GenMAPP from an older Installation?
   

If you are upgrading from a previous version of GenMAPP (version 1.0 or 1.0 beta), you are not required to uninstall your previous version of GenMAPP, however, GenMAPP file associations (MAPP files and GEX files) will be associated with the latest installed version. Any custom MAPPs can be converted to GenMAPP 2 format using the Converter tool. Expression Datasets (Gex files) can also be converted, but we highly recommend that data be re-imported from scratch instead. Please see GenMAPP Help for more information.


  Can I include MAPP images and GenMAPP files within or with a publication?
    We encourage GenMAPP users to use MAPP file images in publications and on the web. More about exporting publication quality images can be found below. Although MAPPs contain a copyright, this only serves to ensure proper author and institution information is included with any publication. We recommend that author information is included in the figure legend of any publication, since a large number of MAPPs are contributed by users like you and require specific citing. Likewise, if you publish a new MAPP within a journal, we highly encourage you to submit your MAPP file to GenMAPP.org for redistribution (e-mail genmapp@gladstone.ucsf.edu). To cite GenMAPP or MAPPFinder versions 1.0 or 2, please use the appropriate version 1.0 publication references found here.

  Can I redistribute official GenMAPP MAPP archive files?
   

GenMAPP distributed MAPP files are governed by the Creative Commons Attribution-Noncommercial-Share Alike 3.0 Unported license. For details on this license, visit Creative Commons.


  Did the definition of the GenMAPP acronym recently change?
   

On August 12, 2004, we revised the GenMAPP acronym from "Gene MicroArray Pathway Profiler" to "Gene Map Annotator and Pathway Profiler". This change has been made in light of the fact that GenMAPP is now used for a wide variety of data types in addition to microarray data (e.g. gene trapping, SNPs, functional genomic experiments). The new GenMAPP definition reflects the use of GenMAPP to annotate pathways for use with any type of genomic data. If preparing a manuscript referencing the definition of GenMAPP, please use the new definition and additionally reference http://www.genmapp.org.


  Is GenMAPP still being developed?
   

The next version of the GenMAPP software, GenMAPP-CS, is currently being developed and a beta version is expected in 2011. GenMAPP-CS is being developed as an open-source, Java-based program integrated into Cytoscape, and will include greatly expanded visualization and analysis options. Detailed development plans are available on our wiki. We are also developing WikiPathways, a community wiki for pathway curation and editing.
While GenMAPP 2.0 is no longer actively developed in its current form, it is still fully supported.


  Are my old MAPPs compatible with later builds of GenMAPP?
    GenMAPP version 2 contains a Converter tool that will help you convert your version 1.0 MAPPs to version 2 compatible format. Some IDs on MAPPs may not be converted with this tool. Please check the gene IDs on your converted MAPPs.

  Where can I get a list of descriptions for each drafting tool and its properties?
    GenMAPP Help provides information on all objects available for pathway editing. GenMAPP Help is available from the Help menu in GenMAPP and here.

  What type of expression data does GenMAPP accept (i.e. oligonucleotide arrays, cDNA, protein, etc)?
   

Data for use in GenMAPP must have a primary ID supported by GenMAPP. For a list of supported ID systems, see GenMAPP Help. If your data is not annotated with any of the supported ID systems, you have a variety of options. As a preferred method, please convert your primary GenBank accession numbers, clonal IDs, or microarray specific IDs to an ID supported by the Gene Database of interest. Several conversion tools are publicly available, see a list of common ones here.
In addition, the GenMAPP 2 Gene Databases allow for addition of any user-defined ID system. For details on how to customize a database or create a database for a non-supported species, see our Custom Database Manual or GenMAPP Help.
If none of these options apply, please contact us at: genmapp@gladstone.ucsf.edu


  How do I include exceptions after importing a dataset?
    Exceptions during GenMAPP data import are rows of data that could not be imported to GenMAPP. Exceptions can be caused by problems with formatting or gene IDs. You can process exceptions by correcting the error in the exceptions file (.EX.txt) and then importing the file again. For example, you can assign alternative IDs to Gene IDs not found by GenMAPP. Exceptions may occur due to a variety of other reasons (please refer to comments in the exception file and GenMAPP Help). If the problems with import can not be corrected, please contact us at genmapp@gladstone.ucsf.edu.

  Which species do you support and what do the databases contain?
    Detailed information on which species are supported by GenMAPP and what each of the available gene databases contain can be found here.

  How do I include my own internal database in GenMAPP to link my genes to my expression data?
    GenMAPP allows for addition of any user defined ID system to the database. Please see GenMAPP Help for details.

  MAPPFinder produces a runtime error #3346, "Number of query values and destination fields are not the same," on European configured Windows OS, how can I fix this?
   

Some European users have experienced difficulties using MAPPFinder due to the use of a comma "," as the decimal separator on European-configured operating systems. MAPPFinder relies on SQL statements which use commas to separate variables in the query statement, so the comma decimal separator creates problems. To fix this problem, in Windows go to Start->Settings->Control Panel->Regional Options. In regional options, there is a tab menu called "Numbers." In this menu you'll see a text box titled "Decimal Symbol. Make sure that your decimal symbol is a period "." not a comma or any other character.

  MAPPFinder produces a runtime Run-time error ‘3075’: Syntax error in date in query expression ‘1.#INF’, how can I fix this?
    Some users have experienced difficulties using MAPPFinder when their system settings for Date is formatted as "mm-dd-yyyy" or "dd-mm-yyyy". This setting is especially common on European configured Windows OS. To fix this problem, in Windows 2000 go to Start->Settings->Control Panel->Regional Options. In regional options, there is a tab menu called "Date." Change the Short Date format to "M/d/yyyy". In Windows XP, under Control Panel->Regional Options, change the Short Date field to M/d/yyyy.
  MAPPFinder analysis takes too long. What can I do?
    Depending on your system's configuration, a typical MAPPFinder analysis may take a long time to finish, or in some cases may appear to be stalled. This is because MAPPFinder requires significant memory allocations to run. If you are having trouble running MAPPFinder, please consider trying the GO-Elite program. GO-Elite does not have the same performance issues as MAPPFinder and also includes an improved algorithm to identify a minimal non-redundant set of Gene Ontology (GO) biological terms or pathways. GO-Elite works with both GO terms and pathways, just like MAPPFinder and results are formatted like the MAPPFinder results files.

  How do I export a MAPP image as vector image (i.e. EPS, PDF)?
   

GenMAPP is a vector-based graphics program and thus has the intrinsic capacity to export MAPP images in a vector format. Although there currently isn't a supported vector export function within GenMAPP, users with an full version of Adobe Acrobat 4.0 or higher, have the ability to print as a PDF file from any vector based program. For more information on this product, go to: http://www.adobe.com/products/acrobat/main.html. The resulting exported PDF file can now be modified in a variety of vector based drawing programs (i.e. importing as PDF in Adobe Illustrator or changing the file extension to .eps for import into other drawing programs).


  What are the various MAPP archives that GenMAPP distributes?
    GenMAPP distributes several different archives of pathway MAPPs, that are continually updated. Detailed descriptions and statistics on all distributed MAPP archives can be found here. GenMAPP pathways can also be browsed at WikiPathways.

  How were the KEGG pathways converted to GenMAPP MAPPs?
   

The pathways in the "KEGG_Converted" archive were converted using the KGML supplied by KEGG (V2). Sometimes the KGML does not exactly match the graphical representation given by KEGG and this is reflected in the GenMAPP MAPPs.


  Why do the pathways on the KEGG site show EC numbers while the GenMAPP MAPPs show gene names?
   

The EC numbers provided by KEGG are enzyme IDs, and have different genes associated with them for each respective species. On the KEGG website you can see these genes when you click on a colored EC box. In GenMAPP, we chose to display the gene names instead of the EC numbers, when available. In the case where an EC number has many genes associated with it, we attempt to show all associated genes.


  How should I use the converted KEGG MAPPs?
   

These MAPPs are provided as a starting point for further curation. In some cases, you will be able to use a KEGG converted MAPP with some editing, instead of starting from scratch.


  How do I reduce the number of significant digits for the data I choose to display on the MAPPs?
   

Currently, GenMAPP doesn't allow you to choose the number of significant digits to be displayed on the MAPPs. It will simply display the numbers as they appear in your raw input file. To change the way numbers are displayed on the MAPPs, change the data before import to GenMAPP. If you are working in Excel, you can do this by selecting the field of data you want to alter, and then choosing Format – Cells. Under the Number tab, you can set the number of decimal points to your liking.


  I have found that some objects on the converted KEGG MAPPs are overlapping. Can you prevent this?
   

Not at this time. Please carefully review each map.


  When I import my GenBank accession numbers into GenMAPP, the IDs are not found, how can I get these IDs into GenMAPP?
    Due to the large EST libraries included in the GenBank database, there are an extremely large number of Genbank accession numbers that can be used to represent the same gene. Including this large number of accession numbers in the GenMAPP Gene Database is impossible due to database size restrictions. For a list of supported ID systems, see GenMAPP Help. If your data is not annotated with any of the supported ID systems, you have a variety of options. As a preferred method, please convert your primary GenBank accession numbers, clonal IDs, or microarray specific IDs to an ID supported by the Gene Database of interest. Several conversion tools are publicly available, see a list of common ones here.
In addition, the GenMAPP 2 Gene Databases allow for addition of any user-defined ID system. For details on how to customize a database or create a database for a non-supported species, see our
Custom Database Manual or GenMAPP Help.
If none of these options apply, please contact us at genmapp@gladstone.ucsf.edu
  Can I run GenMAPP on an Intel-based Mac computer?
    GenMAPP has been successfully tested on Intel-based Macintosh computers under Parallels and Boot Camp. The only known problem is in Parallels, where the Data Acquisition Tool (Downloader is not able to connect to the GenMAPP servers. The workaround for this is to download databases, MAPPs and other accessory files direclty from our alternative download site (http://root.genmapp.org/dtr/), using an internet browser.
If you have other problems running GenMAPP on Intel-based Macs, please contact us at genmapp@gladstone.ucsf.edu
 

 

Creative Commons License