by T. Michael Keesey (firstname.lastname@example.org)
this document by Selvam Palanimalai (email@example.com) and T. Michael Keesey
PhyloPic's database stores reusable silhouette images of organisms. Each image is associated with one or more taxonomic names and indicates roughly what the ancestral member(s) of each taxon looked like.
PhyloPic also stores a phylogenetic taxonomy of all organisms. This means that you can perform phylogenetic searches. For example, if you need an image for a certain taxon, but there is no exact match in the database, you can easily search that taxon's supertaxa, subtaxa, and related taxa for an image that may work as well.
PhyloPic is built using the Django framework.
PhyloPic code is available under the MIT license. For more details, see the
- Python 2.6.6 (or higher)
- Django 1.3.4 (or higher)
- PostgreSQL 9.0 (or higher)
- ImageMagick 6.7.5 (or higher)
- Inkscape 0.47 (or higher)
Although it's not necessary to get up and running, if you plan to edit the client-side code at all, you'll also need:
- TypeScript (for translating
- Install Python: Instructions.
- Install Django: Instructions.
- Install PostgreSQL: Instructions.
- To install Python packages, we recommend installing
- From the command line, run
easy_install django-social-auth. (If you have another way to install Python packages, such as
pip, you can use that instead.)
- Install ImageMagick: Instructions.
- Install Inkscape: Instructions
- [optional] Install TypeScript: Instructions.
- [optional] Install Java: Instructions.
- In PostgreSQL, add a database called
- Create a UBio account and obtain an API key.
settings.py. Everywhere there is a comment that start with
:SETUP:, you will have to make a change. Follow the instructions in the comment. (You'll need the UBio API key for one step.)
- To set up the database, go into
- In PostgreSQL, you will need to run the SQL script
- In your browser, go to
http://127.0.0.1:8000/. You should be able to see the PhyloPic homepage. DONE!
Building Client-Side Code
src/assets/scripts/) from the TypeScript source code (
src/typescript/), go into
src/typescript and run
In case of any problems feel free to contact Mike Keesey (firstname.lastname@example.org).