https://github.com/pjsier/aggspread

CLI for spreading aggregated GeoJSON feature values into random points within intersecting polygons
https://github.com/pjsier/aggspread

cli geospatial gis golang hacktoberfest map

Last synced: about 1 year ago
JSON representation

CLI for spreading aggregated GeoJSON feature values into random points within intersecting polygons

• Host: GitHub
• URL: https://github.com/pjsier/aggspread
• Owner: pjsier
• License: mit
• Created: 2019-03-10T22:00:14.000Z (over 7 years ago)
• Default Branch: main
• Last Pushed: 2021-10-01T21:24:12.000Z (over 4 years ago)
• Last Synced: 2025-02-09T10:11:54.810Z (over 1 year ago)
• Topics: cli, geospatial, gis, golang, hacktoberfest, map
• Language: Go
• Homepage:
• Size: 1.27 MB
• Stars: 1
• Watchers: 2
• Forks: 3
• Open Issues: 1
• Metadata Files:
  • Readme: README.md
  • Contributing: CONTRIBUTING.md
  • License: LICENSE
  • Code of conduct: CODE_OF_CONDUCT.md

Awesome Lists containing this project

README

          
# `aggspread`

[![Build status](https://github.com/pjsier/aggspread/workflows/CI/badge.svg)](https://github.com/pjsier/aggspread/actions?query=workflow%3ACI)

A CLI tool based on Conveyal's [`aggregate-disser`](https://github.com/conveyal/aggregate-disser/) for spreading aggregated GeoJSON feature data throughout points inside overlapping spread features. An example would be distributing precinct-level election results into points within contained residential parcels.

![Screenshot of voting results spread into parcels](./img/screenshot.png "Screenshot of voting results spread into parcels")

## Installation

If you have Go installed, you can run `go get github.com/pjsier/aggspread` to download the binary package and add it to your path.

There are also [binaries available](https://github.com/pjsier/aggspread/releases) for MacOS, Windows and Linux.

## Usage

```bash

Usage of aggspread:

  -agg string

        File including aggregated info or '-' to read from stdin (default "-")

  -output string

        Optional filename to write output or '-' to write to stdout (default "-")

  -prop string

        Aggregated property to spreads

  -spread string

        File to spread property throughout or '-' to read from stdin (default: value in 'agg')

```

## Example

Convert a feature collection of voting precincts with a property indicating the number of votes into points spread throughout residential parcels within each precinct.

```bash

aggspread -agg precincts.geojson -prop votes -spread parcels.geojson -output output.csv

```

## Contributing

See [CONTRIBUTING.md](./CONTRIBUTING.md)