Geolocating internet_outage_adaptive-dataset blocks

Requirements:
  * bash
  * perl
  * perl-Fsdb (https://www.isi.edu/~johnh/SOFTWARE/FSDB/) 

Geolocation:
 Assuming you have USC/ISI internet_outage_adaptive dataset downloaded
 and saved in e.g. /traces/outages/internet_outage_adaptive_a43w-20210101/

 1. Download a Maxmind geolocation data
    Maxmind provides both paid and free versions of IP geolocation databases.
    Paid version has better geospatial resolution, while free version (geolite2) is less
    accurate.  More information can be found at 
       https://www.maxmind.com/en/home
    Their free version can be accessed after creating an account and clicking
    through a data usage agreement at
       https://dev.maxmind.com/geoip/geoip2/geolite2/

    Please note that this code uses Maxmind CSV-formatted dataset, which is distributed
    as "GeoLite2 City: CSV Format", in a zip compressed file.

 2. Unzip the downloaded file.  Copy these 2 files to a newly created empty directory and compress them:
    DATE=$(date +%Y%m%d)
    mkdir /traces/outages/maxmind-$DATE
    cp GeoLite2-City-Blocks-IPv4.csv /traces/outages/maxmind-$DATE/GeoLite2-City-Blocks-IPv4-$DATE.csv
    cp GeoLite2-City-Locations-en.csv /traces/outages/maxmind-$DATE/GeoLite2-City-Locations-en-$DATE.csv
    gzip /traces/outages/maxmind-$DATE/*

 3. Run this code:
    mkdir /traces/outages/internet_outage_adaptive_a43_supplemental_geo-$DATE
    ./make_supplement_geo.sh /traces/outages/maxmind /traces/outages/internet_outage_adaptive_a43w-20210101 \
                             /traces/outages/internet_outage_adaptive_a43_supplemental_geo-$DATE


PLEASE NOTE: all USC/ISI internet-outage-adaptive datasets collected from multiple locations concurrently
e.g. 
        internet_outage_adaptive_a43w-20210101
        internet_outage_adaptive_a43c-20210101
        internet_outage_adaptive_a43e-20210101
        ...
Use the same input and consequently have the same geolocation.  Therefore it's sufficient to geolocate any 
one of these datasets and you will have geolocation for all of them.

If you need geolocation for merged outage datasets, such as internet_outage_adaptive_a43all-20210101, you can
download one of the single-letter datasets, e.g. internet_outage_adaptive_a43w-20210101 (the download can be
limited to the "input" suubdirectory or in this case  internet_outage_adaptive_a43w-20210101/input) and run
your gelocation based on that dataset.
