<commit_before># splat-scripts

Scripts to run the [Splat!](http://www.qsl.net/kd2bd/splat.html) radio terrain
mapping tool.

## Dependencies

This was built and tested on Debian Jessie (8.0) with the following versions:

```
ii  splat          1.4.0-2      amd64        analyze point-to-point terrestria
ii  imagemagick    8:6.8.9.9-5  amd64        image manipulation programs -- bi
ii  optipng        0.7.5-1      amd64        advanced PNG (Portable Network Gr
ii  wget           1.16-1       amd64        retrieves files from the web
```

## Configuration

Edit the shell scripts to set the paths for the SDF elevation files and the
political borders file.

To download and convert the SRTM data use the `get-datafiles*.sh` scripts. Go
get some coffee while this runs, it will take a while. After it is completed,
you should be able to run the example profile as below.

## Usage

```
$ ./splat-radio.sh example.cfg
```

```
$ cat example.cfg
NAME="example"
CALL="KQ2H"
LAT="40.7484931946"
LON="-73.9856567383"
HTAGL="373m"
ERP="250"
FREQMHZ="449.2250"
```

Parameters are as follows:

* `NAME`: used to uniquely name files
* `CALL`: will be labeled onto the map
* `LAT`: latitude, decimal degrees
* `LON`: longitude, decimal degrees (East is positive)<commit_msg>add guide to disk space used, removal of *hgt.zip files<commit_after># splat-scripts

Scripts to run the [Splat!](http://www.qsl.net/kd2bd/splat.html) radio terrain
mapping tool.

## Dependencies

This was built and tested on Debian Jessie (8.0) with the following versions:

```
ii  splat          1.4.0-2      amd64        analyze point-to-point terrestria
ii  imagemagick    8:6.8.9.9-5  amd64        image manipulation programs -- bi
ii  optipng        0.7.5-1      amd64        advanced PNG (Portable Network Gr
ii  wget           1.16-1       amd64        retrieves files from the web
```

## Configuration

Edit the shell scripts to set the paths for the SDF elevation files and the
political borders file.

To download and convert the SRTM data use the `get-datafiles*.sh` scripts. Go
get some coffee while this runs, it will take a while. After it is completed,
you should be able to run the example profile as below.

If interrupted, the retrieval of the SRTM `*hgt.zip` files over the network can
be restarted and will resume where it left off.

Note the following disk space requirements to complete the data conversion:

* Africa: 5.4 GB
* Australia: 1.2 GB
* Eurasia: 9.0 GB
* Islands: 92 MB
* North America: 3.6 GB
* South America: 3.3 GB
* All: 23 GB

The `*hgt.zip` files are not required after conversion, but they are not
removed by the script.  They are retained so that a new run may commence
without downloading all the files again from the server.  This happens via the
`wget` `-N` option.

After removing the `*hgt.zip` files, disk space required for operations comes
down to:

* Africa: 2.1 GB
* Australia: 434 MB
* Eurasia 3.4 GB
* Islands: 36 MB
* North America: 1.4 GB
* South America: 1.3 GB
* All: 8.5 GB

## Usage

```
$ ./splat-radio.sh example.cfg
```

```
$ cat example.cfg
NAME="example"
CALL="KQ2H"
LAT="40.7484931946"
LON="-73.9856567383"
HTAGL="373m"
ERP="250"
FREQMHZ="449.2250"
```

Parameters are as follows:

* `NAME`: used to uniquely name files
* `CALL`: will be labeled onto the map
* `LAT`: latitude, decimal degrees
* `LON`: longitude, decimal degrees (East is positive)
{'fraction_non_alphanumeric': 0.09633569739952719, 'fraction_numerical': 0.048167848699763594, 'mean_word_length': 3.2902408111533585, 'pattern_counts': {'":': 0, '<': 3, '<?xml version=': 0, '>': 3, 'https://': 0, 'lorem ipsum': 0, 'www.': 2, 'xml': 0}, 'pii_count': 2, 'substrings_counts': 0, 'word_list_counts': {'cursed_substrings.json': 3, 'profanity_word_list.json': 0, 'sexual_word_list.json': 0, 'zh_pornsignals.json': 0}}
{'dir': 'git-commits-cleaned', 'id': '2780088', 'n_tokens_mistral': 1216, 'n_tokens_neox': 1092, 'n_words': 452}