GraphMap

Organizing the images of the world

a way to organize image in a spatial 2D layout.
It is a directed cyclic graph where every node has either 0 or 4 edges.
Each node may or may not have an image on them.
One can imagine this as a quad tree (although cycles are possible), and you are looking from the bottom.
Each child gets a quadrant. If a child has an image it covers the parent image in that quadrant.
If a node doesn’t have an image it is invisible.

Features

• The created graph is immutable. New nodes can be added but old ones cannot be modified.
• Functional approach is used, GraphMap class returns a Result value and does not throw exception.

See it in Action

KaiiMap Gallery is a website created that uses GraphMap and OpenSeadragon.

Installation

You can use pip to install the stable version

pip install graphmap

If you want to install the latest directly from github you can use

pip install git+https://github.com/abhishekraok/GraphMap

Getting Started

• Start with ipython notebook Getting Started Notebook
• Follow up with other notebooks in the notebook section
• Check the unit tests Tests

Contributing

Contributions are welcome.
Please have unit tests.

Inspiration

• Deep Zoom Images for viewing the images
• Inspired by my blog article
• XKCD comic on deep zoom xkdcd1110
• The graph created by the API is Persistent Immutable DataStructure. The ideas used are similar to the ones explaine in this video Immutable JS
• Deep zoom links (Quora) What is OpenSeadragon