Difference between revisions of "GenGIS Tutorials"

From The GenGIS wiki
Jump to navigationJump to search
 
(41 intermediate revisions by 4 users not shown)
Line 1: Line 1:
 
We have put together a few tutorials to get you quickly started with GenGIS.  
 
We have put together a few tutorials to get you quickly started with GenGIS.  
 +
 +
== Short video tutorials ==
 +
These videos show how different tasks can be performed in GenGIS.
 +
 +
=== Creating a basemap ===
 +
Here is a short illustration of basemap creation using both raster and vector data. [[Media:Basemap larger x264.mp4 | View Tutorial]] (3:25)
 +
 +
=== Querying GBIF ===
 +
From version 2.1.1 you can add data directly from the Global Biodiversity Information Facility (GBIF). Here is a [[Media:GBIF x264.mp4 | tutorial showing the retrieval of cougar and jaguar records from GBIF]]. (11:12)
 +
 +
== Walkthrough tutorials with files ==
  
 
=== Tutorial 0: Obtaining Custom Digital Elevation Maps (DEM) ===
 
=== Tutorial 0: Obtaining Custom Digital Elevation Maps (DEM) ===
  
 
The simple way to obtain DEMs suitable for use in GenGIS is described [[Obtaining DEM from ORNL DAAC|here]]. An older set of instructions on how to manually contruct a custom DEM is available [[GTOP030 Tutorial|here]]. You can also obtain 2D maps compatible with GenGIS using [[MapMaker|MapMaker]].
 
The simple way to obtain DEMs suitable for use in GenGIS is described [[Obtaining DEM from ORNL DAAC|here]]. An older set of instructions on how to manually contruct a custom DEM is available [[GTOP030 Tutorial|here]]. You can also obtain 2D maps compatible with GenGIS using [[MapMaker|MapMaker]].
 
  
 
=== Tutorial 1: ''Banza'' Katydids of the Hawaiian Islands ===
 
=== Tutorial 1: ''Banza'' Katydids of the Hawaiian Islands ===
Line 10: Line 20:
 
[[Image:KaydidTutorialImage.jpg|thumb|Geophylogeny of ''Banza'' katydids from the Hawaiian Islands.|400px|right]]
 
[[Image:KaydidTutorialImage.jpg|thumb|Geophylogeny of ''Banza'' katydids from the Hawaiian Islands.|400px|right]]
  
In this tutorial, we consider the phylogenetic tree of ''Banza'' katydids (acoustic insects) from the Hawaiian Islands recently recovered by Shapiro et al. [1]. GenGIS will be used to investigate whether or not this phylogeny is related to the geography of the Hawaiian Islands.
+
In this tutorial, we consider the phylogenetic tree of ''Banza'' katydids (acoustic insects) from the Hawaiian Islands recently recovered by Shapiro ''et al.'', 2006. This tutorial gives an overview of the GenGIS interface, demonstrates how to load data, and illustrates how to change the visual properties of a map, location markers, and trees. The tutorial concludes with an analysis which suggests geography has had a substantial influence on the evolution of ''Banza'' katydids.
  
* [[Media:GenGIS_Katydid_Tutorial.pdf|Download text tutorial]]
+
* [[Katydid Tutorial | ''Banza'' Katydid tutorial]]
 +
* [[Media:GenGIS_Katydid_Tutorial.mp4‎|Stream video tutorial]]
 +
* [[Media:GenGIS_Katydids_Data.zip|Download ''Banza'' Katydid data set]]
  
* [[Katydid Tutorial | ''Banza'' Katydid Tutorial]]
+
=== Tutorial 2: Marine Microbial Communities from the Atlantic Seaboard ===
 +
 
 +
Here we examine samples collected as part of the Global Ocean Sampling expedition (Rusch ''et al.'', 2007) in order to investigate the influence of environmental factors on the composition of microbial communities from marine ecosystems. This tutorial demonstrates how to load data, illustrates how to change visual properties, presents a detail analysis of the geographic structure of these microbial communities, and examines the distribution of taxa within these samples.
 +
 
 +
