GPL, initially created by mdomsch and adapted by |DrJef|

Example Usage of python animated_clients.py.txt

python animated_clients.py.txt --indir=./example_input/ --outdir=./example_output/ --header="Header string" --footer="Footer string"

This script is still somewhat fragile and does not yet do all the path 
and file existance checking that it should. To use the example 
invocation you will need to make sure that the indir and outdir 
locations exists.

indir is used to hold file inputs that the script needs.
The example invocation requires that indir holds:
  ips-with-epoch.txt : file with ip clients and epoch timestamp
  glds05ag30.asc  : population density data
  regions.txt : region definitions

indir defaults to ./

if the file saved_data.pickle exists in outdir, this file will be loaded 
in an attempt to create image frames based on previous timestamp 
imformatin stored in the pickle file. This allows you to generate 
additional frames in a sequence without parsing the full ip log on each 
run.  For example, you can run this script daily, using ip client 
information from the end of previous day stored in the pickle file. 
Run in this manner, the script will generate 24 new frames daily using 
only daily ip client logs for each day.


outdir defaults to ./animation-frames/
you must make sure outdir exists.

outdir holds:
  the sequence of generated frame images with prefix frame_
  the pickle file saved_data.pickle, which stores previous frame data
  summary client_per_capita: clientpop_<epoch>.png  
  population density: population_<epoch>.png
  summary of client density: current_<epoch>.png

<epoch> is the most recent epoch associate with a the script.


Gridder Population Data Citation:

Center for International Earth Science Information Network (CIESIN), Columbia 
University; United Nations Food and Agriculture Programme (FAO); and Centro 
Internacional de Agricultura Tropical (CIAT). 2005. Gridded Population of the 
World: Future Estimates (GPWFE). Palisades, NY: Socioeconomic Data and Applications 
Center (SEDAC), Columbia University. Available at 
http://sedac.ciesin.columbia.edu/gpw. (download date: 2007-10-19).

ARCHIVE CONTENTS This archive contains the low-resolution vesion of the 
UN-adjusted population density grids in ASCII format. The raster data 
are at 0.5 degrees (30 arc-minutes) resolution. This archive contains 
the following grid(s): 

ds05ag30 : population densities in 2005, adjusted to match UN totals, 
persons per square km