Step 0: Installing G-language Genome Analysis Environment
Download and install G-language Genome Analysis Environment v.1.8.3 or above following the instructions in: http://www.g-language.org/wiki/software
Step 1: Creating custom zoomable map from your image
In your shell, type G to startup G-language Shell. For details about G-language Shell, see here.
Then type generateGMap(“yourImageFile.png”). Image can be in any format supported by ImageMagick utility (therefore virtually every possible format). This step takes up to 10~15 minutes depending on the performance of your computer, so please be patient. After this process a folder named “yourImageFile” is created in your working directory.
That's it! Now type quit and answer n to quit G-language Shell.
% G
__/__/__/__/__/__/__/__/__/__/__/__/__/__/__/__/__/__/__/__/__/
G-language Genome Analysis Environment v.1.8.3
http://www.g-language.org/
Please cite:
Arakawa K. et al. (2003) Bioinformatics.
Arakawa K. et al. (2006) Journal of Pestice Science.
License: GNU General Public License
Copyright (C) 2001-2008 G-language Project
Institute for Advanced Biosciences, Keio University, JAPAN
__/__/__/__/__/__/__/__/__/__/__/__/__/__/__/__/__/__/__/__/__/
G > generateGMap("yourImageFile.png", -level=>2)
Google Map View is generated in yourImageFile directory.
G > quit
save value ? y/n (or cancel) ?
quit >>n
%
In the newly created folder named “yourImageFile” (without the extension), find a file named “index.html”, and open this file with your favorite browser (usually double clicking on the file does the job). Now enjoy zooming into your favorite image!
Step 2: Customizing the zoom level
By default, the maximum zoom level is set to 6, which is 8192×8192 pixels. This zoom level can be changed by supplying -level⇒ option to generateGMap, as follows:
G > generageGMap("yourImageFile.png", -level=>4)
The image size is 2^(level - 1) * 256. Note that generation of very large image takes a lot of disk space and memory. Level 7 usually requires around 4GB of RAM, so the default level should be sufficient in most cases.
You can browse the documentation for generateGMap by typing
G > help generateGMap
in G-language Shell.
G > help generateGMap
Name: generateGMap - generate Google Map View from given image file
Description:
This method generates a zoomable AJAX viewer interface for the
given image, by splitting the image and generating the HTML page,
using Google Maps API v.2. Open the "index.html" file with your
browser when the directory containing split images and the HTML
is generated.
Note that it will take a very long time to generate images
with levels greater than 6.
Usage:
generateGMap("imageFileName.png");
Here the image format can be anything supported by ImageMagick.
For best viewing experience, square image is preferred.
When you wish to make the generated map public, obtain a Google
Map API Key from
http://www.google.com/apis/maps/signup.html
and replace the string "YOUR_GOOGLE_MAP_KEY_HERE" within the
generated HTML.
Options:
-level maximum zoom level. (default: 6)
This value should be larger than 3.
Image width size is 2^(level - 1) * 256, so width at
level = 6 is 8192.
References:
1. Google Maps API Documentation. http://www.google.com/apis/maps/documentation/
Author:
Kazuharu Arakawa (gaou@sfc.keio.ac.jp)
History:
20070707-01 stopped tiling in the x-direction by default
20070621-01 initial posting
Step 3: Publishing your zoomable map on your web server
To publish the generated map, you need to place the generated folder in your webserver (usually in public_html folder or /var/www/html/), and then change the Google Maps Key.
First, go to Google Code Website for Google Maps API and obtain a Google Map Key for your website.
Then, open the index.html of your generated map with your favorite text editor, and edit the first <script> tag where it reads “YOUR_GOOGLE_MAP_KEY_HERE”, replacing it with the obtained key.
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd"> <html xmlns="http://www.w3.org/1999/xhtml"> <head> <meta http-equiv="Content-Type" content="text/html;charset=utf-8" /> <title>Google Map View of NC_000913 - generated by G-language GAE</title> <script src="http://maps.google.com/maps?file=api&v=2.x&key=YOUR_GOOGLE_MAP_KEY_HERE" type="text/javascript" charset="utf-8"></script> <script type="text/javascript">