* [[GOS Tutorial | GOS tutorial]]
 +
* [[Media:GenGIS_GOS_Tutorial.mp4|Stream video tutorial]]
 +
* [[Media:GenGIS_GOS_Data.zip|Download GOS data set]]
  
* [[Media:GenGIS_Katydid_Tutorial.swf|Stream]] or [[Media:GenGIS_Katydid_Movie.zip|download]] video tutorial (27 MB)
+
=== Tutorial 3: Microbial diversity at 28 human body sites ===
  
* [[Media:GenGIS_Katydids_Data.zip|Download katydid data set]]
+
Costello ''et al.'' (2009) collected microbial marker gene samples from 28 distinct human body sites to assess variation across sites, broad cateogories of sites (for instance, skin vs. gut) and through time. The following tutorial shows how to use plugins to perform statistical tests and generate visualizations, and how roll your own analysis scripts using Rpy2.
  
=== Tutorial 2: Marine Microbial Communities from the Atlantic Seaboard ===
+
* [[Body Location Tutorial | Body Location tutorial]]
 +
* [[Media:GenGIS_Costello_Data.zip|Download body site data set and analysis script]]
 +
 
 +
=== Tutorial 4: The ''Ensatina eschscholtzii'' ring species ===
 +
 
 +
The ''Ensatina  eschscholtzii'' salamander from the western United States is a classic example of allopatric speciation. In this tutorial, we demonstrate how GenGIS can be used to analyze non-linear geographic gradients (Parks and Beiko, 2009).
  
In this tutorial, we examine samples collected as part of the Global Ocean Sampling metagenomic survey [2] in order to investigate the influence of environmental factors on the composition of microbial communities from marine ecosystems.  
+
* [[West Coast Salamander Tutorial | Salamander tutorial]]
 +
* [[Media:Salamander.mp4|Stream video tutorial]]
 +
* [[Media:GenGIS_Salamanders.zip|Download salamander data set]]
  
* [[Media:GenGIS_GOS_Tutorial.swf|Stream]] or [[Media:GenGIS_GOS_Movie.zip|download]] video tutorial (21 MB)
+
=== Tutorial 5: Plugins ===
  
* [[Media:GenGIS_GOS_Data.zip|Download GOS data set]]
+
The functionality of GenGIS can be extended by writing a Python plugins. GenGIS comes with a number of Python plugins which can be accessed through the ''Plugins'' menu. Below is information about each of these plugins and instruction for developing your own plugin.
  
 +
* [[Description of GenGIS plugins | Description of GenGIS plugins]]
 +
* [[Creating a GenGIS plugin | Creating a GenGIS plugin]]
 +
* [[RCA_Tutorial| Tutorial showing the use of the RCA plugin]]
  
=== Tutorial 3: Custom Data Visualizations and Movies ===
+
=== Tutorial 6: Custom Data Visualizations and Movies ===
  
 
We have put together a number of examples illustrating how custom data visualizations and movies can be created using the API exposed to the Python console:
 
We have put together a number of examples illustrating how custom data visualizations and movies can be created using the API exposed to the Python console:
  
# Here is a list of all [[API Functions | API functions]].
 
# A few short examples of using the API are available in the [[The GenGIS Manual#The Python console and API functions | GenGIS manual]].
 
 
# An example showing how GenGIS can be used to visualize the mobility rates of HIV-1 subtype B in Europe as proposed by [http://www.retrovirology.com/content/6/1/49 Paraskevis et al. (2009)] has been posted [[HIV-1 subtype B mobility in Europe | here]]. This example includes a Python class demonstrating how a custom visualization can be made.
 
