Skip to content

Collection of GeoJSON and TopoJSON datasets developed as part of the IODA project

License

Notifications You must be signed in to change notification settings

CAIDA/ioda-geo-polygons

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

4 Commits
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

CAIDA IODA Polygons

Geographical polygons datasets and associated scripts created as part of CAIDA's Internet Outages Detection and Analysis (IODA) project.

In addition to continent-, country-, and region-level polygons, the scripts/ directory contains scripts that can be used (after customization) to join the polygon datasets with an IP-geolocation dataset.

Polygons

We provide both geojson and topojson formatted polygon files to simplify use in Web applications. Currently we make available polygons at three levels: continent, country, and region. All these datasets are based on data from the Natural Earth project. The "region" dataset is based on a semi-manual selection and stitching together of sub-national polygons (e.g., US states) from the Natural Earth dataset.

Each polygon in the datasets has (at least) id, fqid, name, and usercode fields. (See scripts/gen-polygon-table.py for a script to extract these fields as a CSV.)

Scripts

gen-polygon-table.py

This is a simple script to extract id, fqid, name, and usercode fields from a polygons file in CSV format. This can then be used as a "join" table in conjunction with the output from the "gen-loc-polygon-join-table.py" script.

See polygons/ for sample output from this script.

gen-loc-polygon-join-table.py

This script takes as input the "locations" table from an IP geolocation database and a geojson polygons file, and attempts to map each location to the best polygon. The current implementation is designed specifically for a "locations" table from the Net Acuity IP geolocation database, so will need to be adapted for use with other databases.

Acknowledgments

Datasets in this project have been made from data from the Natural Earth project.

License

This data has been released for non-commercial use only. See the full LICENSE for more information.

About

Collection of GeoJSON and TopoJSON datasets developed as part of the IODA project

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Languages