Skip to content

Latest commit

 

History

History
 
 

cli

Folders and files

NameName
Last commit message
Last commit date

parent directory

..
src
src
 
 
test
test
 
 
README.md
README.md
 
 
package.json
package.json
 
 
tsconfig.json
tsconfig.json
 
 

README.md

@allmaps/cli

Installation

With pnpm:

pnpm add -g @allmaps/cli

Run Allmaps CLI:

allmaps

Examples

Turn masks of georeferenced maps into GeoJSON

Manifest URL:

Use Allmaps API to find Georef Annotation:

Fetch Georef Annotation with cURL, pipe to Allmaps CLI and transform pixel mask to GeoJSON:

curl -L "https://annotations.allmaps.org/?url=https://collections.leventhalmap.org/search/commonwealth:4t64k3596/manifest" \
| allmaps transform pixel-mask

You can pipe as multiple Georef Annotations to Allmaps CLI:

Manifest URLs:

Georef Annotations:

Concatenate these two Georef Annotations with Bash and transform pixel masks to GeoJSON:

cat \
<(curl -L "https://annotations.allmaps.org/?url=https://collections.leventhalmap.org/search/commonwealth:4t64k3596/manifest") \
<(curl -L "https://annotations.allmaps.org/?url=https://collections.leventhalmap.org/search/commonwealth:6108xt43s/manifest") \
| allmaps transform pixel-mask

Combine multiple Georef Annotations

Allmaps CLI can combine multiple Georef Annotations and output them as a single AnnotationPage:

cat \
<(curl https://annotations.allmaps.org/manifests/f2aa771c7d0ae1e8) \
<(curl https://annotations.allmaps.org/images/813b0579711371e2) \
| allmaps annotation generate

If you have a directory containing multiple Georef Annotations, you can run:

cat *.json | allmaps annotation generate

If you're running MacOS, you can use pbcopy to copy the generated Georef Annotation to your clipboard:

cat *.json | allmaps annotation generate | pbcopy