# An example showing how GenGIS can be used to visualize the mobility rates of HIV-1 subtype B in Europe as proposed by [http://www.retrovirology.com/content/6/1/49 Paraskevis et al. (2009)] has been posted [[HIV-1 subtype B mobility in Europe | here]]. This example includes a Python class demonstrating how a custom visualization can be made.
# A video showing the spread of the 2009 H1N1 influenza outbreak is available [[H1N1#Videos|here]] along with all data and code used to create the video. The Python class demonstrates how the properties of location sites can be accessed and modified using the API.
+
# Short examples of using the Python API to access data are available in the [[The GenGIS Manual#The Python console and API functions | GenGIS manual]].
# A video showing the spread of polymorphic amino acid sites during the 2009 H1N1 outbreak is available [[H1N1#Videos|here]]. The included Python class demonstrates how how pie charts can be accessed and modified using the API.
+
# Details on creating fly-through movies with GenGIS are available in the [[The GenGIS Manual#Creating fly-through movies | GenGIS manual]].
# A video showing the geophylogeny of the 2009 H1N1 outbreak is available [[H1N1#Videos|here]]. The included Python class demonstrates how geophylogenies can be accessed and modified using the API.
+
 
 +
=== Tutorial 7: Cartogram Tutorial with ''Aneides lugubris'' ===
 +
 
 +
We have put together a tutorial illustrating how to create cartograms using the Aneides lugubris salamander, which is endemic to the American West Coast.  
 +
# A tutorial with pictures and walkthrough
 +
*[[Aneides_lugubris_Tutorial | Creating a Cartogram with GenGIS]]
  
 
=== References ===
 
=== References ===
  
