-
Notifications
You must be signed in to change notification settings - Fork 0
Home
Georeference the target atlas using Allmaps. Track its progress using the Notion database for Geotransformation Progress. When it’s done, proceed to next step.
- Mint a new ARK ID for the layer at https://geoservices.leventhalmap.org/identifier-mint
- Create a new directory, using that ARK ID as the name
- From the terminal,
cd
into that directory
When you’re in the directory, run atlascopify.py
.
See this repo for instructions on setting up and using the script: https://github.com/bplmaps/atlascope-utilities/tree/master/modern-workflow
You must manually update metadata in the tileset.json
file. This file will be located in the output
directory after Atlascopify finishes running. You must update these fields:
Field | Description | Example |
---|---|---|
name | Short name | sanborn 1913 |
description | Full title of atlas, creator, and publication date | Saugus, Essex County, Massachusetts (Sanborn Map Company, 1913) |
tiles | Endpoint of XYZ tiles---update the ARK ID with new LMEC mint | https://s3.us-east-2.wasabisys.com/urbanatlases/{{ARK_ID}}/tiles/{z}/{x}/{y}.png |
data | Endpoint of plates.geojson file---update the ARK ID with new LMEC | https://s3.us-east-2.wasabisys.com/urbanatlases/alzlfodgx/plates.geojson |
bounds | Extent of plates.geojson file---retrieve these using, e.g., QGIS | [-71.0884748428381528, 42.4150678821869533, -71.0369536836220732, 42.4361320871470866] |
You must manually update the volume extents file, which involves adding a new object to the GeoJSON in an editor such as VS Code or QGIS. To do so:
- Ensure you’ve cloned LMEC’s digital metadata library repository: https://github.com/bplmaps/lmec-digital-library-metadata/tree/main
- From that repository, open
boston-volume-extents.geojson
in VS Code - From your working repository for the new atlas layer, open
/tmp/plates-precise.geojson
in VS Code - Replace all the metadata in the
properties
object - Confirm everything looks okay by loading and examining the
geojson
in QGIS
Once you’re done, push it to GitHub.
Make sure that you have installed and set up the FTP client Cyberduck in order to access LMEC’s Wasabi cloud storage. To add a fully geotransformed urban atlas layer and its attendant metadata to Wasabi:
- Create a new directory in the
urbanatlases
folder of Wasabi, named after the newly minted ARK ID - Hand-copy everything in the
output
folder, which should just beplates.geojson
-
tiles
directory tileset.json
This can take a while—a long, long while, like 24-48 hours—for some larger atlases.
❗ Make sure you are working on the staging branch of `atlascope-v2`Make sure the new layers look good by testing them in a local instance of Atlascope. To do this, cd
into your local repo of atlascope-v2
and run:
npm run dev
Once it’s running, open /src/instance.json
in the Atlascope repository and replace the value of historicLayersFootprintsFile
with:
Then look at the new layer and make sure it looks right (sometimes this can be buggy and take a minute). If something doesn’t look right, you may need to open a browser inspection and check what kinds of errors are being thrown.
Once it’s done, merge staging into main and wait for approval.