@kamataryo/inat-convex

A CLI tool to generate GeoJSON polygons that enclose the convex hull of species distribution areas.

Requirements

• Node.js or Deno

Usage example

Place a common name, taxon (genus, family, order and etc) or scientific name as an argument and you can get a GeoJSON object which streamed out from standard output of the process.

$ npx @kamataryo/inat-convex "セトウチマイマイ"          # with a Japanese common name
$ npx @kamataryo/inat-convex "Arctic Char"            # with an English common name
$ npx @kamataryo/inat-convex "Salvelinus leucomaenis" # with a scientific name

It is convenient to pipe to any tool which supports standard input e.g. @geolonia/view-geojson.

$ npx @kamataryo/inat-convex "セトウチマイマイ" | npx @geolonia/view-geojson

(Option) with Deno

$ git clone [email protected]:kamataryo/inat-convex.git
$ cd inat-convex
$ deno run ./src/shims/deno.ts

more samples

||| |---|---| |Euhadra quaesita (ヒダリマキマイマイ)|Euhadra subnimbosa (セトウチマイマイ)| ||| |$ npx @kamataryo/inat-convex "ヒダリマキマイマイ" \| npx @geolonia/view-geojson | $ npx @kamataryo/inat-convex "セトウチマイマイ" \| npx @geolonia/view-geojson| |Arctic Char (ホッキョクイワナ)|Char (イワナ)| ||| |$ npx @kamataryo/inat-convex "Arctic Char" \| npx @geolonia/view-geojson|$ npx @kamataryo/inat-convex "salvelinus leucomaenis" \| npx @geolonia/view-geojson|

Note

Quality of data

The output distribution area is just a convex of sampled observation points and does not reflect detailed.

Resources

This tool makes a maximum of 5 HTTP requests / 5 seconds / 1 command execution against www.inaturalist.org from your environment. and please note the iNaturalist rate limit. We have not yet implemented an authentication flow using the iNaturalist API tokens. If you are interested in, please submit an issue or a pull request.

Acknowledgments

This tool wraps iNaturalist API. I would like to thanks to all iNaturalist users and the great platform.