[1] L. H. Shapiro, J. S. Strazanac, and G. K. Roderick. (2006) Molecular phylogeny of Banza (Orthoptera: Tettigoniidae), the endemic katydids of the Hawaiian Archipelago. ''Mol. Phylogenet. Evol.'' '''41''':53-63. [http://www.ncbi.nlm.nih.gov/pubmed/16781170 Pubmed]
+
Costello EK, Lauber CL, Hamady M, Fierer N, Gordon JI, Knight R. 2009. Bacterial community variation in human body habitats across space and time. ''Science'', 326: 1694-1697. ([http://www.sciencemag.org/content/326/5960/1694.short Abstract])
 +
 
 +
Parks DH and Beiko RG. 2009. Quantitative visualizations of hierarchically organized data in a geographic context. ''Geoinformatics 2009'', Fairfax, VA. [http://ieeexplore.ieee.org/xpl/freeabs_all.jsp?reload=true&isnumber=5292806&arnumber=5293552&count=243&index=6 IEEE Xplore]
 +
 
 +
Rusch DB, Halpern AL, Sutton G, ''et al.'' .2007. The Sorcerer II Global Ocean Sampling Expedition: Northwest Atlantic through Eastern Tropical Pacific. ''PLoS Biol.'' '''5''':e77. [http://www.ncbi.nlm.nih.gov/pubmed/17355176 PubMed]
  
[2] D. Rusch, A. Halpern, G. Sutton, et al., (2007) "The Sorcerer II Global Ocean Sampling Expedition: Northwest Atlantic through Eastern Tropical Pacific," ''PLoS Biol.'' '''5''':e77. [http://www.ncbi.nlm.nih.gov/pubmed/17355176 PubMed]
+
Shapiro LH, Strazanac JS, and Roderick GK. 2006 Molecular phylogeny of Banza (Orthoptera: Tettigoniidae), the endemic katydids of the Hawaiian Archipelago. ''Mol. Phylogenet. Evol.'' '''41''':53-63. [http://www.ncbi.nlm.nih.gov/pubmed/16781170 Pubmed]

Latest revision as of 13:37, 16 May 2017

We have put together a few tutorials to get you quickly started with GenGIS.

Short video tutorials

These videos show how different tasks can be performed in GenGIS.

Creating a basemap

Here is a short illustration of basemap creation using both raster and vector data. View Tutorial (3:25)

Querying GBIF

From version 2.1.1 you can add data directly from the Global Biodiversity Information Facility (GBIF). Here is a tutorial showing the retrieval of cougar and jaguar records from GBIF. (11:12)

Walkthrough tutorials with files

Tutorial 0: Obtaining Custom Digital Elevation Maps (DEM)

The simple way to obtain DEMs suitable for use in GenGIS is described here. An older set of instructions on how to manually contruct a custom DEM is available here. You can also obtain 2D maps compatible with GenGIS using MapMaker.

Tutorial 1: Banza Katydids of the Hawaiian Islands

Geophylogeny of Banza katydids from the Hawaiian Islands.

In this tutorial, we consider the phylogenetic tree of Banza katydids (acoustic insects) from the Hawaiian Islands recently recovered by Shapiro et al., 2006. This tutorial gives an overview of the GenGIS interface, demonstrates how to load data, and illustrates how to change the visual properties of a map, location markers, and trees. The tutorial concludes with an analysis which suggests geography has had a substantial influence on the evolution of Banza katydids.

Tutorial 2: Marine Microbial Communities from the Atlantic Seaboard

Here we examine samples collected as part of the Global Ocean Sampling expedition (Rusch et al., 2007) in order to investigate the influence of environmental factors on the composition of microbial communities from marine ecosystems. This tutorial demonstrates how to load data, illustrates how to change visual properties, presents a detail analysis of the geographic structure of these microbial communities, and examines the distribution of taxa within these samples.

Tutorial 3: Microbial diversity at 28 human body sites

Costello et al. (2009) collected microbial marker gene samples from 28 distinct human body sites to assess variation across sites, broad cateogories of sites (for instance, skin vs. gut) and through time. The following tutorial shows how to use plugins to perform statistical tests and generate visualizations, and how roll your own analysis scripts using Rpy2.

Tutorial 4: The Ensatina eschscholtzii ring species

The Ensatina eschscholtzii salamander from the western United States is a classic example of allopatric speciation. In this tutorial, we demonstrate how GenGIS can be used to analyze non-linear geographic gradients (Parks and Beiko, 2009).

Tutorial 5: Plugins

The functionality of GenGIS can be extended by writing a Python plugins. GenGIS comes with a number of Python plugins which can be accessed through the Plugins menu. Below is information about each of these plugins and instruction for developing your own plugin.

Tutorial 6: Custom Data Visualizations and Movies

We have put together a number of examples illustrating how custom data visualizations and movies can be created using the API exposed to the Python console:

  1. An example showing how GenGIS can be used to visualize the mobility rates of HIV-1 subtype B in Europe as proposed by Paraskevis et al. (2009) has been posted here. This example includes a Python class demonstrating how a custom visualization can be made.
  2. Short examples of using the Python API to access data are available in the GenGIS manual.
  3. Details on creating fly-through movies with GenGIS are available in the GenGIS manual.

Tutorial 7: Cartogram Tutorial with Aneides lugubris

We have put together a tutorial illustrating how to create cartograms using the Aneides lugubris salamander, which is endemic to the American West Coast.

  1. A tutorial with pictures and walkthrough

References

Costello EK, Lauber CL, Hamady M, Fierer N, Gordon JI, Knight R. 2009. Bacterial community variation in human body habitats across space and time. Science, 326: 1694-1697. (Abstract)

Parks DH and Beiko RG. 2009. Quantitative visualizations of hierarchically organized data in a geographic context. Geoinformatics 2009, Fairfax, VA. IEEE Xplore

Rusch DB, Halpern AL, Sutton G, et al. .2007. The Sorcerer II Global Ocean Sampling Expedition: Northwest Atlantic through Eastern Tropical Pacific. PLoS Biol. 5:e77. PubMed

Shapiro LH, Strazanac JS, and Roderick GK. 2006 Molecular phylogeny of Banza (Orthoptera: Tettigoniidae), the endemic katydids of the Hawaiian Archipelago. Mol. Phylogenet. Evol. 41:53-63. Pubmed