Sample input files
Preparing your own files
The geography should be defined in the WGS84 projection (Longitude,Latitude) in a geojson file.
The id that identifies each geographic shape should be stored as one of the properties of that object (e.g. StateId, CountyId, ...).
Geographic shapes are commonly defined in shapefiles (extension .shp).
Several tools exist to convert them into the geojson format, including this one
The data should be provided in json format. The easiest thing to do is to produce a CSV file,
and then use this Python script
to convert the data from the CSV format
to the required json format.
The CSV file should have the following columns (even if there is only one time period): PeriodId,GeoShapeId,Var1,Var2,Var3, ...
is the CSV file corresponding to the sample json data file provided above.
The field "GeoShapeId" (which could be StateId, CountyId, etc.) should be the same as in the geojson file,
as the two will be matched using that field.
Color cutoff file
The cutoff values at which there should be a change in color are defined in that file. While there is no "right way" to define them,
a good starting point is to use this Python script to define these cutoffs.
The Python script looks at the distribution of values for each variable, and defines the cutoffs by using quantiles.