Difference between revisions of "The GenGIS Manual"

From The GenGIS wiki
Jump to navigationJump to search
Line 10: Line 10:
 
GenGIS is designed to bring these components together into a single software package that satisfies the following criteria:
 
GenGIS is designed to bring these components together into a single software package that satisfies the following criteria:
  
- '''Free and open source'''. GenGIS is released under a *** license, and we have made extensive use of other free packages such as wxWidgets, R, and Python. Making GenGIS freely available allows it to be downloaded and used anywhere in the world, and allows users to inspect and modify the source code.
+
'''Free and open source'''. GenGIS is released under a *** license, and we have made extensive use of other free packages such as wxWidgets, R, and Python. Making GenGIS freely available allows it to be downloaded and used anywhere in the world, and allows users to inspect and modify the source code.
  
- '''User-friendly'''. Although GenGIS is built to deal with challenging scientific questions, our goal is to make the software as easy to use as possible. This is particularly important as many users will have little experience with digital map data, apart from applications such as Google Earth.
+
'''User-friendly'''. Although GenGIS is built to deal with challenging scientific questions, our goal is to make the software as easy to use as possible. This is particularly important as many users will have little experience with digital map data, apart from applications such as Google Earth.
  
- '''Adaptible and extensible'''. The principal strength of many open-source projects lies in the ability of a loosely organized community of users to develop and enhance the software: R and BioPerl are two examples of successful open-source projects with many contributors. Since the potential applications of GenGIS are much broader than those we have in mind, we aim to make it as easy as possible to extend its capabilities by exposing the internal data structures and offering a plugin architecture.
+
'''Adaptible and extensible'''. The principal strength of many open-source projects lies in the ability of a loosely organized community of users to develop and enhance the software: R and BioPerl are two examples of successful open-source projects with many contributors. Since the potential applications of GenGIS are much broader than those we have in mind, we aim to make it as easy as possible to extend its capabilities by exposing the internal data structures and offering a plugin architecture.
  
 
=== Platforms ===
 
=== Platforms ===

Revision as of 18:10, 4 March 2009

A recent version of the manual is also available in Media:.PDF format.

Contents

Introduction / Overview of GenGIS

Purpose

Geography has always been an important component of evolutionary and ecological theory. But the advent of sequence typing approaches such as 16S ribotyping, DNA barcoding using the COX1 gene, and multi-locus sequence typing, gives us the opportunity to understand how communities of organisms interact, move around and evolve. This sequencing revolution is tightly coupled to the development of new algorithms for assessing and comparing populations based on their genes.

Coupled with these developments is the ready availability of high quality, public domain digital map data. By integrating molecular data with cartography and habitat parameters, we can visualize the geographic and ecological factors that influence community composition and function.

GenGIS is designed to bring these components together into a single software package that satisfies the following criteria:

Free and open source. GenGIS is released under a *** license, and we have made extensive use of other free packages such as wxWidgets, R, and Python. Making GenGIS freely available allows it to be downloaded and used anywhere in the world, and allows users to inspect and modify the source code.

User-friendly. Although GenGIS is built to deal with challenging scientific questions, our goal is to make the software as easy to use as possible. This is particularly important as many users will have little experience with digital map data, apart from applications such as Google Earth.

Adaptible and extensible. The principal strength of many open-source projects lies in the ability of a loosely organized community of users to develop and enhance the software: R and BioPerl are two examples of successful open-source projects with many contributors. Since the potential applications of GenGIS are much broader than those we have in mind, we aim to make it as easy as possible to extend its capabilities by exposing the internal data structures and offering a plugin architecture.

Platforms

System requirements

Citing GenGIS

Where to go for help

Installation

Getting the Release Version

Adding the Python Console

Adding R

Developer Version – building from source code

Input data

Input data ordering

Maps

Supported formats

Projections

Data sources and GDAL

Typical limits on map size

Location File

Required fields

Location data – Lat / Long vs. UTM

Sequence File

Required fields

Other fields

Phylogenetic trees

File formats

Constraints / relationship with sequences

The Environment

The map environment

Map pane

Minimap

Getting around in GenGIS

Control elements

Hotkeys

Console input

Mouse

Menu options

Shortcut buttons

Interacting with sample sites

Working with Layers

Adding and removing

Active / inactive

wx Elements

Graphical analysis tools in GenGIS

Basic data visualizations

Pie charts

..?

2D phylogenetic trees

Defining axes

Manipulation

3D phylogenetic trees

The Python console and API functions

What you can do with the console

Accessing sample and sequence data

Capturing results

RPy and analyzing data

Installing R modules

Accessing sample data as tables in R

Capturing output from R

Implemented API functions (e.g. Mike's invocation of R charts)

Writing your own API functions