





1. Data FilesGeo Relocation takes as its input 3 text files: A vectorized Map (VEC), a list of object descriptions (CSV), and a list of square matrices that denote the numeric relationship between all objects for any given time period (DAT). The vectorized map (VEC) is then drawn in the interface, annotated using descriptions from (CSV), and populated with data from (DAT).
1.1 The VEC file and The Vectorizer (vectorizer.jar)A [geographic] map consists of primitive shapes (polygons), each of which is filled with some color. In the figure above, the map consists of city blocks (brown), and different shapes (circles, rectangles, and other polygons) each filled with a different color (red, green, etc.) and outlined in black. The Vectorizer (vectorizer.jar) attempts to convert this bitmap image into vector polygons for more efficient and effective display in the interface. The most important properties of any map used in the interface are:
Note that the vectorizer is not perfect  there do exist shapes that are not well recognized if their outline is not minimally closed. This means that a closed outline of thickness 1 is more likely to be vectorized correctly than an outline of thickness > 1. In the near future the vectorizer will be updated so that black outlines are no longer necessary, and so that shapes are better recognized altogether. 1.2 The CSV descriptor fileThis file enumerates the fill color for each descriptive object and maps it to the name of the object: R,G,B,description of object. Object descriptions are used in the interface for mouse rollovers and summary cards.1.3 Relocation matrices (DAT file)This file enumerates, for each time period, a square matrix that maps relocations from building X to building Y in terms of some numeric value. Given a square matrix with rows and columns, a relocation FROM building X TO building Y with some numeric value V appears in row X and column Y, i.e. matrix(X,Y) = matrix(row,col) = V denotes relocations from building X to building Y.This file is structured as follows:

