Skip to content
Go to file

Latest commit


Git stats


Failed to load latest commit information.
Latest commit message
Commit time


This application was created by the NYU School of Medicine Division of Educational Informatics: William Holloway and Marc Triola MD. The Virtual Microscope uses the Google Maps API to display, annotate, and navigate scanned slides. The working NYU site is available here:

This project consists of two components:

  • A Python script to convert slide files obtained by scanners from Aperio and Bacus Labs into a format compatible with the Google Maps API.
  • An example viewer upon which you can base your local instance


  1. Set up your development machine with Python, MySQL, Python Imaging Library, and Django (now requires version 1.4 or greater). Django Guides: Django Quick install guide Django - Deploying to a production web server

  2. Create a Django Project for your local instance.

  3. In that project, install both Version 2 of the NYUVM and Django Compressor (now required for performance reasons). This involves:

  • Copying the app folders into the project
  • Adding both apps to INSTALLED_APPS
  • Adding references to the NYUVM url file to the project-level In our instance it looks like: url(r'^virtualmicroscope/',include('nyuvm.urls')),
  • Configuring local authentication and/or user registration as you see fit
  • Configuring your database and running sync-db
  1. In addition to any settings you want to configure for Compressor, There are several ones for the NYUVM you can add to your

Required Settings:

Enable the admin app in and

Optional VM Specific Settings:

URL_ROOT= '/virtualmicroscope'  #the base url prefix.  You can optionally omit this and handle at the apache conf level using the ‘PythonOption django.root’ setting.
REQ_LOGIN = False  #require login for all slide and collection views
COMPRESS_ENABLED=True #override and force compressor even on dev server
COMM_MARKER_EXPIRE = 180 #number of days untila a community marker expires
SLIDES_PER_PAGE = 150 #number of thumbnails per page
API_KEY = 'xxxxxxx' #google maps API key (optional)
GAKEY = 'xxxxx' #google analytics key (optional)
  1. At this point your development Django server should run and you can begin adding slides and collections [ as per the documentation].

Simple slide viewer template


This is a code snippet to create an HTML page with a slide viewer. This snippet is just a simple viewer with navigation and points to a slide on the NYU School of Medicine's cloud servers. You could use this as a template to build your own database-driven viewer system.

Code Snippet


<script type="text/javascript" src=""></script> 
<script type="text/javascript"> 
var map;
function initialize() 
        geocoder = new google.maps.Geocoder();

        var myOptions = {
                zoom: 2,
                center: new google.maps.LatLng(0,0),
                mapTypeControl: false,
                navigationControl: true,
                mapTypeId: google.maps.MapTypeId.ROADMAP

        map = new google.maps.Map(document.getElementById("map_canvas"), myOptions);

        var VM_Map = new google.maps.ImageMapType({
                                name: 'NYU Virtual Microscope', 
                                alt: 'NYU Virtual Microscope',
                                getTileUrl: function(coord, zoom) {return customGetTileUrl(coord, zoom);},
                                tileSize: new google.maps.Size(256, 256),
                                minZoom: 1, 
                                maxZoom: 8, 
                                isPng: false
                        map.mapTypes.set('VM_Map', VM_Map);


 function customGetTileUrl(coord,zoom) {
        return "" + zoom + "_"+ coord.x + "_" + coord.y + ".jpg"

<body id="body" style="margin:0px; padding:0px; overflow: hidden;" onLoad="initialize()" > 
                <div id="map_canvas" style="width:100%; height: 100%;"></div> 


No description, website, or topics provided.



No releases published
You can’t perform that action at this time.