Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/evetion/flatgeobuf.jl

FlatGeobuf (A performant binary encoding for geographic data based on flatbuffers) implementation in Julia
https://github.com/evetion/flatgeobuf.jl

flatbuffers flatgeobuf geometry shapefile

Last synced: 19 days ago
JSON representation

FlatGeobuf (A performant binary encoding for geographic data based on flatbuffers) implementation in Julia

Host: GitHub
URL: https://github.com/evetion/flatgeobuf.jl
Owner: evetion
License: mit
Created: 2020-01-04T13:55:45.000Z (almost 5 years ago)
Default Branch: master
Last Pushed: 2024-06-21T07:04:07.000Z (5 months ago)
Last Synced: 2024-09-21T22:41:45.597Z (about 2 months ago)
Topics: flatbuffers, flatgeobuf, geometry, shapefile
Language: Julia
Homepage:
Size: 64.5 KB
Stars: 5
Watchers: 5
Forks: 0
Open Issues: 0
Metadata Files:
- Readme: README.md
- License: LICENSE

Awesome Lists containing this project

README

[![](https://img.shields.io/badge/docs-dev-blue.svg)](https://evetion.github.io/FlatGeobuf.jl/dev) [![](https://img.shields.io/badge/docs-stable-blue.svg)](https://evetion.github.io/FlatGeobuf.jl/stable) [![CI](https://github.com/evetion/FlatGeobuf.jl/actions/workflows/ci.yml/badge.svg)](https://github.com/evetion/FlatGeobuf.jl/actions/workflows/ci.yml) [![codecov](https://codecov.io/gh/evetion/FlatGeobuf.jl/branch/master/graph/badge.svg?token=PBLSRXFGII)](https://codecov.io/gh/evetion/FlatGeobuf.jl)

# FlatGeobuf.jl
A native [flatgeobuf](https://github.com/flatgeobuf/flatgeobuf) implementation in Julia. Flatgeobuf is a cloud optimized geospatial vector format.

# Installation
```julia
] add FlatGeobuf
```

# Usage
```julia
import FlatGeobuf; const FGB=FlatGeobuf

fgb = FGB.read_file("countries.fgb")
FlatGeobuffer with 179 GeometryTypeMultiPolygon features.
```

FlatGeobuf supports the `Tables.jl` interface.
```julia
using DataFrames
DataFrame(fgb)
179×3 DataFrame. Omitted printing of 1 columns
│ Row │ id │ name │
│ │ String │ String │
├─────┼────────┼─────────────────────────────────────┤
│ 1 │ ATA │ Antarctica │
│ 2 │ ATF │ French Southern and Antarctic Lands │
│ 3 │ NAM │ Namibia │
│ 4 │ BWA │ Botswana │
│ 5 │ SWZ │ Swaziland │
│ 6 │ ZAF │ South Africa │
│ 7 │ LSO │ Lesotho │
│ 8 │ MOZ │ Mozambique │
│ 9 │ MWI │ Malawi │
│ 10 │ ZMB │ Zambia │
│ 11 │ ZWE │ Zimbabwe │
│ 12 │ AGO │ Angola │
│ 13 │ COD │ Democratic Republic of the Congo │
│ 14 │ RWA │ Rwanda │
```

FlatGeobuffers have a spatial index that we can query with a bounding box
```julia
bbox = [-92.73405699999999, 32.580974999999995, -92.73405699999999, 32.580974999999995]
filter!(fgb, bbox)
julia> DataFrame(fgb)
2×3 DataFrame. Omitted printing of 1 columns
│ Row │ id │ name │
│ │ String │ String │
├─────┼────────┼──────────────────────────┤
│ 1 │ MEX │ Mexico │
│ 2 │ USA │ United States of America │
```

# TODO
* GeoInterface support
* Write support

# Updating the Schema
I've used https://github.com/rjkat/flatbuffers-julia to autogenerate the files found in `src/schema`, but had to adapt them. Good autogeneration from schema is broken as of now. Probably needs waiting on a 1.6/1.7 Julia release so https://github.com/JuliaLang/julia/pull/32658 is merged, so an official flatbuffer implementation can be made over at https://github.com/google/flatbuffers/pull/5088.