From faf8e735d1e351bbfa4db17d536ca87d1a5f1376 Mon Sep 17 00:00:00 2001 From: lrnselfreliance <33263708+lrnselfreliance@users.noreply.github.com> Date: Fri, 20 Nov 2026 17:22:21 -0700 Subject: [PATCH] A map is exported as a PDF: a 1:24,000 quadrangle, in layers, on a sheet, which says where it is (#1006) * The map can choose a 1:24,000 quadrangle to export (#971) The first part of exporting a map as a PDF: a grid of 7.5-minute quadrangles is drawn over the map, and a click chooses one. The grid is arithmetic, so it needs no data. Exporting itself is not here yet; the button is disabled. Co-authored-by: Claude Fable 5.2 * A quadrangle of the map is exported as a PDF with a layer for each map layer (#972) * A quadrangle of the map is exported as a PDF with a layer for each map layer The browser draws the quadrangle off the screen at the size of a 1:24,000 sheet, once for each layer which is on, and the API puts the images in a PDF, each in a layer of its own which a reader can show and hide. A layer in which nothing is drawn is left out. Co-Authored-By: Claude Fable 5.2 * The exported map's canvas keeps what was drawn, and an export's memory is bounded - The drawing buffer is asked for where this MapLibre reads it (canvasContextAttributes); as an option of the map it was ignored, so the canvas could be read after it was cleared. - Each layer's pixels are compressed in the PDF as the layer is added. PyMuPDF kept them uncompressed until the PDF was written: about 90 MB a layer of a quadrangle, all at once. - The pixels of all the layers together are limited, before any image is decoded. - pymupdf is imported when a PDF is made, not when the API starts. Co-Authored-By: Claude Fable 5.2 --------- Co-authored-by: Claude Fable 5.2 * An exported map says where on the Earth it is (#973) * An exported map says where on the Earth it is The PDF's page has a geospatial viewport (ISO 32000-2): the page is the map in Web Mercator, with the latitude and longitude of each corner. The corners are the edges of the picture the browser drew, read from the map which drew it. Co-Authored-By: Claude Fable 5.2 * A map whose edge is the antimeridian can be exported The map's arithmetic puts the east edge of the last quadrangle before the antimeridian a rounding error past 180 degrees, and the export was refused. An edge within 1e-8 of a degree of 180 is at 180 (it is not wrapped to -180); a map which is really across the antimeridian is still refused. Co-Authored-By: Claude Fable 5.2 --------- Co-authored-by: Claude Fable 5.2 * An exported map is on a sheet: a margin, a grid, scale bars and notes (#974) * An exported map is on a sheet: a margin, a grid, scale bars and notes The map is put on a larger page with what a topographic map has around it: a title, the latitude and longitude of its corners and of ticks between them, scale bars (kilometers, miles, feet), and notes of the projection, the grid and where the map's data is from. Over the map is a 1,000 meter UTM grid, each line named in the margin. The grid and the margin are PDF layers of their own. The PDF says where the map is, not where the page is. The picker has a box to export the map alone. Co-Authored-By: Claude Fable 5.2 * The scale of a narrow map is written under its name, not over it A quadrangle near a pole is two inches wide, which is not room for its name and its scale on one line. Co-Authored-By: Claude Fable 5.2 --------- Co-authored-by: Claude Fable 5.2 * An exported map says where a compass points (#975) * An exported map says where a compass points The sheet has a diagram of the three norths (true, grid and magnetic) beside its scale bars, and a note of how far magnetic north is from true north on the day the map was made, and how fast it moves. The declination is from the World Magnetic Model 2025 (NOAA NCEI and the British Geological Survey; public domain), whose coefficient file is shipped: nothing is downloaded. The model is good until 2030; outside its years nothing is said of a compass. Co-Authored-By: Claude Fable 5.2 * A corner of an exported map is not also a tick The edges of the picture the browser draws are a hair outside the quadrangle's, so the quadrangle's own edges were taken for ticks inside the map, and each was written over the coordinate of its corner. Co-Authored-By: Claude Fable 5.2 * A compass which passes due south has moved a little, not most of the way around Co-Authored-By: Claude Fable 5.2 --------- Co-authored-by: Claude Fable 5.2 * A map can be exported at 400 DPI (#976) The picker has a choice of 300 or 400 DPI. A map is drawn less sharp than was asked for, rather than refused, when it would be more pixels than the API makes a PDF of: a quadrangle near the equator, or one with many layers on. The picker says so while it draws. Co-authored-by: Claude Fable 5.2 * An exported quadrangle goes by the name the USGS gives it (#977) * An exported quadrangle goes by the name the USGS gives it The picker says what the chosen quadrangle is called, and the sheet's title, the PDF's title and the file's name have it. Where the USGS has no name, which is most of the world, a quadrangle goes by where it is, as before. The names are an index of the 65,600 7.5 minute quadrangles of The National Map (U.S. Geological Survey; public domain), which is shipped: nothing is downloaded. In Alaska a USGS quadrangle is wider than 7.5 minutes, so a quadrangle of the picker's grid there is "Part of" the one which has its middle. The places the tests of the map export are of are changed for others. Co-Authored-By: Claude Fable 5.2 * An area half of which is the last quadrangle of the land is a part of it The middle of such an area is on the quadrangle's east or north edge, with no quadrangle beyond it, and it was given no name. Co-Authored-By: Claude Fable 5.2 --------- Co-authored-by: Claude Fable 5.2 * The PDF of a map is made by a Job, which the browser watches (#978) * The PDF of a map is made by a Job, which the browser watches A PDF of a quadrangle is a minute or two of work on a Raspberry Pi 4, and the request which waited for it was cut off after a minute: only the smallest quadrangles could be exported there. Now the browser describes the map, sends the image of each layer in a request of its own, and starts a Job; it watches the Job, shows how far along it is, and fetches the PDF when the Job is done. Cancel stops the Job. The images are kept on disk until the PDF is made of them, and an export is removed when it is an hour old. The credits on the sheet are no longer cut off: an attribution which names many sources is each of them. Co-Authored-By: Claude Fable 5.2 * A cancelled map export stops, and is removed - A cancelled Job is not over until the thread making the PDF has stopped, so the next Job does not start beside it; the work can also be stopped while the sheet is drawn and the PDF written. - DELETE /api/map/export/ stops an export at any step and removes what was sent; the browser calls it when the person exporting cancels, while layers are sent as well as while the PDF is made. - An export whose Job is waiting or running is not removed for being old; one whose Job was cancelled is removed at once. - Cancel while the map is drawn stops the drawing between two layers. - Exports are kept in a directory made for this user alone, which is refused when it is a link or is another user's; only what is an export there is removed. - A request for the finished PDF which is lost is made again. Co-Authored-By: Claude Fable 5.2 --------- Co-authored-by: Claude Fable 5.2 * An overlay's areas and lines go under the map's labels, and its own labels over them (#979) An overlay was drawn whole over the basemap, so an area it filled covered the names of what is in it. Labels are now always on top: the areas, lines and pictures of every overlay are under the basemap's labels, and the text, icons and points of every overlay are over them. It is so in the map, the standalone viewer, and an exported PDF, where an overlay with both is two layers ("Towers" and "Towers (labels)"). Co-authored-by: Claude Fable 5.2 * An overlay's ground is over the ground of every basemap file (#980) * An overlay's ground is over the ground of every basemap file On a map of several basemap files, the ground of an overlay was put before the first label of the first file, which is under the land, water and roads of every file after it: an overlay's areas and lines were hidden, and in an exported PDF its layer was just above the background. It goes where the basemap's labels begin: the first of the labels which are over all of the basemap's ground. Co-Authored-By: Claude Fable 5.2 * The labels of every basemap file are over the ground of every file A map of several basemap files was their layers one file after another, so only the labels of the last file were on top: the labels of the others were under the land, water and roads of the files after them, and under the ground of an overlay. Both viewers now draw the ground of every file and then the labels of every file. The contour lines are drawn after the basemap's labels and are not of the basemap: an overlay's ground goes under the basemap's labels, not under the contours instead. Co-Authored-By: Claude Fable 5.2 --------- Co-authored-by: Claude Fable 5.2 * Contours are drawn from as deep as the terrain file goes (#981) The map read a terrain file to zoom 8, which is how deep the terrain WROLPi offers goes, however deep the file was. It now reads a file as deep as the file says it goes, in both viewers, and draws finer contour lines from a deeper file: every 40 feet (or 20 meters) from zoom 11, as a 1:24,000 sheet has. A file which goes to zoom 8 is drawn as it was. Co-authored-by: Claude Fable 5.2 * An exported map names its small roads (#982) * An exported map names its small roads A quadrangle is drawn at about zoom 13. The basemap's style names small roads from zoom 15, and its tiles have no names for them below zoom 14, so the streets of a town were printed as lines with no names. Before the map is drawn, the tiles of zoom 14 which the quadrangle is in are read, and the roads in them which have a name are given to the export map as a source of its own. The layer which names small roads draws from that source, as its style says to. At the scale of a sheet most streets are shorter than their names, and a map writes a name along a line only where the line is longer. Such a road is named over its middle, turned as the road goes; a road in pieces is named once. A source whose tiles can not be read is exported as before. Co-Authored-By: Claude Fable 5.2 * The names of small roads are placed by the export, at every latitude A quadrangle nearer the equator is drawn at a little over zoom 14, where the names were not read and the style still kept them for zoom 15: such a map had no names of small roads. They are now read wherever a layer would not name roads. Every name of a small road is now a point: over the middle of its road, turned as the road goes under it, again every 400 pixels of a long road. Before, a road long enough was left for the map to name along its line, which the map often does not (the line bends, or is in pieces), and a short piece beside it was named too. One place decides where a road is named, so a road in pieces is named once, and a piece of another kind of road does not take the name. Reading the names can be cancelled. Co-Authored-By: Claude Fable 5.2 --------- Co-authored-by: Claude Fable 5.2 * A sheet has a bar of meters, its norths in mils, and how far apart its contour lines are (#983) Under the map are bars of kilometers, meters, miles and feet. How far the grid's north and a compass's north are from true north is written in mils as well as in degrees, in the diagram and in the notes: a compass may be marked in either. A map which is exported with its contour lines says how far apart they are (CONTOUR INTERVAL 40 FEET), under the bars. The browser knows: it is the interval of the tiles the lines are made for at the zoom of the sheet, in the unit the map measures in. It says so with the sheet, and what is not an interval is not written. Co-authored-by: Claude Fable 5.2 * A sheet says what the quadrangles around it are called (#984) * A sheet says what the quadrangles around it are called Under the scale bars is a diagram of nine squares, the map the middle one, and beside it what the USGS calls each of the eight around it: the sheets to print to carry on off the edge of this one. The names are from the index of quadrangles which names the sheet itself. A quadrangle with no name (out to sea, or over a border) has no number; a map of where the USGS names nothing, and a map too narrow for the diagram, go without. Co-Authored-By: Claude Fable 5.2 * A sheet is never beside itself Where a quadrangle of the USGS is wider than the map (Alaska), the area the size of the map to its east or west is often more of the quadrangle the map is in, and the diagram named the sheet as its own neighbor. The quadrangle on a side is now the next one which is not the map's own. Co-Authored-By: Claude Fable 5.2 --------- Co-authored-by: Claude Fable 5.2 * A sheet has a legend of the lines of its map (#985) * A sheet has a legend of the lines of its map Under the scale bars is what each kind of line of the map is: highway, major road, minor road, path, railway, boundary, contour and index contour, each a piece of the line as the map draws it, on the color of the map's land. The map's style says how a line is drawn at each zoom, and a sheet is drawn at one. The browser, which has the style, says what each line's color, width, dashes and edges are at that zoom; the API draws them. A line is in the legend when its layer is exported and draws something at that zoom. What the browser sends is made into lines before it is kept: what is not a line is left out, and the map is exported. Co-Authored-By: Claude Fable 5.2 * A legend has no line too thin to see, and no name longer than its room A style brings a line in from nothing as the map is zoomed in: a path is a few hundredths of a point wide on a quadrangle near the equator. It was in the legend, drawn several times wider than on the map. A line under a tenth of a point is now left out, by the browser and by the API. What a line is called is cut to the room beside its line, as the name of an adjoining quadrangle is. Co-Authored-By: Claude Fable 5.2 --------- Co-authored-by: Claude Fable 5.2 * Fixes to the map PDF export: wrong neighbors, leftover exports, exports which outlive the map (#989) * A sheet names what is around it, and its edges, by where they are and not a hair from there The edges the browser gives of a map are a hair outside its quadrangle. The quadrangles around a map whose middle is on the edge two share (every other map of Alaska) were those around the map west of it, and one of them was the map itself. An edge a hair south of the equator was 0 degrees south, a map which ended where the UTM zones do had no grid, and a sheet dated in the last year there is could not be made. Co-Authored-By: Claude Fable 5.2 * An export is removed when it is over, and its work stops when the API does The images and the PDF of an export were kept until the next export began, however long that was. The browser now has the export removed however it ends, and old exports are removed when a PDF is made too. The work of a Job which ended because the API was stopping went on to the end of the PDF, with the API waiting for it. What is said of an export, and each image, is written whole. Text which is no text is taken out when an export begins, not found by the Job. Co-Authored-By: Claude Fable 5.2 * An export stops with its map, and waits for a page which can not be seen Leaving the map while it was exported left the export going, to fail or to hand a PDF to another page; so did closing the picker, which is now left open. A PDF which arrives after the export was stopped is not saved. The time a page is behind another tab is not counted against a map which is drawing. The name of a road is one line. A photograph which ends a little inside the map is not made a JPEG with a black strip. An accent in the name of a quadrangle is not a gap in the name of its file. Co-Authored-By: Claude Fable 5.2 * A PDF is not kept from who made it by a server slow to remove the export Co-Authored-By: Claude Fable 5.2 --------- Co-authored-by: Claude Fable 5.2 * An exported map has its water over its parks (#990) * A sheet names what is around it, and its edges, by where they are and not a hair from there The edges the browser gives of a map are a hair outside its quadrangle. The quadrangles around a map whose middle is on the edge two share (every other map of Alaska) were those around the map west of it, and one of them was the map itself. An edge a hair south of the equator was 0 degrees south, a map which ended where the UTM zones do had no grid, and a sheet dated in the last year there is could not be made. Co-Authored-By: Claude Fable 5.2 * An export is removed when it is over, and its work stops when the API does The images and the PDF of an export were kept until the next export began, however long that was. The browser now has the export removed however it ends, and old exports are removed when a PDF is made too. The work of a Job which ended because the API was stopping went on to the end of the PDF, with the API waiting for it. What is said of an export, and each image, is written whole. Text which is no text is taken out when an export begins, not found by the Job. Co-Authored-By: Claude Fable 5.2 * An export stops with its map, and waits for a page which can not be seen Leaving the map while it was exported left the export going, to fail or to hand a PDF to another page; so did closing the picker, which is now left open. A PDF which arrives after the export was stopped is not saved. The time a page is behind another tab is not counted against a map which is drawing. The name of a road is one line. A photograph which ends a little inside the map is not made a JPEG with a black strip. An accent in the name of a quadrangle is not a gap in the name of its file. Co-Authored-By: Claude Fable 5.2 * An exported map has its water over its parks A layer of the PDF was one image, drawn where the topmost of its layers is. The parks of Land Cover are under the water on the map and its piers are over it, so all of Land Cover was drawn over the water: a lake in a park, or among houses, was not on the PDF. A second basemap file put its water over the first's buildings. A layer is now as many images as it must be, each where it is on the map, in one layer of the PDF: a part which fills an area stays where it is, and a part which is only lines is drawn with the next. Co-Authored-By: Claude Fable 5.2 * A PDF is not kept from who made it by a server slow to remove the export Co-Authored-By: Claude Fable 5.2 * A map file which is of somewhere else is not drawn when a map is exported Each basemap file is several images of an exported map, and most files of a library are of other places: each was an image of nothing, counted against how many images an export may be and how sharp it may be. A file whose own edges are outside the quadrangle is now left out before the layers are counted. Co-Authored-By: Claude Fable 5.2 --------- Co-authored-by: Claude Fable 5.2 * An exported map has its streams (#991) A basemap draws streams from zoom 14, and service roads and taxiways from 13. A quadrangle is drawn a little short of that (zoom 13.8 at 40 degrees, 13.2 at 61), from tiles which have them: none were on the PDF. What is drawn from a zoom no deeper than a quadrangle's detail is drawn. Names are left as they are. Co-authored-by: Claude Fable 5.2 * An export which is cancelled stops at once, in the middle of a request (#993) * An export which is cancelled stops at once, in the middle of a request An export was stopped between two requests. The image of a layer is tens of megabytes, which is a long request on a slow connection, and a request to a server which has stopped answering never ends: the export said it was stopping until then. Cancel, and leaving the map, now end the request. Co-Authored-By: Claude Fable 5.2 * The requests an export makes after its layers are sent are seen to be stopped too Co-Authored-By: Claude Fable 5.2 --------- Co-authored-by: Claude Fable 5.2 * A map is exported as it is printed: on white, in dark lines (#996) * A map is exported as it is printed: on white, in dark lines The light and dark maps are made for a screen. On paper their roads are white on pale gray and their streams half a pixel of pale blue. The printed map is a third look, of the map's own: white ground, dark road edges and names, blue streams wide enough to see, paths drawn, brown contours. It is what a map is exported in unless Light or Dark is chosen where the quadrangle is, and the choice is remembered in the browser. While a quadrangle is chosen the map is shown in the look it will be exported in. The light and dark maps are as they were. Co-Authored-By: Claude Fable 5.2 * Changing the look of the map does not move it What is done when a new style is in place was asked for after the style was set. A style which only differs from the one the map has is in place before that, so it was done at the next change of style instead, with where the map had been at this one: the map went back there when a quadrangle was chosen, and again when it was not. It is asked for first, and the map is not moved at all. An export no longer waits for the map to be still, which it need not and which nothing ended. Co-Authored-By: Claude Fable 5.2 --------- Co-authored-by: Claude Fable 5.2 * The colors of the printed map are chosen where its layers are (#997) * The colors of the printed map are chosen where its layers are While a quadrangle is chosen and the map is shown as it is printed, each layer of the layer control has its color beside it, to be changed: one for most, three for the land (what grows, what was built, sand and ice) and two for names (the name, and what is around it). A basemap has several colors where one is chosen, which are shades of it. The edge of a road stays dark. What is chosen is remembered in the browser, and can be put back. The map on the screen is as it was. Co-Authored-By: Claude Fable 5.2 * A ramp on a bridge is the color of a major road, as it is off one A basemap draws a ramp on a bridge in the color of a minor road on a bridge: on the printed map it was white where the rest of the ramp is yellow, and followed the color chosen for minor roads. What puts the colors back is a button, which a keyboard reaches. Co-Authored-By: Claude Fable 5.2 --------- Co-authored-by: Claude Fable 5.2 * A layer with nothing in it does not make an exported map less sharp (#1001) * A layer with nothing in it does not make an exported map less sharp How sharp a map may be depends on how many images it is, and every group of layers was counted: a basemap file with no runway, highway or boundary in the quadrangle was images of nothing, drawn, sent, and counted against the rest. A map of 23 images asked for at 400 DPI was made at 330. The groups are now looked at first, on a small map, and only those with something in them are drawn, as sharp as that many may be. Co-Authored-By: Claude Fable 5.2 * An image which arrives after its export was removed is not kept, and one mil is a mil Stopping an export while an image was on its way left the image behind it, in a directory nothing would remove for an hour. An angle of one mil was "1 mils" on the sheet. Co-Authored-By: Claude Fable 5.2 --------- Co-authored-by: Claude Fable 5.2 * The map which is exported from is made as sharp as it is to be (#1002) * The map which is exported from is made as sharp as it is to be The groups of a map are looked at on a small map, which was then made larger to draw them. A browser lets a canvas be larger when it is made than it lets one be made larger afterwards: a quadrangle asked for at 400 DPI was 33 million pixels, 288 DPI at 40 degrees, less than before the groups were looked at first. The small map is now removed, and the map which is exported from is made in its place. Co-Authored-By: Claude Fable 5.2 * A canvas the browser stopped drawing on is not a layer with nothing in it A canvas whose drawing was taken away by the browser reads as clear, and a group looked at then was left out of the PDF without a word: the export fails instead. An export stopped as the last group is looked at does not make the map it would have been drawn on. Co-Authored-By: Claude Fable 5.2 --------- Co-authored-by: Claude Fable 5.2 * An exported map says where it is in a projection Adobe Acrobat knows (#1003) * An exported map says where it is in a projection Adobe Acrobat knows The page was said to be in Web Mercator, which it is drawn in. Acrobat does not know Web Mercator, in the words of the standard or in Esri's: it took the page for a map, and put every place on it at 0, 0. The page is now said to be Mercator on the WGS 84 ellipsoid, which it reads, with the same corners. Between the corners the two differ by under three centimeters on the ground. Co-Authored-By: Claude Fable 5.2 * How well a page is said to be where it is, is measured from what the PDF says The test of it measured two formulas of its own. It now reads the corners and the projection from the PDF and does a reader's sum with them. The few centimeters are of a quadrangle: a taller page is less well said, by the square of how tall it is, which the comment now says and a test measures. Co-Authored-By: Claude Fable 5.2 --------- Co-authored-by: Claude Fable 5.2 * The help says how a map is exported as a PDF (#1004) The help of the map is five pages, one of them the PDF export. Co-authored-by: Claude Fable 5.2 --------- Co-authored-by: Claude Fable 5.2 --- app/package-lock.json | 2 + app/package.json | 6 +- app/src/api.exportMapPdf.test.js | 262 ++++ app/src/api.js | 152 +++ app/src/components/MapQuadPicker.js | 263 ++++ app/src/components/MapQuadPicker.test.js | 315 +++++ app/src/components/MapViewer.js | 324 ++++- app/src/components/MapViewerOverlays.test.js | 90 +- app/src/components/mapExport.js | 739 ++++++++++++ app/src/components/mapExport.test.js | 1123 ++++++++++++++++++ app/src/components/mapExportLegend.js | 117 ++ app/src/components/mapExportLegend.test.js | 133 +++ app/src/components/mapOverlays.test.js | 140 ++- app/src/components/mapPrintStyle.js | 353 ++++++ app/src/components/mapPrintStyle.test.js | 151 +++ app/src/components/mapQuads.js | 128 ++ app/src/components/mapQuads.test.js | 111 ++ app/src/components/mapTiles.js | 29 + app/src/components/mapTiles.test.js | 51 + app/src/map-shared/map-shared.test.js | 8 +- app/src/map-shared/overlays.js | 75 +- app/src/map-shared/terrain.js | 59 + app/src/map-shared/terrain.test.js | 96 ++ docker/help/wrolpi-help | 2 +- modules/map/api.py | 145 ++- modules/map/conftest.py | 9 + modules/map/export.py | 295 +++++ modules/map/export_job.py | 321 +++++ modules/map/magnetic.py | 121 ++ modules/map/quads.py | 117 ++ modules/map/quads/usgs_7_5_minute.tsv.gz | Bin 0 -> 637589 bytes modules/map/sheet.py | 871 ++++++++++++++ modules/map/static/index.html | 39 +- modules/map/static/js/overlays.js | 75 +- modules/map/static/js/terrain.js | 59 + modules/map/test/test_export.py | 581 +++++++++ modules/map/test/test_export_job.py | 422 +++++++ modules/map/test/test_magnetic.py | 50 + modules/map/test/test_quads.py | 112 ++ modules/map/test/test_sheet.py | 737 ++++++++++++ modules/map/wmm/WMM2025.COF | 93 ++ wrolpi/scripts/build_map_quad_names.py | 70 ++ 42 files changed, 8744 insertions(+), 102 deletions(-) create mode 100644 app/src/api.exportMapPdf.test.js create mode 100644 app/src/components/MapQuadPicker.js create mode 100644 app/src/components/MapQuadPicker.test.js create mode 100644 app/src/components/mapExport.js create mode 100644 app/src/components/mapExport.test.js create mode 100644 app/src/components/mapExportLegend.js create mode 100644 app/src/components/mapExportLegend.test.js create mode 100644 app/src/components/mapPrintStyle.js create mode 100644 app/src/components/mapPrintStyle.test.js create mode 100644 app/src/components/mapQuads.js create mode 100644 app/src/components/mapQuads.test.js create mode 100644 app/src/components/mapTiles.js create mode 100644 app/src/components/mapTiles.test.js create mode 100644 app/src/map-shared/terrain.js create mode 100644 app/src/map-shared/terrain.test.js create mode 100644 modules/map/export.py create mode 100644 modules/map/export_job.py create mode 100644 modules/map/magnetic.py create mode 100644 modules/map/quads.py create mode 100644 modules/map/quads/usgs_7_5_minute.tsv.gz create mode 100644 modules/map/sheet.py create mode 100644 modules/map/static/js/terrain.js create mode 100644 modules/map/test/test_export.py create mode 100644 modules/map/test/test_export_job.py create mode 100644 modules/map/test/test_magnetic.py create mode 100644 modules/map/test/test_quads.py create mode 100644 modules/map/test/test_sheet.py create mode 100644 modules/map/wmm/WMM2025.COF create mode 100644 wrolpi/scripts/build_map_quad_names.py diff --git a/app/package-lock.json b/app/package-lock.json index 06f1831b..62f30a43 100644 --- a/app/package-lock.json +++ b/app/package-lock.json @@ -14,6 +14,7 @@ "@mantine/core": "^8.3.18", "@mantine/hooks": "^8.3.18", "@mantine/notifications": "^8.3.18", + "@mapbox/vector-tile": "^2.0.4", "@maplibre/maplibre-gl-style-spec": "^24.8.5", "@tabler/icons-react": "^3.50.0", "@testing-library/react": "^13.4.0", @@ -25,6 +26,7 @@ "maplibre-gl": "^5.24.0", "markdown-it": "^15.0.3", "mathjs": "^15.2.0", + "pbf": "^4.0.1", "pmtiles": "^4.5.0", "protomaps-themes-base": "^4.5.0", "query-string": "^10.0.0", diff --git a/app/package.json b/app/package.json index b8505ce0..6ccdda79 100644 --- a/app/package.json +++ b/app/package.json @@ -9,6 +9,7 @@ "@mantine/core": "^8.3.18", "@mantine/hooks": "^8.3.18", "@mantine/notifications": "^8.3.18", + "@mapbox/vector-tile": "^2.0.4", "@maplibre/maplibre-gl-style-spec": "^24.8.5", "@tabler/icons-react": "^3.50.0", "@testing-library/react": "^13.4.0", @@ -20,6 +21,7 @@ "maplibre-gl": "^5.24.0", "markdown-it": "^15.0.3", "mathjs": "^15.2.0", + "pbf": "^4.0.1", "pmtiles": "^4.5.0", "protomaps-themes-base": "^4.5.0", "query-string": "^10.0.0", @@ -40,7 +42,7 @@ "test": "TZ=America/New_York react-scripts test", "eject": "react-scripts eject", "cy:run": "cypress run", - "sync:map-shared": "mkdir -p ../modules/map/static/js && cp src/map-shared/overlays.js src/map-shared/overlayStyle.js ../modules/map/static/js/", + "sync:map-shared": "mkdir -p ../modules/map/static/js && cp src/map-shared/overlays.js src/map-shared/overlayStyle.js src/map-shared/terrain.js ../modules/map/static/js/", "cy:open": "cypress open" }, "eslintConfig": { @@ -75,7 +77,7 @@ "^.+\\.(js|jsx|mjs|cjs|ts|tsx)$": "/jest/babelTransform.js" }, "transformIgnorePatterns": [ - "node_modules/(?!(react-hotkeys-hook|three)/)" + "node_modules/(?!(react-hotkeys-hook|three|@mapbox/vector-tile|@mapbox/point-geometry|pbf)/)" ] }, "overrides": { diff --git a/app/src/api.exportMapPdf.test.js b/app/src/api.exportMapPdf.test.js new file mode 100644 index 00000000..77360f60 --- /dev/null +++ b/app/src/api.exportMapPdf.test.js @@ -0,0 +1,262 @@ +import {ExportCancelled, exportMapPdf} from './api'; + +const MAP = { + width: 60, height: 90, dpi: 300, title: 'A quadrangle', bounds: [-150, 61.125, -149.875, 61.25], + sheet: {name: 'A quadrangle', credits: [], date: '2026-11-15'}, + layers: [{name: 'Background', blob: new Blob(['background'])}, {name: 'Water', blob: new Blob(['water'])}], +}; + +const reply = (status, body) => ({ + ok: status >= 200 && status < 300, + status, + json: () => Promise.resolve(body), + blob: () => Promise.resolve(body), + clone() { + return this; + }, +}); + +// A server whose Job says each of `jobs` in turn, and then the last of them. +function fakeServer(jobs, {pdf = new Blob(['%PDF-']), replies = {}} = {}) { + const calls = []; + let asked = 0; + global.fetch = jest.fn(async (url, init = {}) => { + const path = String(url).replace(/^.*\/api/, ''); + const method = init.method || 'GET'; + calls.push(`${method} ${path}`); + if (replies[`${method} ${path}`]) return replies[`${method} ${path}`](); + if (path === '/map/export') return reply(201, {export_id: 'abc'}); + if (path.startsWith('/map/export/abc/layer/')) return reply(204, null); + if (path === '/map/export/abc/start') return reply(202, {job_id: 'job-1'}); + if (path === '/map/export/abc' && method === 'DELETE') return reply(204, null); + if (path === '/jobs/job-1') return reply(200, {job: jobs[Math.min(asked++, jobs.length - 1)]}); + if (path === '/map/export/abc/pdf') return reply(200, pdf); + return reply(404, {error: 'Not found'}); + }); + return calls; +} + +describe('exportMapPdf', () => { + afterEach(() => { + delete global.fetch; + }); + + test('describes the map, sends each layer, watches the Job, and fetches the PDF', async () => { + const pdf = new Blob(['%PDF-']); + const calls = fakeServer([ + {status: 'pending'}, {status: 'running', progress: 12.4}, {status: 'running', progress: 75}, + {status: 'complete'}, + ], {pdf}); + const statuses = []; + + const result = await exportMapPdf(MAP, {onStatus: text => statuses.push(text), pollMs: 0}); + + expect(result).toBe(pdf); + expect(calls).toEqual([ + 'POST /map/export', + 'POST /map/export/abc/layer/0', + 'POST /map/export/abc/layer/1', + 'POST /map/export/abc/start', + 'GET /jobs/job-1', 'GET /jobs/job-1', 'GET /jobs/job-1', 'GET /jobs/job-1', + 'GET /map/export/abc/pdf', + // With the PDF in hand, the server need keep nothing of the export. + 'DELETE /map/export/abc', + ]); + expect(statuses).toEqual([ + 'Sending the map…', + 'Sending Background (1 of 2)…', + 'Sending Water (2 of 2)…', + 'Starting the PDF…', + 'Making the PDF (12%)…', + 'Making the PDF (75%)…', + 'Fetching the PDF…', + ]); + // The map is described without its images, and each image is sent as it is. + const [, described] = global.fetch.mock.calls[0]; + expect(JSON.parse(described.body)).toEqual({ + width: 60, height: 90, dpi: 300, title: 'A quadrangle', bounds: MAP.bounds, sheet: MAP.sheet, + layers: ['Background', 'Water'], + }); + expect(global.fetch.mock.calls[2][1].body).toBe(MAP.layers[1].blob); + }); + + test('says it is waiting when another job is in the way', async () => { + fakeServer([...Array(5).fill({status: 'pending'}), {status: 'complete'}]); + const statuses = []; + await exportMapPdf(MAP, {onStatus: text => statuses.push(text), pollMs: 0}); + expect(statuses.slice(3)).toEqual([ + 'Starting the PDF…', 'Starting the PDF…', 'Starting the PDF…', + 'Waiting for another job to finish…', 'Waiting for another job to finish…', + 'Fetching the PDF…', + ]); + }); + + test('says why the map was refused', async () => { + fakeServer([], {replies: {'POST /map/export': () => reply(400, {error: 'A map of 0x0 pixels can not be exported'})}}); + await expect(exportMapPdf(MAP, {pollMs: 0})).rejects.toThrow('A map of 0x0 pixels can not be exported'); + }); + + test('gives the PDF without waiting for the server to remove the export', async () => { + const pdf = new Blob(['%PDF-']); + const calls = fakeServer([{status: 'complete'}], { + // The server never answers. + pdf, replies: {'DELETE /map/export/abc': () => new Promise(() => undefined)}, + }); + expect(await exportMapPdf(MAP, {pollMs: 0})).toBe(pdf); + expect(calls.at(-1)).toBe('DELETE /map/export/abc'); + }); + + test('has the server remove what was sent when the export fails', async () => { + const calls = fakeServer([{status: 'complete'}], { + replies: {'POST /map/export/abc/layer/1': () => Promise.reject(new Error('network'))}, + }); + await expect(exportMapPdf(MAP, {pollMs: 0})).rejects.toThrow('Could not reach the server'); + expect(calls.at(-1)).toBe('DELETE /map/export/abc'); + }); + + test('says why the Job failed', async () => { + const calls = fakeServer([{status: 'running', progress: 0}, {status: 'failed', error: 'The layer is 10x10'}]); + await expect(exportMapPdf(MAP, {pollMs: 0})).rejects.toThrow('The layer is 10x10'); + expect(calls).not.toContain('GET /map/export/abc/pdf'); + }); + + test('stops before anything is sent when it was already cancelled', async () => { + const calls = fakeServer([{status: 'complete'}]); + await expect(exportMapPdf(MAP, {isCancelled: () => true})).rejects.toBeInstanceOf(ExportCancelled); + expect(calls).toEqual([]); + }); + + test('has the server remove what was sent when it is stopped while layers are sent', async () => { + const calls = fakeServer([{status: 'complete'}]); + // Stopped once the first layer has been sent. + const rejected = exportMapPdf(MAP, {pollMs: 0, isCancelled: () => calls.includes('POST /map/export/abc/layer/0')}); + await expect(rejected).rejects.toBeInstanceOf(ExportCancelled); + expect(calls).toEqual(['POST /map/export', 'POST /map/export/abc/layer/0', 'DELETE /map/export/abc']); + }); + + test('has the server stop the export when it is stopped while the PDF is made', async () => { + const calls = fakeServer([{status: 'running', progress: 10}]); + let polls = 0; + const rejected = exportMapPdf(MAP, { + pollMs: 0, + // Stopped once the Job has been asked about twice. + isCancelled: () => calls.includes('GET /jobs/job-1') && ++polls > 2, + }); + await expect(rejected).rejects.toMatchObject({cancelled: true}); + // The server cancels the Job of an export which is removed. + expect(calls.at(-1)).toBe('DELETE /map/export/abc'); + expect(calls).not.toContain('GET /map/export/abc/pdf'); + }); + + test('is stopped all the same when the server can not be told', async () => { + const calls = fakeServer([{status: 'running', progress: 10}], { + replies: {'DELETE /map/export/abc': () => Promise.reject(new Error('network'))}, + }); + const rejected = exportMapPdf(MAP, {pollMs: 0, isCancelled: () => calls.includes('GET /jobs/job-1')}); + await expect(rejected).rejects.toBeInstanceOf(ExportCancelled); + }); + + test('is stopped in the middle of a request, which the server may never answer', async () => { + const abort = new AbortController(); + let signals = []; + const calls = fakeServer([{status: 'complete'}], { + replies: { + // A layer which is never taken: the request ends when it is stopped, as fetch's does. + 'POST /map/export/abc/layer/1': () => new Promise((resolve, reject) => { + signals = global.fetch.mock.calls.map(([, init]) => init?.signal); + abort.signal.addEventListener( + 'abort', () => reject(Object.assign(new Error('aborted'), {name: 'AbortError'}))); + abort.abort(); + }), + }, + }); + const rejected = exportMapPdf(MAP, {pollMs: 0, signal: abort.signal}); + await expect(rejected).rejects.toBeInstanceOf(ExportCancelled); + // Every request of the export could be stopped; the one which removes it can not. + expect(signals).toEqual([abort.signal, abort.signal, abort.signal]); + expect(calls.at(-1)).toBe('DELETE /map/export/abc'); + expect(global.fetch.mock.calls.at(-1)[1].signal).toBeUndefined(); + }); + + test.each([ + ['the Job is asked after', 'GET /jobs/job-1'], + ['the PDF is fetched', 'GET /map/export/abc/pdf'], + ])('is stopped in the middle of a request while %s', async (_, request) => { + const abort = new AbortController(); + const calls = fakeServer([{status: 'complete'}], { + replies: { + [request]: () => new Promise((resolve, reject) => { + abort.signal.addEventListener( + 'abort', () => reject(Object.assign(new Error('aborted'), {name: 'AbortError'}))); + abort.abort(); + }), + }, + }); + await expect(exportMapPdf(MAP, {pollMs: 0, signal: abort.signal})).rejects.toBeInstanceOf(ExportCancelled); + // Every request up to the one which was stopped, and that one, could be stopped. + const stoppable = global.fetch.mock.calls.slice(0, -1).map(([, init]) => init?.signal); + expect(stoppable).toHaveLength(calls.indexOf(request) + 1); + expect(stoppable.every(signal => signal === abort.signal)).toBe(true); + // It is not asked again once it is stopped; the server is only told to remove the export. + expect(calls.filter(call => call === request)).toHaveLength(1); + expect(calls.at(-1)).toBe('DELETE /map/export/abc'); + }); + + test('a Job which someone else cancelled is a cancelled export', async () => { + fakeServer([{status: 'cancelled'}]); + await expect(exportMapPdf(MAP, {pollMs: 0})).rejects.toBeInstanceOf(ExportCancelled); + }); + + test('keeps asking when the server does not answer for a moment', async () => { + let failures = 3; + const calls = fakeServer([{status: 'complete'}], { + replies: { + 'GET /jobs/job-1': () => { + if (failures-- > 0) return Promise.reject(new Error('network')); + return reply(200, {job: {status: 'complete'}}); + }, + }, + }); + await exportMapPdf(MAP, {pollMs: 0}); + expect(calls.filter(i => i === 'GET /jobs/job-1')).toHaveLength(4); + }); + + test('asks for the PDF again when the request is lost, and not when it is refused', async () => { + const pdf = new Blob(['%PDF-']); + let lost = 3; + let calls = fakeServer([{status: 'complete'}], { + replies: { + 'GET /map/export/abc/pdf': () => { + if (lost === 3) { lost--; return Promise.reject(new Error('network')); } + if (lost-- > 0) return reply(502, {error: 'Bad gateway'}); + return reply(200, pdf); + }, + }, + }); + expect(await exportMapPdf(MAP, {pollMs: 0})).toBe(pdf); + expect(calls.filter(i => i === 'GET /map/export/abc/pdf')).toHaveLength(4); + // The map was drawn, sent and made into a PDF once. + expect(calls.filter(i => i === 'POST /map/export/abc/start')).toHaveLength(1); + + calls = fakeServer([{status: 'complete'}], { + replies: {'GET /map/export/abc/pdf': () => reply(409, {error: 'The PDF is gone'})}, + }); + await expect(exportMapPdf(MAP, {pollMs: 0})).rejects.toThrow('The PDF is gone'); + expect(calls.filter(i => i === 'GET /map/export/abc/pdf')).toHaveLength(1); + + calls = fakeServer([{status: 'complete'}], { + replies: {'GET /map/export/abc/pdf': () => Promise.reject(new Error('network'))}, + }); + await expect(exportMapPdf(MAP, {pollMs: 0})).rejects.toThrow('Could not fetch the PDF'); + expect(calls.filter(i => i === 'GET /map/export/abc/pdf')).toHaveLength(10); + }); + + test('gives up when the server stops answering, or has forgotten the Job', async () => { + fakeServer([], {replies: {'GET /jobs/job-1': () => Promise.reject(new Error('network'))}}); + await expect(exportMapPdf(MAP, {pollMs: 0})).rejects.toThrow('Could not reach the server'); + expect(global.fetch.mock.calls.filter(([url]) => String(url).endsWith('/jobs/job-1'))).toHaveLength(10); + + fakeServer([], {replies: {'GET /jobs/job-1': () => reply(404, {error: 'unknown'})}}); + await expect(exportMapPdf(MAP, {pollMs: 0})).rejects.toThrow('The server forgot the export'); + }); +}); diff --git a/app/src/api.js b/app/src/api.js index 2c9e741f..969eb4d6 100644 --- a/app/src/api.js +++ b/app/src/api.js @@ -1758,6 +1758,158 @@ export async function setMapDefaultLocation(lat, lon, zoom) { } } +// Make a PDF of a map from the images of its layers ({name, blob}, from the bottom up). Returns the +// PDF (a Blob); throws an Error which says what went wrong. +// `bounds` is the west, south, east and north edges of the images, in degrees. +// What exportMapPdf throws when the person exporting stopped it: not a failure to be told of. +export class ExportCancelled extends Error { + constructor() { + super('The export was cancelled'); + this.name = 'ExportCancelled'; + this.cancelled = true; + } +} + +// How many times in a row the server may not answer, while the PDF of an export is made or fetched, +// before the export is given up on: the API is busy while it makes a PDF, and a Raspberry Pi more so. +const EXPORT_POLL_FAILURES = 10; + +// Make the PDF of a map from the images of its layers (see modules/map/export_job.py). The PDF is a +// minute or two of work on a Raspberry Pi, so it is a Job: the map is described, the image of each +// layer is sent, the Job is started and watched, and the PDF is fetched when the Job is done. +// +// onStatus(text): told how far along it is. isCancelled(): asked, between steps, whether to stop; +// signal: an AbortSignal which stops it at once, in the middle of a request (an image of a layer +// is tens of megabytes, and a request to a server which has stopped answering never ends); +// the server is then told to stop the export and remove what was sent. Rejects with +// ExportCancelled when it was stopped. +// +// However it ends, the server is told to remove what it has of the export: the images are a hundred +// megabytes and the PDF tens, on a disk which may be an SD card. +export async function exportMapPdf( + {width, height, dpi, title, bounds, layers, sheet}, + {onStatus = () => undefined, isCancelled = () => false, signal = undefined, pollMs = 1000} = {}, +) { + const exports = `${API_URI}/map/export`; + let exportId = null; + // Best effort: the server removes old exports itself, later. An export which is stopped while + // it is being described has no id yet to remove it by: what the server made of it is one small + // file, which it removes with the old ones. + const remove = async () => { + if (exportId) await fetch(`${exports}/${exportId}`, {method: 'DELETE'}).catch(() => undefined); + }; + try { + return await sendAndFetch(); + } catch (e) { + // A request which was stopped because the export was is not a failure to be told of. + throw signal?.aborted ? new ExportCancelled() : e; + } finally { + // Not waited for: a server which is slow to answer is not to keep a PDF from who made it. + remove(); + } + + async function sendAndFetch() { + const send = async (url, init, fallback) => { + let response; + try { + response = await fetch(url, {...init, signal}); + } catch (e) { + throw new Error('Could not reach the server'); + } + if (!response.ok) throw new Error(await getErrorMessage(response, fallback)); + return response; + }; + const pause = () => new Promise(resolve => setTimeout(resolve, pollMs)); + // Stopped by the person exporting: removing the export cancels its Job. + const stopIfCancelled = async () => { + if (isCancelled() || signal?.aborted) throw new ExportCancelled(); + }; + + await stopIfCancelled(); + onStatus('Sending the map…'); + const created = await send(exports, { + method: 'POST', + headers: {'Content-Type': 'application/json'}, + body: JSON.stringify({width, height, dpi, title, bounds, sheet, layers: layers.map(i => i.name)}), + }, 'Could not export the map'); + exportId = (await created.json()).export_id; + + // One layer a request: together they are more than a request may be, and more than a slow + // connection sends in the time a request is given. + for (const [index, layer] of layers.entries()) { + await stopIfCancelled(); + onStatus(`Sending ${layer.name} (${index + 1} of ${layers.length})…`); + await send(`${exports}/${exportId}/layer/${index}`, {method: 'POST', body: layer.blob}, + `Could not send ${layer.name}`); + } + + await stopIfCancelled(); + const started = await send(`${exports}/${exportId}/start`, {method: 'POST'}, 'Could not make the PDF'); + const {job_id: jobId} = await started.json(); + + let failures = 0; + let waited = 0; + while (true) { + await stopIfCancelled(); + let job; + try { + const response = await fetch(`${API_URI}/jobs/${jobId}`, {signal}); + if (response.status === 404) throw Object.assign(new Error('The server forgot the export'), {final: true}); + if (!response.ok) throw new Error('Could not ask how the PDF is coming'); + job = (await response.json()).job; + failures = 0; + } catch (e) { + if (e.final || ++failures >= EXPORT_POLL_FAILURES) { + throw e.final ? e : new Error('Could not reach the server'); + } + } + if (job?.status === 'complete') break; + if (job?.status === 'failed') throw new Error(job.error || 'The PDF could not be made'); + if (job?.status === 'cancelled') throw new ExportCancelled(); + if (job?.status === 'pending') { + // A Job is taken up within a moment, unless another (a video being transcoded) is in its way. + onStatus(++waited > 3 ? 'Waiting for another job to finish…' : 'Starting the PDF…'); + } else if (job) { + onStatus(`Making the PDF (${Math.round(job.progress || 0)}%)…`); + } + await pause(); + } + + // The PDF is made, and kept for an hour. A request which is lost now is asked again: not to be + // the reason all of it is done again. + onStatus('Fetching the PDF…'); + for (failures = 0; ; ) { + await stopIfCancelled(); + let response; + try { + response = await fetch(`${exports}/${exportId}/pdf`, {signal}); + } catch (e) { + response = null; + } + if (response?.ok) return await response.blob(); + // What the server refuses, it will refuse again. + if (response && response.status < 500) { + throw new Error(await getErrorMessage(response, 'Could not fetch the PDF')); + } + if (++failures >= EXPORT_POLL_FAILURES) throw new Error('Could not fetch the PDF'); + await pause(); + } + } +} + +// What the USGS calls a quadrangle: {name, state, exact}, or null where it has no name (most of the +// world), and when it can not be asked. A map is exported without its name as well as with it. +export async function getMapQuadName({west, south, east, north}) { + try { + const response = await apiGet( + `${API_URI}/map/quad?west=${west}&south=${south}&east=${east}&north=${north}`); + if (!response.ok) return null; + return (await response.json()).quad || null; + } catch (e) { + return null; + } +} + export async function searchMap(query, limit = 12, offset = 0, lat = null, lon = null) { let url = `${API_URI}/map/search?q=${encodeURIComponent(query)}&limit=${limit}&offset=${offset}`; if (lat !== null && lon !== null) { diff --git a/app/src/components/MapQuadPicker.js b/app/src/components/MapQuadPicker.js new file mode 100644 index 00000000..ac98c4b9 --- /dev/null +++ b/app/src/components/MapQuadPicker.js @@ -0,0 +1,263 @@ +import React, {useEffect, useRef, useState} from "react"; +import {Button, Checkbox, Group, Radio} from "./ui"; +import {EXPORT_DPI, EXPORT_DPIS} from "./mapExport"; +import {EXPORT_LOOKS, PRINT_LOOK} from "./mapPrintStyle"; +import { + EMPTY_FEATURES, + QUAD_MIN_ZOOM, + quadAt, + quadGridLines, + quadLabel, + quadPolygon, + quadSize, + quadTitle, +} from "./mapQuads"; + +// What the ids of the picker's layers and sources start with: they are of the app, not of the map. +export const QUAD_LAYER_PREFIX = "quad-"; +const GRID_SOURCE = "quad-grid"; +const SELECTED_SOURCE = "quad-selected"; +// The picker's own layers, in the order they are drawn (all above the map's). +const QUAD_LAYERS = [ + { + id: "quad-grid-lines", type: "line", source: GRID_SOURCE, + paint: {"line-color": "#e8590c", "line-width": 1.5, "line-opacity": 0.8}, + }, + { + id: "quad-selected-fill", type: "fill", source: SELECTED_SOURCE, + paint: {"fill-color": "#e8590c", "fill-opacity": 0.2}, + }, + { + id: "quad-selected-outline", type: "line", source: SELECTED_SOURCE, + paint: {"line-color": "#e8590c", "line-width": 3.5}, + }, +]; + +export function formatDistance(meters, scaleUnit) { + return scaleUnit === "imperial" + ? `${(meters / 1609.344).toFixed(1)} mi` + : `${(meters / 1000).toFixed(1)} km`; +} + +export function formatSheet(millimeters, scaleUnit) { + return scaleUnit === "imperial" + ? `${(millimeters / 25.4).toFixed(1)} in` + : `${(millimeters / 10).toFixed(1)} cm`; +} + +function selectedFeatures(quad) { + return quad ? {type: "FeatureCollection", features: [quadPolygon(quad)]} : EMPTY_FEATURES; +} + +// Draws the grid of 1:24,000 quadrangles over the map while the user chooses one to export. +// +// The grid and the chosen quadrangle are layers of the map, which a change of its style removes; they +// are put back whenever the style has loaded. +// +// onExport(quad, {sheet, dpi, name}): make the PDF; `sheet` is whether the map is to be on a sheet, +// with a margin, a grid and scale bars, `dpi` is how sharp it is to be, and `name` is what the USGS +// calls the quadrangle ({name, state, exact}), or null. +// +// fetchName(quad): asks for that name; it resolves to null where there is none. +// +// look, onLook(look): the look the map is exported in (see mapPrintStyle.js), and what is told when +// another is chosen. The map is shown in it, so what is seen is what is exported. +// +// While the PDF is being made `status` says how far along it is, and nothing else can be chosen; +// Cancel then stops it (onCancel()) and does not close the picker. `error` says why the last one +// could not be made. +export default function MapQuadPicker({ + map, scaleUnit, initialQuad = null, onExport, onCancel, onClose, fetchName, status = null, error = null, + look = null, onLook = null, +}) { + const busy = status !== null; + const busyRef = useRef(busy); + busyRef.current = busy; + const [selected, setSelected] = useState(initialQuad); + const selectedRef = useRef(initialQuad); + // Whether the map is zoomed in far enough for the grid to be drawn. + const [gridShown, setGridShown] = useState(true); + const [sheet, setSheet] = useState(true); + const [dpi, setDpi] = useState(EXPORT_DPI); + // What the chosen quadrangle is called: {id, name} once it is known, for the quadrangle it is of. + const [named, setNamed] = useState(null); + const name = selected && named?.id === selected.id ? named.name : null; + + useEffect(() => { + if (!selected || !fetchName) return; + let current = true; + Promise.resolve(fetchName(selected)) + .then(found => current && setNamed({id: selected.id, name: found || null})) + .catch(() => current && setNamed({id: selected.id, name: null})); + // An answer for a quadrangle which is no longer the chosen one is not used. + return () => { + current = false; + }; + }, [selected, fetchName]); + + useEffect(() => { + if (!map) return; + + const drawGrid = () => { + const source = map.getSource(GRID_SOURCE); + if (!source) return; + const bounds = map.getBounds(); + const grid = map.getZoom() >= QUAD_MIN_ZOOM + ? quadGridLines({ + west: bounds.getWest(), south: bounds.getSouth(), + east: bounds.getEast(), north: bounds.getNorth(), + }) + : null; + source.setData(grid || EMPTY_FEATURES); + setGridShown(grid !== null); + }; + + const drawSelected = () => { + const source = map.getSource(SELECTED_SOURCE); + if (source) source.setData(selectedFeatures(selectedRef.current)); + }; + + const addLayers = () => { + if (!map.getSource(GRID_SOURCE)) map.addSource(GRID_SOURCE, {type: "geojson", data: EMPTY_FEATURES}); + if (!map.getSource(SELECTED_SOURCE)) { + map.addSource(SELECTED_SOURCE, {type: "geojson", data: EMPTY_FEATURES}); + } + for (const layer of QUAD_LAYERS) { + if (!map.getLayer(layer.id)) map.addLayer(layer); + } + drawGrid(); + drawSelected(); + }; + + const choose = (e) => { + // The quadrangle being exported stays the chosen one. + if (busyRef.current) return; + const quad = quadAt(e.lngLat.lng, e.lngLat.lat); + // Choosing the chosen quadrangle again lets go of it. + const next = quad && selectedRef.current?.id === quad.id ? null : quad; + selectedRef.current = next; + setSelected(next); + drawSelected(); + }; + + addLayers(); + map.on("style.load", addLayers); + map.on("moveend", drawGrid); + map.on("click", choose); + + return () => { + map.off("style.load", addLayers); + map.off("moveend", drawGrid); + map.off("click", choose); + try { + for (const layer of [...QUAD_LAYERS].reverse()) { + if (map.getLayer(layer.id)) map.removeLayer(layer.id); + } + for (const source of [GRID_SOURCE, SELECTED_SOURCE]) { + if (map.getSource(source)) map.removeSource(source); + } + } catch (e) { + // The map itself is gone, and its layers with it. + } + }; + }, [map]); + + const size = selected ? quadSize(selected) : null; + + // Part of the app's interface over the map, like the layer control: plain, token-colored chrome. + const panelStyle = { + position: "absolute", + bottom: "2.5rem", + left: "50%", + transform: "translateX(-50%)", + zIndex: 1000, + background: "var(--panel)", + border: "1px solid var(--border)", + color: "var(--text)", + padding: "0.625rem 0.75rem", + fontSize: "0.8125rem", + width: "max-content", + maxWidth: "calc(100% - 1.25rem)", + }; + + return
+
Export a 1:24,000 map
+ {selected + ?
+ {name &&
{quadTitle(name)}
} +
{quadLabel(selected)}
+
+ {formatDistance(size.widthMeters, scaleUnit)} × {formatDistance(size.heightMeters, scaleUnit)} + {" on the ground, "} + {formatSheet(size.sheetWidthMm, scaleUnit)} × {formatSheet(size.sheetHeightMm, scaleUnit)} + {" printed"} +
+
+ :
+ {gridShown + ? "Click a quadrangle on the map to choose it." + : "Zoom in to see the quadrangles."} +
} + setSheet(e.currentTarget.checked)} + /> + setDpi(Number(value))} + > + + {EXPORT_DPIS.map(value => )} + + + {look && onLook && + + {EXPORT_LOOKS.map(({value, label}) => )} + + } + {look === PRINT_LOOK && onLook &&
+ Its colors can be changed under Layers. +
} + {status &&
{status}
} + {error && !status &&
+ {error} +
} +
+ + +
+
; +} diff --git a/app/src/components/MapQuadPicker.test.js b/app/src/components/MapQuadPicker.test.js new file mode 100644 index 00000000..1badf474 --- /dev/null +++ b/app/src/components/MapQuadPicker.test.js @@ -0,0 +1,315 @@ +import React from 'react'; +import {act, fireEvent, screen, waitFor} from '@testing-library/react'; +import {renderUI} from '../test-utils'; +import MapQuadPicker, {formatDistance, formatSheet} from './MapQuadPicker'; +import {quadAt} from './mapQuads'; + +// As much of a MapLibre map as the picker uses. +class FakeMap { + constructor({zoom = 12, bounds = {west: -105.175, south: 40.26, east: -104.925, north: 40.4}} = {}) { + this.zoom = zoom; + this.bounds = bounds; + this.sources = {}; + this.layers = []; + this.handlers = {}; + } + + on(event, handler) { + (this.handlers[event] = this.handlers[event] || []).push(handler); + } + + off(event, handler) { + this.handlers[event] = (this.handlers[event] || []).filter(i => i !== handler); + } + + fire(event, data) { + for (const handler of [...(this.handlers[event] || [])]) handler(data); + } + + addSource(id, source) { + this.sources[id] = {data: source.data, setData(data) { this.data = data; }}; + } + + getSource(id) { + return this.sources[id]; + } + + removeSource(id) { + delete this.sources[id]; + } + + addLayer(layer) { + this.layers.push(layer); + } + + getLayer(id) { + return this.layers.find(i => i.id === id); + } + + removeLayer(id) { + this.layers = this.layers.filter(i => i.id !== id); + } + + getZoom() { + return this.zoom; + } + + getBounds() { + const {west, south, east, north} = this.bounds; + return {getWest: () => west, getSouth: () => south, getEast: () => east, getNorth: () => north}; + } + + // What a style change does: every layer and source is gone, then the new style has loaded. + changeStyle() { + this.sources = {}; + this.layers = []; + this.fire('style.load'); + } +} + +const click = (map, lng, lat) => act(() => map.fire('click', {lngLat: {lng, lat}})); +const gridLines = map => map.getSource('quad-grid').data.features[0]?.geometry.coordinates || []; +const selectedIds = map => map.getSource('quad-selected').data.features.map(f => f.properties.id); +const BERTHOUD = quadAt(-105.0595, 40.31); + +function renderPicker(map, props = {}) { + const onClose = jest.fn(); + const result = renderUI(); + return {...result, onClose}; +} + +describe('choosing a quadrangle to export', () => { + test('the grid is drawn over the view, above the layers of the map', () => { + const map = new FakeMap(); + map.layers.push({id: 'roads'}); + renderPicker(map); + + expect(gridLines(map)).toHaveLength(7); + expect(map.layers.map(l => l.id)) + .toEqual(['roads', 'quad-grid-lines', 'quad-selected-fill', 'quad-selected-outline']); + expect(screen.getByText('Click a quadrangle on the map to choose it.')).toBeInTheDocument(); + expect(screen.getByRole('button', {name: 'Export PDF'})).toBeDisabled(); + }); + + test('the grid follows the map', () => { + const map = new FakeMap(); + renderPicker(map); + map.bounds = {west: -105.175, south: 40.26, east: -104.925, north: 40.6}; + act(() => map.fire('moveend')); + expect(gridLines(map)).toHaveLength(8); + }); + + test('there is no grid when zoomed out, and the user is told to zoom in', () => { + const map = new FakeMap({zoom: 5}); + renderPicker(map); + expect(gridLines(map)).toEqual([]); + expect(screen.getByText('Zoom in to see the quadrangles.')).toBeInTheDocument(); + + map.zoom = 9; + act(() => map.fire('moveend')); + expect(gridLines(map)).toHaveLength(7); + expect(screen.getByText('Click a quadrangle on the map to choose it.')).toBeInTheDocument(); + }); + + test('a click chooses the quadrangle under it, and says what it is', () => { + const map = new FakeMap(); + renderPicker(map); + click(map, -105.0595, 40.31); + + expect(selectedIds(map)).toEqual([BERTHOUD.id]); + expect(screen.getByTestId('quad-label')).toHaveTextContent('40°15′N 105°07′30″W'); + expect(screen.getByTestId('quad-size')) + .toHaveTextContent('10.6 km × 13.9 km on the ground, 44.3 cm × 57.8 cm printed'); + + // Another click chooses another; there is one at a time. + click(map, -104.925, 40.4); + expect(selectedIds(map)).toEqual([quadAt(-104.925, 40.4).id]); + expect(screen.getByTestId('quad-label')).toHaveTextContent('40°22′30″N 105°00′W'); + }); + + test('a click on the chosen quadrangle lets go of it', () => { + const map = new FakeMap(); + renderPicker(map); + click(map, -105.0595, 40.31); + click(map, -105.075, 40.3); + expect(selectedIds(map)).toEqual([]); + expect(screen.queryByTestId('quad-label')).not.toBeInTheDocument(); + }); + + test('can start with a quadrangle already chosen', () => { + const map = new FakeMap(); + renderPicker(map, {initialQuad: BERTHOUD}); + expect(selectedIds(map)).toEqual([BERTHOUD.id]); + expect(screen.getByTestId('quad-label')).toHaveTextContent('40°15′N 105°07′30″W'); + }); + + test('the size is in the units of the map', () => { + renderPicker(new FakeMap(), {initialQuad: BERTHOUD, scaleUnit: 'imperial'}); + expect(screen.getByTestId('quad-size')) + .toHaveTextContent('6.6 mi × 8.6 mi on the ground, 17.4 in × 22.8 in printed'); + expect(formatDistance(1609.344, 'imperial')).toBe('1.0 mi'); + expect(formatSheet(254, 'metric')).toBe('25.4 cm'); + }); + + test('the grid and the choice are put back when the style of the map changes', () => { + const map = new FakeMap(); + renderPicker(map); + click(map, -105.0595, 40.31); + + act(() => map.changeStyle()); + expect(map.layers.map(l => l.id)).toEqual(['quad-grid-lines', 'quad-selected-fill', 'quad-selected-outline']); + expect(gridLines(map)).toHaveLength(7); + expect(selectedIds(map)).toEqual([BERTHOUD.id]); + }); + + test('exports the chosen quadrangle', () => { + const onExport = jest.fn(); + renderPicker(new FakeMap(), {initialQuad: BERTHOUD, onExport}); + fireEvent.click(screen.getByRole('button', {name: 'Export PDF'})); + expect(onExport).toHaveBeenCalledWith(BERTHOUD, {sheet: true, dpi: 300, name: null}); + }); + + test('while the PDF is being made, Cancel stops it and the picker stays', () => { + const onCancel = jest.fn(); + const {onClose} = renderPicker(new FakeMap(), { + initialQuad: BERTHOUD, onExport: jest.fn(), onCancel, status: 'Making the PDF (40%)…', + }); + const cancel = screen.getByRole('button', {name: 'Cancel'}); + expect(cancel).toBeEnabled(); + fireEvent.click(cancel); + expect(onCancel).toHaveBeenCalledTimes(1); + expect(onClose).not.toHaveBeenCalled(); + }); + + test('when nothing is being made, Cancel closes the picker', () => { + const onCancel = jest.fn(); + const {onClose} = renderPicker(new FakeMap(), {initialQuad: BERTHOUD, onExport: jest.fn(), onCancel}); + fireEvent.click(screen.getByRole('button', {name: 'Cancel'})); + expect(onClose).toHaveBeenCalledTimes(1); + expect(onCancel).not.toHaveBeenCalled(); + }); + + test('exports the map alone when the sheet is turned off', () => { + const onExport = jest.fn(); + renderPicker(new FakeMap(), {initialQuad: BERTHOUD, onExport}); + const sheet = screen.getByRole('checkbox', {name: 'Margins, grid and scale bars'}); + expect(sheet).toBeChecked(); + fireEvent.click(sheet); + fireEvent.click(screen.getByRole('button', {name: 'Export PDF'})); + expect(onExport).toHaveBeenCalledWith(BERTHOUD, {sheet: false, dpi: 300, name: null}); + }); + + test('exports a sharper map when one is asked for', () => { + const onExport = jest.fn(); + renderPicker(new FakeMap(), {initialQuad: BERTHOUD, onExport}); + expect(screen.getByRole('radio', {name: '300 DPI'})).toBeChecked(); + fireEvent.click(screen.getByRole('radio', {name: '400 DPI'})); + fireEvent.click(screen.getByRole('button', {name: 'Export PDF'})); + expect(onExport).toHaveBeenCalledWith(BERTHOUD, {sheet: true, dpi: 400, name: null}); + }); + + test('the look the map is exported in is chosen, and not while a map is exported', () => { + const onLook = jest.fn(); + const {unmount} = renderPicker(new FakeMap(), {initialQuad: BERTHOUD, look: 'print', onLook}); + expect(screen.getByRole('radio', {name: 'Print'})).toBeChecked(); + fireEvent.click(screen.getByRole('radio', {name: 'Dark'})); + expect(onLook).toHaveBeenCalledWith('dark'); + unmount(); + + renderPicker(new FakeMap(), { + initialQuad: BERTHOUD, look: 'dark', onLook, status: 'Drawing Water (1 of 12)…', + }); + expect(screen.getByRole('radio', {name: 'Dark'})).toBeChecked(); + expect(screen.getByRole('radio', {name: 'Light'})).toBeDisabled(); + }); + + test('there is no look to choose where none is given', () => { + renderPicker(new FakeMap(), {initialQuad: BERTHOUD}); + expect(screen.queryByRole('radio', {name: 'Print'})).toBeNull(); + }); + + test('says what the USGS calls the quadrangle, and exports it by that name', async () => { + const named = {name: 'Berthoud', state: 'Colorado', exact: true}; + const fetchName = jest.fn().mockResolvedValue(named); + const onExport = jest.fn(); + renderPicker(new FakeMap(), {initialQuad: BERTHOUD, onExport, fetchName}); + expect(await screen.findByTestId('quad-name')).toHaveTextContent('Berthoud, Colorado'); + expect(fetchName).toHaveBeenCalledWith(BERTHOUD); + // Where it is, is still said. + expect(screen.getByTestId('quad-label')).toHaveTextContent('40°15′N 105°07′30″W'); + fireEvent.click(screen.getByRole('button', {name: 'Export PDF'})); + expect(onExport).toHaveBeenCalledWith(BERTHOUD, {sheet: true, dpi: 300, name: named}); + }); + + test('a quadrangle the USGS has no name for goes by where it is', async () => { + const fetchName = jest.fn().mockResolvedValue(null); + const onExport = jest.fn(); + renderPicker(new FakeMap(), {initialQuad: BERTHOUD, onExport, fetchName}); + await waitFor(() => expect(fetchName).toHaveBeenCalled()); + expect(screen.queryByTestId('quad-name')).toBeNull(); + fireEvent.click(screen.getByRole('button', {name: 'Export PDF'})); + expect(onExport).toHaveBeenCalledWith(BERTHOUD, {sheet: true, dpi: 300, name: null}); + }); + + test('a name which can not be asked for is no name', async () => { + const fetchName = jest.fn().mockRejectedValue(new Error('offline')); + renderPicker(new FakeMap(), {initialQuad: BERTHOUD, fetchName}); + await waitFor(() => expect(fetchName).toHaveBeenCalled()); + expect(screen.queryByTestId('quad-name')).toBeNull(); + expect(screen.getByTestId('quad-label')).toBeInTheDocument(); + }); + + test('the name of one quadrangle is not shown for another', async () => { + let answer; + const fetchName = jest.fn() + .mockImplementationOnce(() => new Promise(resolve => { + answer = resolve; + })) + .mockResolvedValue({name: 'Windsor', state: 'Colorado', exact: true}); + const map = new FakeMap(); + renderPicker(map, {initialQuad: BERTHOUD, fetchName}); + // Another quadrangle is chosen before the first is named. + act(() => map.fire('click', {lngLat: {lng: -104.925, lat: 40.4}})); + expect(await screen.findByTestId('quad-name')).toHaveTextContent('Windsor, Colorado'); + await act(async () => answer({name: 'Berthoud', state: 'Colorado', exact: true})); + expect(screen.getByTestId('quad-name')).toHaveTextContent('Windsor, Colorado'); + }); + + test('while the PDF is being made it says how far along it is, and the choice stays', () => { + const map = new FakeMap(); + const onExport = jest.fn(); + renderPicker(map, {initialQuad: BERTHOUD, onExport, status: 'Drawing Water (2 of 13)…'}); + + expect(screen.getByRole('status')).toHaveTextContent('Drawing Water (2 of 13)…'); + expect(screen.getByRole('button', {name: 'Export PDF'})).toBeDisabled(); + // An export which can not be stopped has no way to stop it. + expect(screen.getByRole('button', {name: 'Cancel'})).toBeDisabled(); + + // A click on the map does not choose another quadrangle. + click(map, -104.925, 40.4); + expect(selectedIds(map)).toEqual([BERTHOUD.id]); + expect(screen.getByTestId('quad-label')).toHaveTextContent('40°15′N 105°07′30″W'); + }); + + test('says why the PDF could not be made, and it can be tried again', () => { + const onExport = jest.fn(); + renderPicker(new FakeMap(), {initialQuad: BERTHOUD, onExport, error: 'Could not reach the server'}); + expect(screen.getByRole('alert')).toHaveTextContent('Could not reach the server'); + fireEvent.click(screen.getByRole('button', {name: 'Export PDF'})); + expect(onExport).toHaveBeenCalledWith(BERTHOUD, {sheet: true, dpi: 300, name: null}); + expect(screen.getByRole('button', {name: 'Close'})).toBeEnabled(); + }); + + test('leaves nothing on the map when it is closed', () => { + const map = new FakeMap(); + map.layers.push({id: 'roads'}); + const {onClose, unmount} = renderPicker(map); + fireEvent.click(screen.getByRole('button', {name: 'Cancel'})); + expect(onClose).toHaveBeenCalled(); + + unmount(); + expect(map.layers.map(l => l.id)).toEqual(['roads']); + expect(map.sources).toEqual({}); + expect(Object.values(map.handlers).flat()).toEqual([]); + }); +}); diff --git a/app/src/components/MapViewer.js b/app/src/components/MapViewer.js index e9aec996..b6de88b1 100644 --- a/app/src/components/MapViewer.js +++ b/app/src/components/MapViewer.js @@ -5,8 +5,23 @@ import "maplibre-gl/dist/maplibre-gl.css"; import {Protocol} from "pmtiles"; import layers from "protomaps-themes-base"; import mlcontour from "@acalcutt/maplibre-contour-pmtiles"; -import {addMapPin, deleteMapPin, getMapFiles, getMapPins, searchMap, setMapDefaultLocation} from "../api"; +import { + addMapPin, + deleteMapPin, + exportMapPdf, + getMapQuadName, + getMapFiles, + getMapPins, + searchMap, + setMapDefaultLocation, +} from "../api"; import {MAP_VIEWER_URI} from "./Vars"; +import {readTileBounds, readVectorTile} from "./mapTiles"; +import { + lookStyle, PRINT_LOOK, PRINT_SWATCHES, printContours, printLayers, savedExportLook, savedPrintColors, + saveExportLook, savePrintColors, +} from "./mapPrintStyle"; +import {exportLegend} from "./mapExportLegend"; import {Button, Checkbox, Header, Icon, Panel, TextInput, Toggle} from "./ui"; import {SettingsContext, ThemeContext} from "../contexts/contexts"; import {mapFlavor, mapSprite} from "../themes/names"; @@ -14,11 +29,13 @@ import {poiPopupHtml} from "./mapPoiPopup"; import {solarCalculatorPath} from "./calculators/solar"; import { addOverlaysToStyle, + labelsOverGround, buildOverlayLayers, isOverlayEnabled, isOverlayLayerEnabled, isOverlayLayerId, isStyledOverlay, + overlaySourceId, loadOverlayState, mediaUrl, overlayColor, @@ -33,6 +50,23 @@ import { setOverlayLayerEnabled, } from "./mapOverlays"; import {addMissingOverlayIcon, loadOverlayStyles, OVERLAY_ICONS_SPRITE_ID} from "./mapOverlayStyle"; +import MapQuadPicker, {QUAD_LAYER_PREFIX} from "./MapQuadPicker"; +import {contourInterval, contourThresholds, DEFAULT_TERRAIN_MAX_ZOOM, terrainMaxZoom} from "../map-shared/terrain.js"; +import {quadAt} from "./mapQuads"; +import { + EXPORT_DPI, + exportFileName, + exportFrame, + exportGroups, + exportContours, + exportSheet, + exportTitle, + maxCanvasSide, + maxExportPixels, + renderExport, + sourcesOutside, + saveBlob, +} from "./mapExport"; // Layer groups matching the standalone viewer. const LAYER_GROUPS = { @@ -68,13 +102,16 @@ const SKIP_SECONDARY = new Set(["background", "earth"]); // Set up contour DEM source (must be called once before buildStyle). let demSource = null; let terrainUrl = null; -function initContourSource(path) { - terrainUrl = mediaUrl(path); +// How deep the terrain file goes: contours are drawn from as deep as it does. +let terrainZoom = DEFAULT_TERRAIN_MAX_ZOOM; +function initContourSource(file) { + terrainUrl = mediaUrl(file.path); if (demSource) return; + terrainZoom = terrainMaxZoom(file); demSource = new mlcontour.DemSource({ url: `pmtiles://${window.location.origin}${terrainUrl}`, encoding: "terrarium", - maxzoom: 8, + maxzoom: terrainZoom, worker: true, }); demSource.setupMaplibre(maplibregl); @@ -86,16 +123,19 @@ function initContourSource(path) { // `sprite` is deliberately separate from `flavor`: we ship two sprite sets (light, dark) // and the monochrome themes draw a `black` basemap, which has no sprites of its own. // overlays: the map files which are not a basemap; overlayState: which of them (and of their -// layers) the user turned on. +// layers) the user turned on. printColors: the colors a person chose for the printed map. function buildStyle(sources, flavor = "light", hasTerrain = false, scaleUnit = "metric", - sprite = "light", overlays = [], overlayState = {}) { + sprite = "light", overlays = [], overlayState = {}, printColors = {}) { const styleSources = {}; + // The contour lines of the printed map, in the colors a person chose for it. + const contours = printContours(printColors); const allLayers = []; for (let i = 0; i < sources.length; i++) { const {name, url} = sources[i]; styleSources[name] = {type: "vector", url}; - const fileLayers = layers(name, flavor); + // The printed map is not a flavor a basemap has: it is the map's own (see mapPrintStyle.js). + const fileLayers = flavor === PRINT_LOOK ? printLayers(name, printColors) : layers(name, flavor); if (i === 0) { // Primary source: use layer IDs as-is. allLayers.push(...fileLayers); @@ -108,6 +148,9 @@ function buildStyle(sources, flavor = "light", hasTerrain = false, scaleUnit = " } } + // The labels of every basemap file are over the ground of every file. + allLayers.splice(0, allLayers.length, ...labelsOverGround(allLayers)); + // Add terrain sources and layers if available. if (hasTerrain && demSource) { // Read saved visibility to set initial layer state correctly. @@ -146,27 +189,14 @@ function buildStyle(sources, flavor = "light", hasTerrain = false, scaleUnit = " elevationKey: "ele", levelKey: "level", multiplier: isImperial ? 3.28084 : 1, // meters to feet conversion - thresholds: isImperial ? { - // [minor, major] contour intervals in feet per zoom level. - 4: [1000, 5000], - 5: [500, 2500], - 6: [200, 1000], - 7: [200, 1000], - 8: [100, 500], - } : { - // [minor, major] contour intervals in meters per zoom level. - 4: [500, 2500], - 5: [200, 1000], - 6: [100, 500], - 7: [100, 500], - 8: [50, 200], - }, + // [minor, major] contour intervals per zoom level, as fine as the terrain file can bear. + thresholds: contourThresholds(isImperial, terrainZoom), }); const elevUnit = isImperial ? "ft" : "m"; styleSources["contours"] = { type: "vector", tiles: [contourUrl], - maxzoom: 8, + maxzoom: terrainZoom, }; allLayers.push( @@ -177,7 +207,8 @@ function buildStyle(sources, flavor = "light", hasTerrain = false, scaleUnit = " "source-layer": "contours", filter: ["!=", ["get", "level"], 1], layout: {visibility: contourVis}, - paint: {"line-color": "rgba(150,100,50,0.3)", "line-width": 0.5}, + paint: flavor === PRINT_LOOK + ? contours.minor : {"line-color": "rgba(150,100,50,0.3)", "line-width": 0.5}, }, { id: "contour-lines-major", @@ -186,7 +217,8 @@ function buildStyle(sources, flavor = "light", hasTerrain = false, scaleUnit = " "source-layer": "contours", filter: ["==", ["get", "level"], 1], layout: {visibility: contourVis}, - paint: {"line-color": "rgba(150,100,50,0.5)", "line-width": 1}, + paint: flavor === PRINT_LOOK + ? contours.major : {"line-color": "rgba(150,100,50,0.5)", "line-width": 1}, }, { id: "contour-labels", @@ -206,6 +238,7 @@ function buildStyle(sources, flavor = "light", hasTerrain = false, scaleUnit = " "text-color": flavor === "light" ? "rgba(150,100,50,0.8)" : "rgba(210,180,140,0.9)", "text-halo-color": flavor === "light" ? "rgba(255,255,255,0.8)" : "rgba(0,0,0,0.8)", "text-halo-width": 1, + ...(flavor === PRINT_LOOK ? contours.label : {}), }, }, ); @@ -327,10 +360,29 @@ function OverlayControl({file, label, state, onToggleFile, onToggleLayer, onTogg ; } +// The colors of the printed map which are of a group of the layer control, each to be chosen. +// colors: what was chosen ({swatch id: "#rrggbb"}); onChange(colors): told what is chosen now. +function PrintSwatches({group, colors, onChange}) { + const swatches = PRINT_SWATCHES.filter(swatch => swatch.group === group); + if (!swatches.length) return null; + return + {swatches.map(swatch => onChange({...colors, [swatch.id]: e.target.value})} + style={{width: "1.25rem", height: "1.25rem", padding: 0, border: "1px solid var(--border)", + background: "none", cursor: "pointer"}} + />)} + ; +} + function LayerControl({ map, scaleUnit, onScaleUnitChange, visibilityRef, overlays = [], overlayState = {}, onToggleOverlay, onToggleOverlayLayer, - onToggleAllOverlayLayers, + onToggleAllOverlayLayers, printColors = null, onPrintColors = null, }) { const [visibility, setVisibility] = useState(() => { const v = getInitialVisibility(); @@ -410,14 +462,27 @@ function LayerControl({ {!collapsed &&
{Object.keys(LAYER_GROUPS).map(name => -
+
toggleGroup(name, e.currentTarget.checked)} /> + {printColors && onPrintColors && }
)} + {printColors && onPrintColors &&
+ Colors are of the printed map.{" "} + {Object.keys(printColors).length > 0 && } +
} {overlays.length > 0 &&
Overlays
@@ -659,11 +724,37 @@ export default function MapViewer() { const [addingPin, setAddingPin] = useState(null); // {lat, lon} when pin dialog is open const markersRef = useRef([]); const pinsVisibleRef = useRef(true); + // Choosing a quadrangle to export: null, or {quad} (the quadrangle to start with, if any). While + // choosing, a click on the map chooses, so the ref tells the map's own click handlers to stand by. + const [pickingQuad, setPickingQuad] = useState(null); + const pickingQuadRef = useRef(false); + // The look a map is exported in. While a quadrangle is chosen the map is shown in it: what is + // seen is what the PDF will be. + const [exportLook, setExportLook] = useState(savedExportLook); + const handleExportLook = useCallback(look => { + setExportLook(look); + saveExportLook(look); + }, []); + // The colors a person chose for the printed map: {swatch id: "#rrggbb"}. + const [printColors, setPrintColors] = useState(savedPrintColors); + const handlePrintColors = useCallback(colors => setPrintColors(savePrintColors(colors)), []); + // Exporting the chosen quadrangle: how far along it is, or why it could not be done. + const [exportStatus, setExportStatus] = useState(null); + // Whether the person exporting has asked for the export which is being made to stop. + const exportCancelledRef = useRef(false); + // Stops the request an export is in the middle of. + const exportAbortRef = useRef(null); + // Whether a map is being exported, for what is asked outside of React (the map's own buttons). + const exportingRef = useRef(false); + const [exportError, setExportError] = useState(null); const [scaleUnit, setScaleUnit] = useState(() => { try { return localStorage.getItem(STORAGE_KEY_SCALE) || "metric"; } catch (e) { return "metric"; } }); const [searchParams, setSearchParams] = useSearchParams(); const {theme} = useContext(ThemeContext); + const {flavor: lookFlavor, sprite: lookSprite} = lookStyle(pickingQuad ? exportLook : null); + // The map is shown as it is printed: its colors can be chosen. + const printing = lookFlavor === PRINT_LOOK; const {settings, fetchSettings} = useContext(SettingsContext); // Use URL params if provided, otherwise fall back to saved default location, then 0,0,z2. @@ -690,7 +781,7 @@ export default function MapViewer() { // Fetch user's PMTiles files first to determine what base layer is needed. let hasTerrain = false; - let terrainPath = null; + let terrainFile = null; let overlayFiles = []; try { const data = await getMapFiles(); @@ -700,7 +791,7 @@ export default function MapViewer() { overlayFiles = await loadOverlayStyles(foundOverlays); if (terrain) { hasTerrain = true; - terrainPath = terrain.path; + terrainFile = terrain; } if (planet) { @@ -734,7 +825,7 @@ export default function MapViewer() { // Initialize contour source if terrain data is available. if (hasTerrain) { - initContourSource(terrainPath); + initContourSource(terrainFile); } try { @@ -785,6 +876,28 @@ export default function MapViewer() { }; map.addControl(pinControl, "top-right"); + // Choose a quadrangle to export. + const exportButton = document.createElement("button"); + exportButton.type = "button"; + exportButton.title = "Export a 1:24,000 map"; + exportButton.setAttribute("aria-label", "Export a 1:24,000 map"); + exportButton.textContent = "🖨️"; + exportButton.style.cssText = pinToggle.style.cssText; + exportButton.addEventListener("click", () => { + // Not while a map is being exported: what is said of it, and its Cancel, are there. + if (destroyed || exportingRef.current) return; + setPickingQuad(picking => (picking ? null : {quad: null})); + }); + map.addControl({ + onAdd: () => { + const container = document.createElement("div"); + container.className = "maplibregl-ctrl maplibregl-ctrl-group"; + container.appendChild(exportButton); + return container; + }, + onRemove: () => {}, + }, "top-right"); + // Right-click context menu (desktop). map.on("contextmenu", (e) => { if (destroyed) return; @@ -813,7 +926,7 @@ export default function MapViewer() { const featuresAt = (point, layers) => layers.length ? map.queryRenderedFeatures(point, {layers}) : []; map.on("click", (e) => { - if (destroyed) return; + if (destroyed || pickingQuadRef.current) return; const html = overlayPopupHtml(featuresAt(e.point, overlayLayerIds())) || poiPopupHtml(featuresAt(e.point, poiLayerIds()), e.lngLat); if (!html) return; @@ -824,6 +937,10 @@ export default function MapViewer() { }); map.on("mousemove", (e) => { if (destroyed) return; + if (pickingQuadRef.current) { + map.getCanvas().style.cursor = "crosshair"; + return; + } const hit = featuresAt(e.point, [...overlayLayerIds(), ...poiLayerIds()]).length; map.getCanvas().style.cursor = hit ? "pointer" : ""; }); @@ -885,6 +1002,9 @@ export default function MapViewer() { return () => { destroyed = true; + // An export of this map stops with it: nobody is here to be given the PDF. + exportCancelledRef.current = true; + exportAbortRef.current?.abort(); if (map) { map.remove(); } @@ -903,23 +1023,22 @@ export default function MapViewer() { }; }, []); // eslint-disable-line react-hooks/exhaustive-deps - // Rebuild style when theme changes. + // Rebuild the style when the theme changes, and when the look the map is shown in does. useEffect(() => { const map = mapRef.current; if (!map || !mapReady) return; - const center = map.getCenter(); - const zoom = map.getZoom(); + // What the user turned off is off in the new style too. Listened for before the style is + // set: a style which only differs from the one the map has is in place, and has said so, + // before `setStyle` returns. The map stays where it is: a style of ours says nothing of that. + const showAsChosen = () => applyGroupVisibility(map, layerVisibilityRef.current); + map.once("style.load", showAsChosen); // The overlays are part of the style, as the user last set them. - map.setStyle(buildStyle(activeFilesRef.current, mapFlavor(theme), hasTerrainRef.current, - scaleUnit, mapSprite(theme), overlaysRef.current, overlayStateRef.current)); - map.once("style.load", () => { - map.setCenter(center); - map.setZoom(zoom); - // Re-apply layer visibility state after style rebuild. - applyGroupVisibility(map, layerVisibilityRef.current); - }); - }, [theme, mapReady, scaleUnit]); + // In the look a map is exported in while one is chosen; as the theme has it otherwise. + map.setStyle(buildStyle(activeFilesRef.current, lookFlavor || mapFlavor(theme), hasTerrainRef.current, + scaleUnit, lookSprite || mapSprite(theme), overlaysRef.current, overlayStateRef.current, printColors)); + return () => map.off("style.load", showAsChosen); + }, [theme, lookFlavor, lookSprite, mapReady, scaleUnit, printColors]); // Remember what the user chose to see of an overlay, and show or hide its layers to match. const changeOverlayState = useCallback((file, next) => { @@ -973,6 +1092,98 @@ export default function MapViewer() { setContextMenu(null); }, [contextMenu]); + useEffect(() => { + pickingQuadRef.current = pickingQuad !== null; + const map = mapRef.current; + if (map) map.getCanvas().style.cursor = pickingQuad ? "crosshair" : ""; + }, [pickingQuad]); + + const handleExportQuad = useCallback(() => { + if (!contextMenu) return; + // Start with the quadrangle which was clicked; not while another is being exported. + if (!exportingRef.current) setPickingQuad({quad: quadAt(contextMenu.lon, contextMenu.lat)}); + setContextMenu(null); + }, [contextMenu]); + + // Make a PDF of a quadrangle: the layers which are on, drawn as they are on the map. + const handleExportPdf = useCallback(async (quad, {sheet = true, dpi = EXPORT_DPI, name = null} = {}) => { + const map = mapRef.current; + if (!map) return; + exportCancelledRef.current = false; + exportingRef.current = true; + const abort = new AbortController(); + exportAbortRef.current = abort; + // The unit the map measures in is the unit its contour lines are apart in. + const imperial = scaleUnit === "imperial"; + setExportError(null); + setExportStatus("Preparing…"); + try { + const style = map.getStyle(); + const overlayLabels = Object.fromEntries(overlaysRef.current.map( + file => [overlaySourceId(file), overlayLabel(file, overlaysRef.current)])); + // A map file which is of somewhere else is not drawn. + const outside = await sourcesOutside( + style, [quad.west, quad.south, quad.east, quad.north], readTileBounds); + const groups = exportGroups( + style.layers.filter(layer => !layer.id.startsWith(QUAD_LAYER_PREFIX) && !outside.has(layer.source)), + {layerGroups: LAYER_GROUPS, overlayLabels}); + if (!groups.length) throw new Error("No layer of the map is turned on"); + // How sharp the map may be depends on how many images it is, which is not known until + // the groups have been looked at: one with nothing in it is no image. + const maxSide = maxCanvasSide(); + const frameFor = count => exportFrame(quad, {dpi, maxSide, maxPixels: maxExportPixels(count)}); + // The zoom of the map is the same however many images it is. + const frame = frameFor(groups.length); + const rendered = await renderExport({ + MapClass: maplibregl.Map, + style, + frameFor, + groups, + ignoredPrefixes: [QUAD_LAYER_PREFIX], + readTile: readVectorTile, + setup: exportMap => exportMap.on("styleimagemissing", e => addMissingOverlayIcon(exportMap, e.id)), + // Stopped between two layers, as soon as the person exporting asks. + isCancelled: () => exportCancelledRef.current, + onLooking: () => setExportStatus("Looking at the map…"), + // The map is less sharp than was asked for when this browser, or this many layers, can not be. + onProgress: (name, index, count, drawn) => setExportStatus( + `Drawing ${name} (${index + 1} of ${count})` + + `${Math.round(drawn.dpi) < dpi ? ` at ${Math.round(drawn.dpi)} DPI` : ""}…`), + }); + const pdf = await exportMapPdf({ + ...rendered, + title: exportTitle(quad, name), + // With a sheet the map has a margin, a grid and scale bars; without, it is the map alone. + sheet: sheet ? exportSheet(quad, map, groups, new Date(), name, exportContours( + groups, LAYER_GROUPS["Contours"], contourInterval(imperial, terrainZoom, frame.zoom), imperial, + ), exportLegend(style, groups, frame.zoom)) : undefined, + }, { + // Once it is being stopped, that is what is said. + onStatus: text => !exportCancelledRef.current && setExportStatus(text), + isCancelled: () => exportCancelledRef.current, + signal: abort.signal, + }); + // Stopped while the PDF was on its way: it is not wanted. + if (!exportCancelledRef.current) saveBlob(pdf, exportFileName(quad, name)); + } catch (e) { + // Stopped by the person exporting: nothing went wrong. + if (!e?.cancelled) { + console.error("Map export failed:", e); + setExportError(e?.message || "The map could not be exported"); + } + } finally { + exportingRef.current = false; + setExportStatus(null); + } + }, [scaleUnit]); + + // Stop the export which is being made. It stops between two steps, and the server stops making the PDF. + const handleCancelExport = useCallback(() => { + exportCancelledRef.current = true; + exportAbortRef.current?.abort(); + setExportStatus("Stopping…"); + }, []); + const handleExportPng = useCallback(() => { const map = mapRef.current; if (!map) return; @@ -1099,6 +1310,8 @@ export default function MapViewer() { scaleUnit={scaleUnit} onScaleUnitChange={handleScaleUnitChange} visibilityRef={layerVisibilityRef} + printColors={printing ? printColors : null} + onPrintColors={handlePrintColors} overlays={overlays} overlayState={overlayState} onToggleOverlay={handleToggleOverlay} @@ -1143,6 +1356,14 @@ export default function MapViewer() { > Export as PNG
+
e.target.style.background = "#f0f0f0"} + onMouseLeave={e => e.target.style.background = "transparent"} + onClick={handleExportQuad} + > + Export a 1:24,000 map +
e.target.style.background = "#f0f0f0"} @@ -1168,6 +1389,23 @@ export default function MapViewer() { Set as Default View
} + {mapReady && pickingQuad && { + setExportError(null); + setPickingQuad(null); + }} + />} {addingPin && { constructor(options) { this.options = options; this.style = options.style; + this.center = {lat: 0, lng: 0}; + this.moves = []; + this.listeners = []; + this.controls = []; constructed.push(this); } @@ -28,7 +32,13 @@ jest.mock('maplibre-gl', () => { return this; } - once() { + once(event, callback) { + this.listeners.push({event, callback}); + return this; + } + + off(event, callback) { + this.listeners = this.listeners.filter(i => i.event !== event || i.callback !== callback); return this; } @@ -38,6 +48,11 @@ jest.mock('maplibre-gl', () => { setStyle(style) { this.style = style; + // MapLibre puts a style which only differs from the one it has in place, and says so, + // before this returns. + const waiting = this.listeners.filter(i => i.event === 'style.load'); + this.listeners = this.listeners.filter(i => i.event !== 'style.load'); + waiting.forEach(i => i.callback()); } getLayer(id) { @@ -58,20 +73,26 @@ jest.mock('maplibre-gl', () => { } getCenter() { - return {lat: 0, lng: 0}; + return this.center; } getZoom() { return 2; } - setCenter() { + setCenter(center) { + this.moves.push(center); + this.center = center; } setZoom() { } - addControl() { + addControl(control) { + // A control of the viewer's own (not one of MapLibre's) is put on the page. + if (typeof control?.onAdd === 'function') { + this.controls.push(global.document.body.appendChild(control.onAdd(this))); + } return this; } @@ -79,6 +100,7 @@ jest.mock('maplibre-gl', () => { } remove() { + this.controls.forEach(control => control.remove()); } } @@ -108,7 +130,16 @@ jest.mock('protomaps-themes-base', () => ({ {id: 'water', type: 'fill', source}, {id: 'places_locality', type: 'symbol', source}, ], + // The printed map: the same layers, in colors of its own. + namedTheme: () => ({}), + layersWithCustomTheme: (source) => [ + {id: 'earth', type: 'fill', source, paint: {'fill-color': 'print'}}, + {id: 'water', type: 'fill', source}, + {id: 'places_locality', type: 'symbol', source}, + ], })); +// Choosing a quadrangle draws on the map, which is not what is looked at here. +jest.mock('./MapQuadPicker', () => ({onClose}) => ); // Contours are generated in the browser from the terrain file; only the URL of that source matters here. jest.mock('@acalcutt/maplibre-contour-pmtiles', () => ({ __esModule: true, @@ -407,3 +438,54 @@ describe('the text of the map', () => { } }); }); + +describe('the look the map is exported in', () => { + const earthColor = map => map.getLayer('earth').paint?.['fill-color']; + + test('is how the map is shown while a quadrangle is chosen, where it is and with what is off still off', async () => { + const map = await renderViewer([PLANET]); + await click(screen.getByLabelText('Water')); + expect(map.visibility('water')).toBe('none'); + // The map has been moved since it was made. + map.center = {lat: 40.3, lng: -105.06}; + + await click(screen.getByTitle('Export a 1:24,000 map')); + expect(earthColor(map)).toBe('print'); + expect(map.visibility('water')).toBe('none'); + // Moved again, while the quadrangle is chosen. + map.center = {lat: 61.2, lng: -149.9}; + + await click(screen.getByText('Close the picker')); + expect(earthColor(map)).toBeUndefined(); + expect(map.visibility('water')).toBe('none'); + // Changing the look never moves the map. + expect(map.moves).toEqual([]); + expect(map.center).toEqual({lat: 61.2, lng: -149.9}); + }); + + test('has colors which are chosen where its layers are, while a quadrangle is chosen', async () => { + const map = await renderViewer([PLANET]); + // The map on the screen has no colors to choose. + expect(screen.queryByLabelText('Water: color when printed')).not.toBeInTheDocument(); + + await click(screen.getByTitle('Export a 1:24,000 map')); + const water = screen.getByLabelText('Water: color when printed'); + expect(water).toHaveValue('#a9d4f2'); + expect(screen.queryByText('Reset colors')).not.toBeInTheDocument(); + await act(async () => { + fireEvent.change(water, {target: {value: '#ff00ff'}}); + }); + expect(screen.getByLabelText('Water: color when printed')).toHaveValue('#ff00ff'); + expect(JSON.parse(localStorage.getItem('wrolpi-map-print-colors'))).toEqual({water: '#ff00ff'}); + // The map was drawn again, where it was. + expect(earthColor(map)).toBe('print'); + expect(map.moves).toEqual([]); + + await click(screen.getByText('Reset colors')); + expect(screen.getByLabelText('Water: color when printed')).toHaveValue('#a9d4f2'); + expect(localStorage.getItem('wrolpi-map-print-colors')).toBeNull(); + + await click(screen.getByText('Close the picker')); + expect(screen.queryByLabelText('Water: color when printed')).not.toBeInTheDocument(); + }); +}); diff --git a/app/src/components/mapExport.js b/app/src/components/mapExport.js new file mode 100644 index 00000000..d61cd261 --- /dev/null +++ b/app/src/components/mapExport.js @@ -0,0 +1,739 @@ +// Exporting a quadrangle of the map as a PDF. +// +// The browser draws the map, because nothing else draws it as the user sees it. A second map, off +// the screen and the size of the printed sheet, is drawn once for each layer the user has turned on, +// with only that layer showing; the API puts the images in a PDF, each in a layer of its own, and +// (when it is asked to) on a sheet: with a margin, a grid, scale bars and notes around the map. + +import {QUAD_DEGREES, QUAD_SCALE, quadLabel, quadSize, quadTitle} from "./mapQuads"; +import {isOverlayLabelLayer, isOverlayLayerId} from "./mapOverlays"; + +export const EXPORT_DPI = 300; +// How sharp a map may be asked for. More is four times the work for twice the sharpness: a +// quadrangle at 600 is more than a browser will draw, or a Raspberry Pi will make a PDF of. +export const EXPORT_DPIS = [300, 400]; +// The most the API makes a PDF of: the pixels of one layer, and of all the layers of a map together +// (MAX_PIXELS and MAX_TOTAL_PIXELS in modules/map/export.py). +const MAX_LAYER_PIXELS = 64_000_000; +const MAX_TOTAL_PIXELS = 1_000_000_000; +// The map's style is made for a screen, where its sizes (of text, of lines) are in CSS pixels. This +// is how many of those are an inch of paper: fewer is larger text and less detail. At 150 a 12 pixel +// label prints at about 6 points, which is what a topographic map uses, and a quadrangle is drawn at +// about zoom 13 to 14. +export const EXPORT_CSS_DPI = 150; +// No browser makes a canvas larger than this, and few need to be asked for more. +const MAX_CANVAS_SIDE = 16384; +const FALLBACK_CANVAS_SIDE = 4096; +const MILLIMETERS_PER_INCH = 25.4; +const TILE_SIZE = 512; +const RENDER_TIMEOUT_MS = 120_000; +// How often it is asked whether the map has been too long in drawing. +const RENDER_WATCH_MS = 1000; +// How sharp the map is on which the groups are looked at, to see which have anything in them: +// half as many pixels each way as there are CSS pixels. Anything drawn is still drawn. +const LOOKING_PIXEL_RATIO = 0.5; +// How many rows of a canvas are looked at at once. +const BLANK_BAND_ROWS = 256; + +export const BACKGROUND_GROUP = "Background"; + +// The largest canvas (in pixels a side) this browser will draw a map on. +export function maxCanvasSide() { + try { + const canvas = document.createElement("canvas"); + const gl = canvas.getContext("webgl2") || canvas.getContext("webgl"); + if (!gl) return FALLBACK_CANVAS_SIDE; + const viewport = gl.getParameter(gl.MAX_VIEWPORT_DIMS) || []; + const side = Math.min(gl.getParameter(gl.MAX_TEXTURE_SIZE), viewport[0], viewport[1], MAX_CANVAS_SIDE); + gl.getExtension("WEBGL_lose_context")?.loseContext(); + return Number.isFinite(side) && side > 0 ? side : FALLBACK_CANVAS_SIDE; + } catch (e) { + return FALLBACK_CANVAS_SIDE; + } +} + +// The most pixels each layer of a map of `layerCount` layers may be. +export function maxExportPixels(layerCount) { + return Math.min(MAX_LAYER_PIXELS, Math.floor(MAX_TOTAL_PIXELS / Math.max(1, layerCount))); +} + +function mercatorY(latitude) { + return Math.log(Math.tan(Math.PI / 4 + latitude * Math.PI / 360)); +} + +function latitudeOfMercatorY(y) { + return (2 * Math.atan(Math.exp(y)) - Math.PI / 2) * 180 / Math.PI; +} + +// How to draw a quadrangle at 1:24,000: the size of the map to make (in CSS pixels), where to put it +// (center, zoom), and how many real pixels each CSS pixel is. +// +// The map is Web Mercator, in which a quadrangle is exactly a rectangle. It is as wide as the sheet +// is at the quadrangle's middle, and as tall as Mercator makes that. +// +// The map is as sharp as was asked for (`dpi`), or as sharp as it can be: no side of it longer than +// `maxSide` (the browser's largest canvas), and no more of it than `maxPixels` (what the API takes). +export function exportFrame(quad, { + dpi = EXPORT_DPI, cssDpi = EXPORT_CSS_DPI, maxSide = MAX_CANVAS_SIDE, maxPixels = Infinity, +} = {}) { + const widthInches = quadSize(quad).sheetWidthMm / MILLIMETERS_PER_INCH; + const cssWidth = Math.round(widthInches * cssDpi); + // The width of the whole world at the zoom where the quadrangle is `cssWidth` wide. + const world = cssWidth * 360 / QUAD_DEGREES; + const [south, north] = [mercatorY(quad.south), mercatorY(quad.north)]; + const cssHeight = Math.round((north - south) / (2 * Math.PI) * world); + + // A hair under what the pixels allow: each side of the canvas is rounded to a whole pixel. + const pixelRatio = Math.min( + dpi / cssDpi, + maxSide / Math.max(cssWidth, cssHeight), + Math.sqrt(maxPixels / (cssWidth * cssHeight)) * 0.999); + return { + cssWidth, + cssHeight, + pixelRatio, + dpi: pixelRatio * cssDpi, + zoom: Math.log2(world / TILE_SIZE), + bounds: [quad.west, quad.south, quad.east, quad.north], + center: [(quad.west + quad.east) / 2, latitudeOfMercatorY((south + north) / 2)], + }; +} + +// The name of a basemap layer without the source it is of ("oregon.pmtiles:water" is "water"). +function basemapLayerName(layerId) { + return layerId.includes(":") ? layerId.split(":").slice(1).join(":") : layerId; +} + +// The kinds of layer which are drawn over what is under them without hiding it: a line, a name. +const THIN_LAYER_TYPES = new Set(["line", "symbol", "circle"]); + +// The layers of the PDF: the visible layers of the map's style, gathered as the layer control +// gathers them, from the bottom up. Each is {name, ids, raster}. An overlay is one layer, or two +// when it has both ground and labels (see orderOverlayLayers). +// +// A layer of the PDF is drawn as images, and an image is in one place among the others. The layers +// of a group are not always together in the style: the parks of Land Cover are under the water and +// its piers are over it, and a second basemap file has all of its layers over the first's. So a +// group is as many images as it must be, each with the name of the group (they are one layer of the +// PDF): a part of it which fills an area stays where it is, because moved over what was above it, +// it would hide that; a part which is only lines or names is drawn with the group's next part. +// +// styleLayers: the layers of the map's style, as the map has them now. +// layerGroups: {name: [part of a layer id, ...]}, the basemap groups of the layer control. +// overlayLabels: {source id: label} of the overlay files. +export function exportGroups(styleLayers, {layerGroups = {}, overlayLabels = {}} = {}) { + const groupNames = Object.keys(layerGroups); + // What each visible layer is of: {key, name, overlay}. + const groupOf = layer => { + if (isOverlayLayerId(layer.id)) { + // An overlay is drawn in two places: its ground under the basemap's labels, and its own + // labels over them. Each is a layer of the PDF. + const part = isOverlayLabelLayer(layer) ? "labels" : "ground"; + return { + key: `overlay ${part} ${layer.source}`, name: overlayLabels[layer.source] || layer.source, + overlay: {source: layer.source, part}, + }; + } + const name = basemapLayerName(layer.id); + // A layer in more than one group (a water label) is of the last, which is the labels. + const group = [...groupNames].reverse().find(g => layerGroups[g].some(part => name.includes(part))); + // What is in no group is the ground everything else is drawn on. + return group ? {key: `group ${group}`, name: group} : {key: "background", name: BACKGROUND_GROUP}; + }; + + // The style from the bottom up, as runs of layers which are of one group and are together. + const runs = []; + for (const layer of styleLayers) { + if (layer.layout?.visibility === "none") continue; + const group = groupOf(layer); + let run = runs[runs.length - 1]; + if (run?.key !== group.key) { + run = {...group, ids: [], raster: true, thin: true}; + runs.push(run); + } + run.ids.push(layer.id); + run.raster = run.raster && layer.type === "raster"; + run.thin = run.thin && THIN_LAYER_TYPES.has(layer.type); + } + // A run of lines is drawn with the next run of its group, when there is one. + const waiting = new Map(); + const placed = []; + for (const [index, run] of runs.entries()) { + const ids = [...(waiting.get(run.key) || []), ...run.ids]; + waiting.delete(run.key); + if (run.thin && runs.slice(index + 1).some(later => later.key === run.key)) { + waiting.set(run.key, ids); + } else { + placed.push({...run, ids}); + } + } + + // The labels of an overlay are named as its labels when its ground is a layer too. + const grounds = new Set(placed.filter(g => g.overlay?.part === "ground").map(g => g.overlay.source)); + // Two groups of one name are told apart; the images of one group have one name. + const used = new Set(); + const names = new Map(); + return placed.map(({key, name, ids, raster, overlay}) => { + if (!names.has(key)) { + if (overlay?.part === "labels" && grounds.has(overlay.source)) name = `${name} (labels)`; + let unique = name; + for (let n = 2; used.has(unique); n++) unique = `${name} (${n})`; + used.add(unique); + names.set(key, unique); + } + return {name: names.get(key), ids, raster}; + }); +} + +// The sources of a style whose map file has nothing of an area: a map of another state. Their +// layers are not drawn, each of which would be an image of nothing, counted against how sharp the +// map may be. A source is only left out when its file says where it is of, and that is elsewhere. +// +// bounds: the west, south, east and north edges of the area. +// readBounds(url): the edges of the map file a source has as its `url`, or null (see mapTiles.js). +export async function sourcesOutside(style, bounds, readBounds) { + const [west, south, east, north] = bounds; + const outside = new Set(); + await Promise.all(Object.entries(style.sources || {}).map(async ([id, source]) => { + if (typeof source.url !== "string" || !source.url.startsWith("pmtiles://")) return; + try { + const edges = await readBounds(source.url); + if (!edges) return; + const [fileWest, fileSouth, fileEast, fileNorth] = edges; + if (fileEast <= west || fileWest >= east || fileNorth <= south || fileSouth >= north) outside.add(id); + } catch (e) { + // A file which can not be asked is drawn, as it was going to be. + console.warn("Could not read where a map file is of:", source.url, e); + } + })); + return outside; +} + +// A basemap's tiles name its small roads from this zoom on. A quadrangle is drawn at about zoom 13, +// from tiles in which the streets of a town are lines with no names. +export const EXPORT_DETAIL_ZOOM = 14; +// The layers of a basemap which name roads. +const ROAD_LABELS = "roads_labels"; +const ROAD_NAMES_SOURCE = "export-road-names:"; +// More room (ems) than the name of a road is long: a name is one line. +const ROAD_NAME_MAX_EMS = 1000; +// Which way the name of a road is turned (degrees, clockwise), in what is said of the road. +const NAME_ANGLE = "export:angle"; +const ROAD_TEXT_SIZE = 12; +// About how wide a letter is, in its own height. +const LETTER_WIDTH = 0.55; +// A long road is named again each time it has gone this far (CSS pixels: 2.7 inches of a sheet). +const NAME_EVERY = 400; +// Two names of one road are never nearer than this (CSS pixels). +const SAME_NAME_APART = 150; +// The most tiles names are read from. A quadrangle is 20 to 40 of them, and more only where it is a +// sliver near a pole (455 at 85 degrees); more than this is not a quadrangle. +const MAX_DETAIL_TILES = 512; + +// The layers of `style` which name roads, but not on a map drawn at `zoom`: their style keeps the +// names for a zoom at which a street is inches long on a screen. On a sheet a road is found by its +// name. +export function unnamedRoadLayers(style, zoom) { + return (style.layers || []).filter(layer => layer.type === "symbol" && layer["source-layer"] + && String(layer.id).includes(ROAD_LABELS) && layer.minzoom > zoom); +} + +// The tiles of `zoom` which have part of `bounds` (west, south, east, north) in them: [{z, x, y}]. +export function tilesOfBounds([west, south, east, north], zoom) { + const count = 2 ** zoom; + const column = longitude => (longitude + 180) / 360 * count; + const row = latitude => (1 - mercatorY(latitude) / Math.PI) / 2 * count; + const clamp = n => Math.min(count - 1, Math.max(0, n)); + // A tile whose edge is the edge of the bounds has nothing of them in it. + const [left, right] = [clamp(Math.floor(column(west))), clamp(Math.ceil(column(east)) - 1)]; + const [top, bottom] = [clamp(Math.floor(row(north))), clamp(Math.ceil(row(south)) - 1)]; + const tiles = []; + for (let x = left; x <= right; x++) { + for (let y = top; y <= bottom; y++) tiles.push({z: zoom, x, y}); + } + return tiles; +} + +// The roads of one layer of a tile which have a name, as GeoJSON features with all that the tile says +// of them: what a layer of the style draws a name from is whatever its style asks for. +// +// tile: a tile as @mapbox/vector-tile reads it. +export function namedRoads(tile, sourceLayer, {z, x, y}) { + const layer = tile?.layers?.[sourceLayer]; + const features = []; + for (let i = 0; layer && i < layer.length; i++) { + const feature = layer.feature(i); + if (!Object.keys(feature.properties).some(key => key === "name" || key.startsWith("name:"))) continue; + const {geometry, properties} = feature.toGeoJSON(x, y, z); + features.push({type: "Feature", geometry, properties}); + } + return features; +} + +// What two pieces of one road have in common: its name, and what kind of road it is. The layers +// which name roads each name some kinds of them, so a piece of another kind may not be named at all. +function roadOf(properties) { + return `${properties.kind ?? ""}\n${nameOf(properties)}`; +} + +function nameOf(properties) { + return String(properties.name ?? Object.entries(properties).find(([key]) => key.startsWith("name:"))?.[1] ?? ""); +} + +// Where a line (of points, with the length of each of its parts) is when it has gone `along`. +function pointAlong(points, lengths, along) { + let i = 0; + while (i < lengths.length - 1 && along > lengths[i]) along -= lengths[i++]; + const part = lengths[i] ? Math.min(1, Math.max(0, along / lengths[i])) : 0; + const [from, to] = [points[i], points[i + 1]]; + return [from[0] + (to[0] - from[0]) * part, from[1] + (to[1] - from[1]) * part]; +} + +// Where named roads (of namedRoads) are named on a map drawn at `zoom` with text of `textSize` CSS +// pixels: a GeoJSON FeatureCollection of points, each with all that is said of its road, and which +// way the road goes there (NAME_ANGLE). +// +// A map writes a name along a road only where the road is longer than the name and bends little, +// and at the scale of a sheet most streets of a town are shorter than their names. So the names +// are placed here, as a map maker places them: over the middle of the road, turned as the road goes +// under the name, and over its ends when it is short; again every NAME_EVERY of a long road. +// +// A road is in pieces where two tiles meet, and where what is said of it changes. The longest +// pieces are named first, and a piece is not named near where its road already is. +export function placeRoadNames(features, zoom, textSize = ROAD_TEXT_SIZE) { + const world = TILE_SIZE * 2 ** zoom; + const pixel = ([longitude, latitude]) => [ + (longitude + 180) / 360 * world, (1 - mercatorY(latitude) / Math.PI) / 2 * world]; + const pieces = []; + for (const {geometry, properties} of features) { + const parts = geometry.type === "MultiLineString" ? geometry.coordinates + : geometry.type === "LineString" ? [geometry.coordinates] : []; + for (const coordinates of parts) { + if (coordinates.length < 2) continue; + const pixels = coordinates.map(pixel); + const lengths = pixels.slice(1).map((point, i) => Math.hypot(point[0] - pixels[i][0], point[1] - pixels[i][1])); + const length = lengths.reduce((sum, n) => sum + n, 0); + if (length) pieces.push({coordinates, pixels, lengths, length, properties}); + } + } + const named = new Map(); + const points = []; + for (const {coordinates, pixels, lengths, length, properties} of pieces.sort((a, b) => b.length - a.length)) { + const road = roadOf(properties); + if (!named.has(road)) named.set(road, []); + const places = named.get(road); + const width = nameOf(properties).length * textSize * LETTER_WIDTH; + const count = Math.max(1, Math.floor(length / NAME_EVERY)); + for (let n = 0; n < count; n++) { + const along = (n + 0.5) * length / count; + const at = pointAlong(pixels, lengths, along); + if (places.some(other => Math.hypot(other[0] - at[0], other[1] - at[1]) < SAME_NAME_APART)) continue; + places.push(at); + // From where the name begins to where it ends, and never upside down. + const first = pointAlong(pixels, lengths, Math.max(0, along - width / 2)); + const last = pointAlong(pixels, lengths, Math.min(length, along + width / 2)); + let angle = Math.atan2(last[1] - first[1], last[0] - first[0]) * 180 / Math.PI; + if (angle > 90) angle -= 180; + if (angle <= -90) angle += 180; + points.push({ + type: "Feature", + geometry: {type: "Point", coordinates: pointAlong(coordinates, lengths, along)}, + properties: {...properties, [NAME_ANGLE]: Math.round(angle * 10) / 10}, + }); + } + } + return {type: "FeatureCollection", features: points}; +} + +// The names of the roads of the map which a map drawn for `frame` would not have: {source id: where +// they are named (see placeRoadNames)}, for exportStyle. They are read from tiles of EXPORT_DETAIL_ZOOM. +// +// readTile(url, {z, x, y}): resolves to a tile of the source with that URL (as @mapbox/vector-tile +// reads it), or to nothing when the source has no such tile. +// +// They are read wherever a layer would not name roads, whatever tiles the map itself is drawn from: +// nearer the equator a quadrangle is drawn at a little over zoom 14, from tiles which have the names, +// but its streets are as short there as anywhere. +// +// isCancelled(): asked before each source is read; when it is so no more is read. +// +// A source whose names can not be read is left out, and the map is exported without them. +export async function loadRoadNames(style, frame, readTile, isCancelled) { + const names = {}; + // Each source once: the layers which name its roads are of one layer of its tiles. + const unnamed = new Map(unnamedRoadLayers(style, frame.zoom).map(layer => [layer.source, layer])); + if (!readTile || !unnamed.size) return names; + const tiles = tilesOfBounds(frame.bounds, EXPORT_DETAIL_ZOOM); + if (tiles.length > MAX_DETAIL_TILES) return names; + for (const [sourceId, layer] of unnamed) { + if (isCancelled && isCancelled()) break; + const sourceLayer = layer["source-layer"]; + const textSize = Number.isFinite(layer.layout?.["text-size"]) ? layer.layout["text-size"] : ROAD_TEXT_SIZE; + const url = style.sources?.[sourceId]?.url; + if (!url) continue; + try { + const read = await Promise.all(tiles.map(async tile => namedRoads(await readTile(url, tile), sourceLayer, tile))); + const features = read.flat(); + if (features.length) names[sourceId] = placeRoadNames(features, frame.zoom, textSize); + } catch (e) { + console.warn(`The road names of ${sourceId} could not be read`, e); + } + } + return names; +} + +// A copy of the map's style in which nothing is drawn, for the map which is exported from; the +// layers are shown a group at a time. Layers which are of the app and not of the map (those whose +// id starts with one of `ignoredPrefixes`) are not in it. +// +// roadNames: what loadRoadNames gave for a map drawn at `zoom`. A layer which would not name roads +// at that zoom names those instead, in its own style, where placeRoadNames put the names. +export function exportStyle(style, ignoredPrefixes = [], {zoom = null, roadNames = {}} = {}) { + const ignored = id => ignoredPrefixes.some(prefix => String(id).startsWith(prefix)); + const sources = Object.fromEntries(Object.entries(style.sources || {}).filter(([id]) => !ignored(id))); + for (const [id, data] of Object.entries(roadNames)) { + if (sources[id]) sources[ROAD_NAMES_SOURCE + id] = {type: "geojson", data}; + } + const unnamed = new Set(zoom === null ? [] : unnamedRoadLayers(style, zoom).map(layer => layer.id)); + const layers = (style.layers || []) + .filter(layer => !ignored(layer.id)) + .map(layer => { + if (!unnamed.has(layer.id) || !sources[ROAD_NAMES_SOURCE + layer.source]) { + const hidden = {...layer, layout: {...layer.layout, visibility: "none"}}; + // What a basemap draws from a zoom a little deeper than the map is drawn at (a + // stream, a service road) is on a map of this scale, and is in the tiles it is + // drawn from: it is drawn. Not names, of which there would be too many. + if (zoom !== null && layer.type !== "symbol" && layer.minzoom > zoom + && layer.minzoom <= EXPORT_DETAIL_ZOOM) { + hidden.minzoom = Math.floor(zoom); + } + return hidden; + } + const {minzoom, "source-layer": sourceLayer, ...named} = layer; + return { + ...named, + source: ROAD_NAMES_SOURCE + layer.source, + layout: { + ...layer.layout, + "symbol-placement": "point", + "text-rotate": ["get", NAME_ANGLE], + "text-rotation-alignment": "map", + // A name along a line is one line; a name at a point is broken into several + // unless it is told it has the room. + "text-max-width": ROAD_NAME_MAX_EMS, + visibility: "none", + }, + }; + }); + return {...style, sources, layers}; +} + +// The map's arithmetic can put the edge of the world a hair past where it is (180.00000000000125 +// degrees). Such an edge is the edge of the world; one further past it is of a map which crosses the +// antimeridian, and is left as it is. +const LONGITUDE_SLIVER = 1e-8; + +function edgeLongitude(longitude) { + if (Math.abs(longitude) > 180 && Math.abs(longitude) - 180 < LONGITUDE_SLIVER) return Math.sign(longitude) * 180; + return longitude; +} + +// Only the time the page can be seen is counted: a browser does not draw a page which can not be +// seen (another tab is in front of it), and the map is not slow for that. +function once(map, event, timeoutMs = RENDER_TIMEOUT_MS) { + return new Promise((resolve, reject) => { + let seenMs = 0; + const timer = setInterval(() => { + if (typeof document !== "undefined" && document.hidden) return; + seenMs += RENDER_WATCH_MS; + if (seenMs >= timeoutMs) { + clearInterval(timer); + reject(new Error("The map took too long to draw")); + } + }, RENDER_WATCH_MS); + map.once(event, () => { + clearInterval(timer); + resolve(); + }); + }); +} + +function canvasBlob(canvas, type, quality) { + return new Promise((resolve, reject) => canvas.toBlob( + blob => (blob ? resolve(blob) : reject(new Error("The map could not be made into an image"))), + type, quality)); +} + +// Whether a canvas has no transparent part. It is reduced first: looking at every pixel of a sheet +// is slow, and a part too small to survive the reduction is too small to matter. Its four edges are +// looked at by themselves: a photograph which ends a little inside the map leaves a strip along an +// edge, which is narrow enough to be lost in the reduction and wide enough to be seen. +export function isOpaque(canvas) { + const small = document.createElement("canvas"); + small.width = 64; + small.height = Math.max(1, Math.round(64 * canvas.height / canvas.width)); + const context = small.getContext("2d"); + if (!context) return false; + const {width, height} = canvas; + const parts = [ + [0, 0, width, height], + [0, 0, width, 1], [0, height - 1, width, 1], [0, 0, 1, height], [width - 1, 0, 1, height], + ]; + for (const [x, y, w, h] of parts) { + context.clearRect(0, 0, small.width, small.height); + context.drawImage(canvas, x, y, w, h, 0, 0, small.width, small.height); + const {data} = context.getImageData(0, 0, small.width, small.height); + for (let i = 3; i < data.length; i += 4) { + if (data[i] !== 255) return false; + } + } + return true; +} + +// Whether nothing is drawn on a canvas: every pixel of it is clear. Every pixel is looked at (a +// lone well is a few of them), a band of rows at a time so that no more is in memory than a band. +export function isBlankCanvas(canvas) { + const band = document.createElement("canvas"); + band.width = canvas.width; + band.height = Math.min(BLANK_BAND_ROWS, canvas.height); + const context = band.getContext("2d", {willReadFrequently: true}); + // Not known to be blank, so it is drawn. + if (!context) return false; + for (let top = 0; top < canvas.height; top += band.height) { + const rows = Math.min(band.height, canvas.height - top); + context.clearRect(0, 0, band.width, band.height); + context.drawImage(canvas, 0, top, canvas.width, rows, 0, 0, canvas.width, rows); + // Only whether a pixel is seen at all: one which is not may still have a trace of a color. + const {data} = context.getImageData(0, 0, canvas.width, rows); + for (let i = 3; i < data.length; i += 4) { + if (data[i] !== 0) return false; + } + } + return true; +} + +// Whether the browser has stopped drawing on a map's canvas (it does when it has too many, or is +// short of memory): such a canvas reads as clear. +function contextLost(canvas) { + if (typeof canvas.getContext !== "function") return false; + const context = canvas.getContext("webgl2") || canvas.getContext("webgl"); + return Boolean(context && typeof context.isContextLost === "function" && context.isContextLost()); +} + +// Draw each group of layers of `style` on a map of its own, and return the images: +// {width, height, dpi, bounds, layers: [{name, blob}]}. `bounds` is the west, south, east and north +// edges of the images (degrees), which is what says where the PDF is on the Earth: they are read +// from the map which was drawn, so they are of the picture and not of what was asked for. +// +// MapClass: maplibregl.Map. setup(map): called with the new map before it draws anything. +// readTile: how to read a tile of a source (see loadRoadNames); without it small roads have no names. +// onProgress(name, index, count, frame): called before each group is drawn, with the frame it is +// drawn in. isCancelled(): asked before each group whether to stop; when it is so nothing more is +// drawn, and this rejects with an error whose `cancelled` is true. +// +// frame: how the map is drawn (see exportFrame). Or frameFor(count): the frame of a map of that +// many images. How sharp a map may be depends on how many images it is, and a group in which +// nothing is drawn (a basemap file with no runway in the quadrangle) is no image: so the groups are +// first looked at on a small map, onLooking() is told, and only those with something in them are +// drawn, as sharp as that many may be. isBlank(canvas): whether nothing is drawn on a canvas. +export async function renderExport({ + MapClass, style, frame, frameFor, groups, setup, onProgress, onLooking, isCancelled, readTile, + ignoredPrefixes = [], isBlank = isBlankCanvas, +}) { + const cancelled = () => Object.assign(new Error("The export was cancelled"), {cancelled: true}); + // The size, the middle and the zoom of the map are the same however many images it is. + if (frameFor) frame = frameFor(groups.length); + const roadNames = await loadRoadNames(style, frame, readTile, isCancelled); + // Reading the names is the first of the work, and may be the slowest of it. + if (isCancelled && isCancelled()) throw cancelled(); + const container = document.createElement("div"); + // Off the screen, but laid out and drawn as any element is. + container.style.cssText = `position:fixed;left:-100000px;top:0;width:${frame.cssWidth}px;` + + `height:${frame.cssHeight}px;pointer-events:none;`; + document.body.appendChild(container); + + let map; + try { + const exported = exportStyle(style, ignoredPrefixes, {zoom: frame.zoom, roadNames}); + // A map which draws as sharp as `pixelRatio` says. A map is made as sharp as it is to be: + // a browser lets a canvas be larger when it is made than it lets one be made larger later + // (some 33 million pixels, less than a quadrangle at 400 DPI). + const makeMap = async pixelRatio => { + const side = Math.ceil(Math.max(frame.cssWidth, frame.cssHeight) * pixelRatio); + map = new MapClass({ + container, + style: exported, + center: frame.center, + zoom: frame.zoom, + interactive: false, + attributionControl: false, + pixelRatio, + maxCanvasSize: [side, side], + // The canvas is read after it is drawn, so what was drawn must still be in it. + canvasContextAttributes: {preserveDrawingBuffer: true}, + // A label is all there at once: nothing is caught half faded in. + fadeDuration: 0, + }); + if (setup) setup(map); + await once(map, "load"); + return map.getCanvas(); + }; + let canvas = await makeMap(frameFor ? Math.min(LOOKING_PIXEL_RATIO, frame.pixelRatio) : frame.pixelRatio); + // Draw a group alone, have `drawn()` look at the canvas, and hide the group again. + const draw = async (group, drawn) => { + if (isCancelled && isCancelled()) { + throw cancelled(); + } + const show = visibility => { + for (const id of group.ids) { + if (map.getLayer(id)) map.setLayoutProperty(id, "visibility", visibility); + } + }; + show("visible"); + const idle = once(map, "idle"); + map.triggerRepaint(); + await idle; + const result = await drawn(); + show("none"); + return result; + }; + + if (frameFor) { + if (onLooking) onLooking(); + const seen = []; + for (const group of groups) { + const blank = await draw(group, () => isBlank(canvas)); + // A canvas the browser has stopped drawing on is clear, whatever was to be drawn: + // that is not a group with nothing in it, to be left out and not missed. + if (blank && contextLost(canvas)) throw new Error("The browser stopped drawing the map"); + if (!blank) seen.push(group); + } + if (!seen.length) throw new Error("Nothing is drawn in any layer of the map"); + // Stopped while the groups were looked at: the map to export from is not made. + if (isCancelled && isCancelled()) throw cancelled(); + groups = seen; + frame = frameFor(groups.length); + // The small map is done with; the map which is exported from is made in its place. + map.remove(); + map = null; + canvas = await makeMap(frame.pixelRatio); + } + + const layers = []; + for (const [index, group] of groups.entries()) { + // A group is not said to be drawn when it will not be. + if (isCancelled && isCancelled()) throw cancelled(); + if (onProgress) onProgress(group.name, index, groups.length, frame); + const blob = await draw(group, async () => { + // A photograph with no gaps is far smaller as a JPEG; anything else needs to be seen through. + return group.raster && isOpaque(canvas) + ? await canvasBlob(canvas, "image/jpeg", 0.9) + : await canvasBlob(canvas, "image/png"); + }); + layers.push({name: group.name, blob}); + } + const edges = map.getBounds(); + return { + width: canvas.width, + height: canvas.height, + bounds: [edgeLongitude(edges.getWest()), edges.getSouth(), edgeLongitude(edges.getEast()), edges.getNorth()], + dpi: canvas.width / frame.cssWidth * (frame.dpi / frame.pixelRatio), + layers, + }; + } finally { + if (map) map.remove(); + container.remove(); + } +} + +// Where the data of the exported layers is from: what each of their sources says of itself, once +// each, as text. +// +// map: the map on the screen, whose sources have been loaded (a source may only learn its +// attribution from its file). +export function exportCredits(map, groups) { + const style = map.getStyle(); + const exported = new Set(groups.flatMap(group => group.ids)); + const credits = []; + for (const layer of style.layers || []) { + if (!layer.source || !exported.has(layer.id)) continue; + const attribution = map.getSource(layer.source)?.attribution || style.sources?.[layer.source]?.attribution; + if (!attribution) continue; + // An attribution is HTML: links, mostly. One may name many sources, with a bar between them. + const html = new DOMParser().parseFromString(String(attribution), "text/html"); + for (const part of (html.body.textContent || "").split("|")) { + const text = part.replace(/\s+/g, " ").trim(); + if (text && !credits.includes(text)) credits.push(text); + } + } + return credits; +} + +// The day, as the person exporting the map has it: 2026-11-15. +export function exportDate(now = new Date()) { + const pad = value => String(value).padStart(2, "0"); + return `${now.getFullYear()}-${pad(now.getMonth() + 1)}-${pad(now.getDate())}`; +} + +// What is written on the sheet a quadrangle is printed on. `named` is what the USGS calls the +// quadrangle ({name, state, exact}), when it calls it anything: else it goes by where it is. +// +// contours: {interval, unit} ("feet" or "meters"): how far apart the contour lines of the exported +// map are, when it has them. +// +// legend: the lines of the map as they are drawn (of exportLegend), when it has any. +export function exportSheet(quad, map, groups, now = new Date(), named = null, contours = null, legend = null) { + return { + name: quadTitle(named) || quadLabel(quad), + credits: exportCredits(map, groups), + date: exportDate(now), + ...(contours ? {contours} : {}), + ...(legend ? {legend} : {}), + }; +} + +// How far apart the contour lines of an exported map are, for exportSheet; null when no layer of +// `contourLayers` (parts of ids, as the layer control has them) is among the `groups` which are +// exported, or no line is drawn at the zoom. +// +// interval: [minor, major] at the zoom the map is exported at (see contourInterval). +export function exportContours(groups, contourLayers, interval, imperial) { + const exported = groups.some(group => group.ids.some(id => contourLayers.some(part => id.includes(part)))); + if (!exported || !interval) return null; + return {interval: interval[0], unit: imperial ? "feet" : "meters"}; +} + +// "N40.250_W105.125": where a quadrangle's southwest corner is, in a form a file can be named. +function quadFileStem(quad) { + const part = (value, positive, negative) => `${value < 0 ? negative : positive}${Math.abs(value).toFixed(3)}`; + return `${part(quad.south, "N", "S")}_${part(quad.west, "E", "W")}`; +} + +// A name as a part of a file's: "Berthoud". +function fileNamePart(name) { + // An accent is left off its letter (Cañon is Canon), not made a gap in the name. + return String(name).normalize("NFKD").replace(/\p{M}+/gu, "").replace(/[^A-Za-z0-9]+/g, "_").replace(/^_+|_+$/g, "").slice(0, 60); +} + +export function exportFileName(quad, named = null) { + const name = named?.name ? fileNamePart(named.name) : ""; + return `wrolpi-map_${QUAD_SCALE / 1000}k_${name ? `${name}_` : ""}${quadFileStem(quad)}.pdf`; +} + +export function exportTitle(quad, named = null) { + return `1:${QUAD_SCALE.toLocaleString("en-US")} ${quadTitle(named) || quadLabel(quad)}`; +} + +// Give the user a file to keep. +export function saveBlob(blob, filename) { + const url = URL.createObjectURL(blob); + const a = document.createElement("a"); + a.href = url; + a.download = filename; + a.style.display = "none"; + document.body.appendChild(a); + a.click(); + a.remove(); + // Not at once: a large file is still being read when the click returns. + setTimeout(() => URL.revokeObjectURL(url), 60_000); +} diff --git a/app/src/components/mapExport.test.js b/app/src/components/mapExport.test.js new file mode 100644 index 00000000..12853ef4 --- /dev/null +++ b/app/src/components/mapExport.test.js @@ -0,0 +1,1123 @@ +import { + BACKGROUND_GROUP, + exportFileName, + exportCredits, + exportDate, + exportContours, + exportFrame, + exportGroups, + isBlankCanvas, + exportSheet, + exportStyle, + exportTitle, + loadRoadNames, + namedRoads, + placeRoadNames, + tilesOfBounds, + unnamedRoadLayers, + maxExportPixels, + renderExport, + sourcesOutside, +} from './mapExport'; +import {quadAt} from './mapQuads'; + +const ANCHORAGE = quadAt(-149.93, 61.19); +const BERTHOUD = quadAt(-105.0595, 40.31); +const BERTHOUD_BOUNDS = [BERTHOUD.west, BERTHOUD.south, BERTHOUD.east, BERTHOUD.north]; + +describe('how a quadrangle is drawn', () => { + test('is the size of a 1:24,000 sheet, at the sharpness asked for', () => { + const frame = exportFrame(ANCHORAGE); + // 11.0 inches wide at 150 CSS pixels an inch, and twice that many real pixels (300 DPI). + expect(frame.cssWidth).toBe(1654); + expect(frame.cssHeight).toBe(3432); + expect(frame.pixelRatio).toBe(2); + expect(frame.dpi).toBe(300); + expect(frame.zoom).toBeCloseTo(13.18, 2); + + // Wider nearer the equator, and no taller. + const south = exportFrame(BERTHOUD); + expect(south.cssWidth).toBe(2615); + expect(Math.abs(south.cssHeight - frame.cssHeight)).toBeLessThan(15); + expect(south.zoom).toBeCloseTo(13.84, 2); + }); + + test('is exactly the quadrangle: its edges are the edges of the map', () => { + const {cssWidth, cssHeight, zoom, center} = exportFrame(ANCHORAGE); + // Web Mercator, as the map draws it: pixels from the center to a point. + const world = 512 * 2 ** zoom; + const x = lng => (lng + 180) / 360 * world; + const y = lat => (1 - Math.log(Math.tan(Math.PI / 4 + lat * Math.PI / 360)) / Math.PI) / 2 * world; + expect(x(ANCHORAGE.east) - x(ANCHORAGE.west)).toBeCloseTo(cssWidth, 6); + expect(x(center[0]) - x(ANCHORAGE.west)).toBeCloseTo(cssWidth / 2, 6); + expect(y(ANCHORAGE.south) - y(center[1])).toBeCloseTo(y(center[1]) - y(ANCHORAGE.north), 6); + // The height is whole pixels, so it is within half of one of the quadrangle's. + expect(Math.abs((y(ANCHORAGE.south) - y(ANCHORAGE.north)) - cssHeight)).toBeLessThanOrEqual(0.5); + }); + + test('is sharper when that is asked for, and no larger on paper', () => { + const frame = exportFrame(ANCHORAGE, {dpi: 400}); + expect(frame.dpi).toBe(400); + expect(frame.pixelRatio).toBeCloseTo(400 / 150, 10); + // The same sheet, the same text and detail: only more pixels. + expect(frame).toMatchObject({cssWidth: 1654, cssHeight: 3432}); + expect(frame.zoom).toBe(exportFrame(ANCHORAGE).zoom); + }); + + test('is less sharp when it would be more pixels than the API makes a PDF of', () => { + // A quadrangle at the equator is square, and at 400 DPI is 83 megapixels. + const equator = quadAt(0.05, 0.05); + const asked = exportFrame(equator, {dpi: 400}); + expect(asked.cssWidth * asked.cssHeight * asked.pixelRatio ** 2).toBeGreaterThan(80e6); + + const frame = exportFrame(equator, {dpi: 400, maxPixels: maxExportPixels(1)}); + const pixels = Math.round(frame.cssWidth * frame.pixelRatio) * Math.round(frame.cssHeight * frame.pixelRatio); + expect(pixels).toBeLessThanOrEqual(64e6); + expect(pixels).toBeGreaterThan(63.5e6); + expect(frame.dpi).toBeGreaterThan(345); + expect(frame.dpi).toBeLessThan(355); + + // With many layers on, each may be less. + expect(maxExportPixels(1)).toBe(64e6); + expect(maxExportPixels(15)).toBe(64e6); + expect(maxExportPixels(25)).toBe(40e6); + const many = exportFrame(equator, {maxPixels: maxExportPixels(25)}); + expect(many.dpi).toBeLessThan(300); + expect(25 * many.cssWidth * many.cssHeight * many.pixelRatio ** 2).toBeLessThanOrEqual(1e9); + // A map which is within what the API takes is as sharp as was asked for. + expect(exportFrame(ANCHORAGE, {dpi: 400, maxPixels: maxExportPixels(13)}).dpi).toBe(400); + }); + + test('is less sharp where the browser can not make a canvas that large', () => { + const frame = exportFrame(ANCHORAGE, {maxSide: 4096}); + expect(frame.cssWidth).toBe(1654); + expect(frame.cssHeight * frame.pixelRatio).toBeCloseTo(4096, 6); + expect(frame.dpi).toBeCloseTo(179, 0); + }); +}); + +const LAYER_GROUPS = { + 'Hillshade': ['hillshade'], + 'Water': ['water'], + 'Buildings': ['buildings'], + 'Roads - Minor': ['roads_minor', 'roads_other'], + 'Labels': ['roads_labels', 'places_', 'water_label'], +}; +const hidden = {layout: {visibility: 'none'}}; +const STYLE_LAYERS = [ + {id: 'background', type: 'background'}, + {id: 'earth', type: 'fill'}, + {id: 'water', type: 'fill'}, + {id: 'hillshade', type: 'hillshade', ...hidden}, + {id: 'buildings', type: 'fill'}, + {id: 'roads_minor_casing', type: 'line'}, + {id: 'roads_minor', type: 'line'}, + // A second basemap file's layers carry its name. + {id: 'oregon.pmtiles:water', type: 'fill'}, + {id: 'oregon.pmtiles:roads_minor', type: 'line'}, + {id: 'overlay:satellite.pmtiles:raster', type: 'raster', source: 'overlay:satellite.pmtiles'}, + // The ground of an overlay is under the basemap's labels, and its own labels are over them. + {id: 'overlay:extras/features.pmtiles:water:fill', type: 'fill', source: 'overlay:extras/features.pmtiles', ...hidden}, + {id: 'overlay:extras/features.pmtiles:lines:line', type: 'line', source: 'overlay:extras/features.pmtiles'}, + {id: 'water_label_ocean', type: 'symbol'}, + {id: 'places_locality', type: 'symbol'}, + {id: 'overlay:extras/features.pmtiles:towers:circle', type: 'circle', source: 'overlay:extras/features.pmtiles'}, + {id: 'overlay:extras/features.pmtiles:towers:names', type: 'symbol', source: 'overlay:extras/features.pmtiles'}, + {id: 'overlay:off.pmtiles:raster', type: 'raster', source: 'overlay:off.pmtiles', ...hidden}, +]; +const OVERLAY_LABELS = { + 'overlay:satellite.pmtiles': 'Satellite imagery', + 'overlay:extras/features.pmtiles': 'Infrastructure', +}; + +describe('the layers of the PDF', () => { + const groups = exportGroups(STYLE_LAYERS, {layerGroups: LAYER_GROUPS, overlayLabels: OVERLAY_LABELS}); + + test('are the layers which are on, as the layer control names them, from the bottom up', () => { + // The water of a second basemap file is over the buildings of the first, as it is on the map: + // Water is two images, of one name. + expect(groups.map(g => g.name)).toEqual([ + BACKGROUND_GROUP, 'Water', 'Buildings', 'Water', 'Roads - Minor', 'Satellite imagery', 'Infrastructure', + 'Labels', 'Infrastructure (labels)', + ]); + }); + + test('a group whose layers are apart is drawn where each part which fills an area is', () => { + const layers = [ + {id: 'background', type: 'background'}, + {id: 'landuse_park', type: 'fill'}, + {id: 'roads_runway', type: 'line'}, + {id: 'water', type: 'fill'}, + {id: 'water_stream', type: 'line'}, + {id: 'landuse_pier', type: 'fill'}, + {id: 'roads_pier', type: 'line'}, + {id: 'roads_minor_casing', type: 'line'}, + {id: 'roads_highway_casing', type: 'line'}, + {id: 'roads_minor', type: 'line'}, + {id: 'roads_highway', type: 'line'}, + {id: 'roads_rail', type: 'line'}, + ]; + const drawn = exportGroups(layers, {layerGroups: { + 'Water': ['water'], 'Land Cover': ['landuse_park', 'landuse_pier'], + 'Roads - Highway': ['roads_highway'], 'Roads - Minor': ['roads_minor'], + 'Rail & Runways': ['roads_rail', 'roads_runway'], + }}).map(g => [g.name, g.ids]); + expect(drawn).toEqual([ + [BACKGROUND_GROUP, ['background']], + // A park is under the water of its lake, and a pier is over it. + ['Land Cover', ['landuse_park']], + ['Water', ['water', 'water_stream']], + ['Land Cover', ['landuse_pier']], + // What is in no group is drawn where it is, with the name of the ground. + [BACKGROUND_GROUP, ['roads_pier']], + // Lines hide nothing: those of a group are drawn together, where the last of them are. + ['Roads - Minor', ['roads_minor_casing', 'roads_minor']], + ['Roads - Highway', ['roads_highway_casing', 'roads_highway']], + ['Rail & Runways', ['roads_runway', 'roads_rail']], + ]); + }); + + test('each has the layers of the style which are of it', () => { + const ids = {}; + for (const group of groups) ids[group.name] = [...(ids[group.name] || []), ...group.ids]; + // What is in no group is the ground the rest is drawn on. + expect(ids[BACKGROUND_GROUP]).toEqual(['background', 'earth']); + // Of every basemap file. + expect(ids['Water']).toEqual(['water', 'oregon.pmtiles:water']); + expect(ids['Roads - Minor']).toEqual(['roads_minor_casing', 'roads_minor', 'oregon.pmtiles:roads_minor']); + // A water label is a label. + expect(ids['Labels']).toEqual(['water_label_ocean', 'places_locality']); + // An overlay's layers are of the overlay, whatever they are named, and only those which are on. + expect(ids['Infrastructure']).toEqual(['overlay:extras/features.pmtiles:lines:line']); + // Its labels are a layer of their own, because the basemap's labels are between the two. + expect(ids['Infrastructure (labels)']).toEqual([ + 'overlay:extras/features.pmtiles:towers:circle', 'overlay:extras/features.pmtiles:towers:names', + ]); + }); + + test('a layer which is off is not exported', () => { + expect(groups.map(g => g.name)).not.toContain('Hillshade'); + expect(groups.flatMap(g => g.ids)).not.toContain('overlay:off.pmtiles:raster'); + }); + + test('says which are photographs', () => { + expect(groups.filter(g => g.raster).map(g => g.name)).toEqual(['Satellite imagery']); + }); + + test('an overlay with no label goes by its source, and two of one name are told apart', () => { + const names = exportGroups([ + {id: 'water', type: 'fill'}, + {id: 'overlay:a.pmtiles:x:line', type: 'line', source: 'overlay:a.pmtiles'}, + {id: 'overlay:b.pmtiles:x:line', type: 'line', source: 'overlay:b.pmtiles'}, + {id: 'overlay:c.pmtiles:x:line', type: 'line', source: 'overlay:c.pmtiles'}, + ], { + layerGroups: LAYER_GROUPS, + overlayLabels: {'overlay:a.pmtiles': 'Water', 'overlay:b.pmtiles': 'Water'}, + }).map(g => g.name); + expect(names).toEqual(['Water', 'Water (2)', 'Water (3)', 'overlay:c.pmtiles']); + }); + + test('an overlay which is only ground, or only labels, is one layer by its own name', () => { + const names = layers => exportGroups(layers, { + layerGroups: LAYER_GROUPS, overlayLabels: {'overlay:a.pmtiles': 'Towers'}, + }).map(g => g.name); + expect(names([ + {id: 'places_locality', type: 'symbol'}, + {id: 'overlay:a.pmtiles:x:icons', type: 'symbol', source: 'overlay:a.pmtiles'}, + ])).toEqual(['Labels', 'Towers']); + expect(names([ + {id: 'overlay:a.pmtiles:x:line', type: 'line', source: 'overlay:a.pmtiles'}, + {id: 'places_locality', type: 'symbol'}, + // Its labels are turned off. + {id: 'overlay:a.pmtiles:x:icons', type: 'symbol', source: 'overlay:a.pmtiles', ...hidden}, + ])).toEqual(['Towers', 'Labels']); + }); + + test('there are none when nothing is on', () => { + expect(exportGroups([{id: 'water', type: 'fill', ...hidden}], {layerGroups: LAYER_GROUPS})).toEqual([]); + }); +}); + +describe('the style which is exported from', () => { + test('draws nothing to begin with, and has nothing of the app in it', () => { + const style = { + version: 8, + glyphs: '/fonts', + sources: {basemap: {type: 'vector'}, 'quad-grid': {type: 'geojson'}}, + layers: [ + {id: 'water', type: 'fill', source: 'basemap'}, + {id: 'places', type: 'symbol', source: 'basemap', layout: {'text-size': 12}}, + {id: 'quad-grid-lines', type: 'line', source: 'quad-grid'}, + ], + }; + const exported = exportStyle(style, ['quad-']); + expect(exported.glyphs).toBe('/fonts'); + expect(Object.keys(exported.sources)).toEqual(['basemap']); + expect(exported.layers).toEqual([ + {id: 'water', type: 'fill', source: 'basemap', layout: {visibility: 'none'}}, + {id: 'places', type: 'symbol', source: 'basemap', layout: {'text-size': 12, visibility: 'none'}}, + ]); + // The map's own style is as it was. + expect(style.layers[0].layout).toBeUndefined(); + }); + + test('a layer which would not name roads names the roads which were read for it', () => { + const roadNames = {'a.pmtiles': POINTS}; + const exported = exportStyle(TOWN, [], {zoom: 13.2, roadNames}); + expect(exported.sources['export-road-names:a.pmtiles']).toEqual({type: 'geojson', data: POINTS}); + expect(exported.sources['a.pmtiles']).toBe(TOWN.sources['a.pmtiles']); + + expect(exported.layers.map(l => l.id)).toEqual(TOWN.layers.map(l => l.id)); + const [, minor, major, address] = exported.layers; + // In its own style, at whatever zoom: each name where it was put, turned as its road is. + expect(minor).toEqual({ + id: 'roads_labels_minor', type: 'symbol', source: 'export-road-names:a.pmtiles', + filter: ['in', 'kind', 'minor_road'], + layout: { + 'symbol-placement': 'point', 'text-rotate': ['get', 'export:angle'], 'text-max-width': 1000, + 'text-rotation-alignment': 'map', 'text-size': 12, visibility: 'none', + }, + }); + // A layer which names roads at this zoom, and one which is not of roads, are as they were. + expect(major).toMatchObject({source: 'a.pmtiles', 'source-layer': 'roads', minzoom: 11}); + expect(address).toMatchObject({source: 'a.pmtiles', minzoom: 18}); + // The map's own style is as it was. + expect(TOWN.layers[1]).toMatchObject({source: 'a.pmtiles', minzoom: 15}); + expect(TOWN.layers[1].layout['symbol-placement']).toBe('line'); + }); + + test('a layer whose names could not be read is drawn as the map draws it', () => { + const exported = exportStyle(TOWN, [], {zoom: 13.2, roadNames: {}}); + expect(exported.layers.map(l => l.id)).toEqual(TOWN.layers.map(l => l.id)); + expect(exported.layers[1]).toMatchObject({source: 'a.pmtiles', minzoom: 15}); + }); +}); + +// A town: its small roads are named from zoom 15, its large ones from 11. +const TOWN = { + version: 8, + sources: {'a.pmtiles': {type: 'vector', url: 'pmtiles://a'}}, + layers: [ + {id: 'roads_minor', type: 'line', source: 'a.pmtiles', 'source-layer': 'roads'}, + { + id: 'roads_labels_minor', type: 'symbol', source: 'a.pmtiles', 'source-layer': 'roads', minzoom: 15, + filter: ['in', 'kind', 'minor_road'], layout: {'symbol-placement': 'line', 'text-size': 12}, + }, + {id: 'roads_labels_major', type: 'symbol', source: 'a.pmtiles', 'source-layer': 'roads', minzoom: 11}, + {id: 'address_label', type: 'symbol', source: 'a.pmtiles', 'source-layer': 'pois', minzoom: 18}, + ], +}; +const POINTS = {type: 'FeatureCollection', features: []}; + +// A tile as @mapbox/vector-tile reads it, of roads which go east from the given longitude. +function fakeTile(roads) { + return { + layers: { + roads: { + length: roads.length, + feature: i => ({ + properties: roads[i].properties, + toGeoJSON: (x, y, z) => ({ + type: 'Feature', id: 7, properties: roads[i].properties, + geometry: {type: 'LineString', coordinates: roads[i].coordinates, tile: [z, x, y]}, + }), + }), + }, + }, + }; +} + +describe('the names of small roads', () => { + test('are of the layers which name roads, but not at the zoom of the sheet', () => { + expect(unnamedRoadLayers(TOWN, 13.2).map(l => l.id)).toEqual(['roads_labels_minor']); + expect(unnamedRoadLayers(TOWN, 10).map(l => l.id)).toEqual(['roads_labels_minor', 'roads_labels_major']); + expect(unnamedRoadLayers(TOWN, 15)).toEqual([]); + expect(unnamedRoadLayers({}, 13)).toEqual([]); + }); + + test('are read from the tiles which the quadrangle is in', () => { + // One tile of zoom 1 is a quarter of the world. + expect(tilesOfBounds([-90, 10, -80, 20], 1)).toEqual([{z: 1, x: 0, y: 0}]); + expect(tilesOfBounds([-10, -10, 10, 10], 1)).toEqual([ + {z: 1, x: 0, y: 0}, {z: 1, x: 0, y: 1}, {z: 1, x: 1, y: 0}, {z: 1, x: 1, y: 1}]); + // A tile which only touches the edge has nothing of the quadrangle in it. + expect(tilesOfBounds([-180, 0, 0, 85.0511287798], 1)).toEqual([{z: 1, x: 0, y: 0}]); + // A quadrangle is a few tiles of zoom 14 wide, each of them once. + const tiles = tilesOfBounds([ANCHORAGE.west, ANCHORAGE.south, ANCHORAGE.east, ANCHORAGE.north], 14); + expect(new Set(tiles.map(t => t.x)).size).toBeLessThanOrEqual(7); + expect(tiles.every(t => t.z === 14)).toBe(true); + expect(tiles.length).toBe(new Set(tiles.map(t => `${t.x}/${t.y}`)).size); + }); + + test('are the roads of a tile which have a name, with all that is said of them', () => { + const tile = fakeTile([ + {properties: {kind: 'minor_road', name: 'Elm Street', ref: '7'}, coordinates: [[0, 0], [1, 0]]}, + {properties: {kind: 'minor_road'}, coordinates: [[0, 1], [1, 1]]}, + {properties: {kind: 'path', 'name:en': 'Ridge Trail'}, coordinates: [[0, 2], [1, 2]]}, + ]); + const roads = namedRoads(tile, 'roads', {z: 14, x: 3, y: 5}); + expect(roads.map(r => r.properties)).toEqual([ + {kind: 'minor_road', name: 'Elm Street', ref: '7'}, {kind: 'path', 'name:en': 'Ridge Trail'}]); + // Where the tile says they are, as the tile reader makes that of the tile's place. + expect(roads[0].geometry).toMatchObject({type: 'LineString', coordinates: [[0, 0], [1, 0]], tile: [14, 3, 5]}); + expect(roads[0]).not.toHaveProperty('id'); + // No such tile, or no such layer in it. + expect(namedRoads(null, 'roads', {z: 14, x: 3, y: 5})).toEqual([]); + expect(namedRoads(tile, 'streets', {z: 14, x: 3, y: 5})).toEqual([]); + }); + + // At zoom 13 the world is 4,194,304 pixels around: a degree of longitude is 11,651 of them. + const piece = (name, from, to, kind = 'minor_road') => ({ + type: 'Feature', properties: {name, kind}, + geometry: {type: 'LineString', coordinates: [[from, 0], [to, 0]]}, + }); + const places = (roads, zoom = 13) => placeRoadNames(roads, zoom).features + .map(f => [f.properties.name, Math.round(f.geometry.coordinates[0] * 1e6) / 1e6]); + + test('a road is named over its middle, however short it is', () => { + const {type, features} = placeRoadNames([piece('Elm Street', 0, 0.01), piece('Oak Street', 1, 1.0004)], 13); + expect(type).toBe('FeatureCollection'); + expect(features).toEqual([{ + type: 'Feature', geometry: {type: 'Point', coordinates: [expect.closeTo(0.005, 9), 0]}, + properties: {kind: 'minor_road', name: 'Elm Street', 'export:angle': 0}, + }, { + // 5 pixels of road under 66 pixels of name. + type: 'Feature', geometry: {type: 'Point', coordinates: [expect.closeTo(1.0002, 9), 0]}, + properties: {kind: 'minor_road', name: 'Oak Street', 'export:angle': 0}, + }]); + }); + + test('a long road is named again each time it has gone far enough', () => { + // 0.1 degrees is 1,165 pixels: two names, each in the middle of half of it. + expect(places([piece('Elm Street', 0, 0.1)])).toEqual([['Elm Street', 0.025], ['Elm Street', 0.075]]); + // 699 pixels is not twice as far. + expect(places([piece('Elm Street', 0, 0.06)])).toEqual([['Elm Street', 0.03]]); + }); + + test('a name is turned as the road goes under it, and never upside down', () => { + const going = (to, from = [0, 0]) => ({ + type: 'Feature', properties: {name: `${from} to ${to}`}, + geometry: {type: 'LineString', coordinates: [from, to]}, + }); + const angles = roads => placeRoadNames(roads, 13).features.map(f => f.properties['export:angle']); + // East and west are level; north and south are on their side; a map's y is down. + expect(angles([going([0.003, 0])])).toEqual([0]); + expect(angles([going([0, 0], [0.003, 0])])).toEqual([0]); + expect(angles([going([0, 0.003])])).toEqual([90]); + expect(angles([going([0, -0.003])])).toEqual([90]); + expect(angles([going([0.002, 0.002])])).toEqual([-45]); + expect(angles([going([-0.002, -0.002])])).toEqual([-45]); + expect(angles([going([0.002, -0.002])])).toEqual([45]); + // A road which turns a corner far from its middle is named as it goes at its middle. + const corner = { + type: 'Feature', properties: {name: 'Elm'}, + geometry: {type: 'LineString', coordinates: [[0, 0], [0.05, 0], [0.05, 0.002]]}, + }; + expect(angles([corner])).toEqual([0]); + }); + + test('a road in pieces is not named twice in one place', () => { + // A street cut by the edge of a tile: most of it, and a stub at its far end. + expect(places([piece('Elm Street', 0.02, 0.022), piece('Elm Street', 0, 0.02)], 13.2)) + .toEqual([['Elm Street', 0.01]]); + // Short pieces end to end: the longest is the one which is named. + expect(places([piece('Oak Street', 0, 0.002), piece('Oak Street', 0.002, 0.005)])) + .toEqual([['Oak Street', 0.0035]]); + // Another road beside it has its own name, and the same name a long way off is another road. + expect(places([piece('Oak Street', 0, 0.005), piece('Ash Street', 0.002, 0.0045), piece('Oak Street', 0.1, 0.102)])) + .toEqual([['Oak Street', 0.0025], ['Ash Street', 0.00325], ['Oak Street', 0.101]]); + }); + + test('a piece of another kind of road does not take the name', () => { + // The layer which names small roads does not draw the large one, however long its piece is. + const {features} = placeRoadNames( + [piece('Main Street', 0, 0.004, 'major_road'), piece('Main Street', 0.004, 0.0069, 'minor_road')], 13); + expect(features.map(f => f.properties.kind)).toEqual(['major_road', 'minor_road']); + }); + + test('the lines of a road of many lines are each a piece of it; what is not a line is not one', () => { + const {features} = placeRoadNames([ + { + type: 'Feature', properties: {name: 'Elm Street'}, + geometry: {type: 'MultiLineString', coordinates: [[[0, 0], [0.01, 0]], [[0, 1], [0.003, 1]], [[5, 5]]]}, + }, + {type: 'Feature', properties: {name: 'Elm Square'}, geometry: {type: 'Point', coordinates: [0, 0]}}, + ], 13); + expect(features.map(f => f.geometry.coordinates)).toEqual([ + [expect.closeTo(0.005, 9), 0], [expect.closeTo(0.0015, 9), 1]]); + }); + + const FRAME = {zoom: 13.2, bounds: [-10, -10, 10, 10]}; + + test('are read from each source whose roads would have no names, a tile at a time', async () => { + const readTile = jest.fn(async (url, {x, y}) => (x === 8191 && y === 8191 + ? fakeTile([{properties: {kind: 'minor_road', name: 'Elm Street'}, coordinates: [[0, 0], [0.01, 0]]}]) + : null)); + const frame = {zoom: 13.2, bounds: [-0.01, 0.001, -0.001, 0.01]}; + const names = await loadRoadNames(TOWN, frame, readTile); + expect(readTile).toHaveBeenCalledTimes(1); + expect(readTile).toHaveBeenCalledWith('pmtiles://a', {z: 14, x: 8191, y: 8191}); + expect(Object.keys(names)).toEqual(['a.pmtiles']); + expect(names['a.pmtiles'].features.map(f => f.properties.name)).toEqual(['Elm Street']); + }); + + test('are not read when there is no need, or no way', async () => { + const readTile = jest.fn(async () => null); + // Nothing reads tiles. + expect(await loadRoadNames(TOWN, FRAME, undefined)).toEqual({}); + // The map is drawn at a zoom at which its style names every road. + expect(await loadRoadNames(TOWN, {...FRAME, zoom: 15.1}, readTile)).toEqual({}); + // No layer of the map names roads. + expect(await loadRoadNames({...TOWN, layers: [TOWN.layers[0]]}, FRAME, readTile)).toEqual({}); + // More tiles than a quadrangle is. + expect(await loadRoadNames(TOWN, {zoom: 13.2, bounds: [-10, -10, 10, 10]}, readTile)).toEqual({}); + expect(readTile).not.toHaveBeenCalled(); + // No tile of the place has a named road. + expect(await loadRoadNames(TOWN, {zoom: 13.2, bounds: [-0.01, 0.001, -0.001, 0.01]}, readTile)).toEqual({}); + }); + + test('are read nearer the equator too, where a quadrangle is drawn at a little over zoom 14', async () => { + // The style still keeps the names of small roads for zoom 15 there. + const readTile = jest.fn(async () => fakeTile([ + {properties: {kind: 'minor_road', name: 'Elm Street'}, coordinates: [[-80.95, 25.05], [-80.9499, 25.05]]}, + ])); + const frame = {zoom: 14.09, bounds: [-80.9501, 25.0499, -80.9499, 25.0501]}; + const names = await loadRoadNames(TOWN, frame, readTile); + expect(readTile).toHaveBeenCalledWith('pmtiles://a', expect.objectContaining({z: 14})); + expect(names['a.pmtiles'].features.map(f => f.properties.name)).toEqual(['Elm Street']); + // And the layer draws them. + const exported = exportStyle(TOWN, [], {zoom: frame.zoom, roadNames: names}); + expect(exported.layers[1]).not.toHaveProperty('minzoom'); + expect(exported.layers[1].source).toBe('export-road-names:a.pmtiles'); + }); + + test('no more is read once the export is cancelled', async () => { + const two = { + ...TOWN, + sources: {...TOWN.sources, 'b.pmtiles': {type: 'vector', url: 'pmtiles://b'}}, + layers: [...TOWN.layers, {...TOWN.layers[1], id: 'b.pmtiles:roads_labels_minor', source: 'b.pmtiles'}], + }; + let cancelled = false; + const readTile = jest.fn(async () => { + cancelled = true; + return null; + }); + await loadRoadNames(two, {zoom: 13.2, bounds: [-0.01, 0.001, -0.001, 0.01]}, readTile, () => cancelled); + expect(readTile).toHaveBeenCalledTimes(1); + expect(readTile).toHaveBeenCalledWith('pmtiles://a', expect.anything()); + }); + + test('a source which can not be read is exported without them', async () => { + const warn = jest.spyOn(console, 'warn').mockImplementation(() => {}); + const readTile = jest.fn(async () => { + throw new Error('no such file'); + }); + expect(await loadRoadNames(TOWN, {zoom: 13.2, bounds: [-0.01, 0.001, -0.001, 0.01]}, readTile)).toEqual({}); + expect(warn).toHaveBeenCalledTimes(1); + warn.mockRestore(); + }); +}); + +// As much of a MapLibre map as an export uses. It records which layers were visible each time +// its canvas was read. +function fakeMapClass(record, {transparent = true, canvas = () => ({})} = {}) { + return class FakeMap { + constructor(options) { + record.options = options; + record.maps = (record.maps || 0) + 1; + record.pixelRatios = [...(record.pixelRatios || []), options.pixelRatio]; + record.sides = [...(record.sides || []), options.maxCanvasSize?.[0]]; + this.visible = new Set(options.style.layers + .filter(l => l.layout.visibility !== 'none').map(l => l.id)); + this.layerIds = new Set(options.style.layers.map(l => l.id)); + this.canvas = { + ...canvas(this), + width: Math.floor(parseInt(options.container.style.width, 10) * options.pixelRatio), + height: Math.floor(parseInt(options.container.style.height, 10) * options.pixelRatio), + toBlob: (callback, type) => { + record.captures.push({type, visible: [...this.visible]}); + callback(record.failBlob ? null : {type, layers: [...this.visible]}); + }, + }; + } + + on(event, handler) { + record.listeners = [...(record.listeners || []), event]; + } + + once(event, handler) { + if (event === 'idle' && record.neverIdle) return; + Promise.resolve().then(handler); + } + + getCanvas() { + return this.canvas; + } + + // The edges of what this map draws (not quite those of the quadrangle it was asked for). + getBounds() { + const [west, south, east, north] = record.bounds || [-150, 61.12499878, -149.875, 61.25000121]; + return {getWest: () => west, getSouth: () => south, getEast: () => east, getNorth: () => north}; + } + + getLayer(id) { + return this.layerIds.has(id) ? {id} : undefined; + } + + setLayoutProperty(id, name, value) { + if (value === 'visible') this.visible.add(id); else this.visible.delete(id); + } + + triggerRepaint() { + } + + remove() { + record.removed = true; + record.removals = (record.removals || 0) + 1; + } + }; +} + +describe('drawing the layers', () => { + const style = { + version: 8, + sources: {basemap: {type: 'vector'}}, + layers: [ + {id: 'water', type: 'fill', source: 'basemap'}, + {id: 'roads_minor', type: 'line', source: 'basemap'}, + {id: 'places', type: 'symbol', source: 'basemap'}, + ], + }; + const groups = [ + {name: 'Water', ids: ['water'], raster: false}, + {name: 'Roads - Minor', ids: ['roads_minor', 'gone'], raster: false}, + {name: 'Labels', ids: ['places'], raster: false}, + ]; + const frame = exportFrame(ANCHORAGE); + let getContext; + + beforeEach(() => { + // The reduced copy which says whether an image has gaps: here, all of it is gaps. + getContext = jest.spyOn(HTMLCanvasElement.prototype, 'getContext').mockImplementation(() => ({ + clearRect: jest.fn(), + drawImage: jest.fn(), + getImageData: () => ({data: new Uint8ClampedArray([0, 0, 0, 0])}), + })); + }); + afterEach(() => getContext.mockRestore()); + + test('each group is drawn alone, on a map the size of the sheet', async () => { + const record = {captures: []}; + const progress = []; + const setup = jest.fn(); + const result = await renderExport({ + MapClass: fakeMapClass(record), style, frame, groups, setup, + onProgress: (name, index, count) => progress.push(`${name} ${index + 1}/${count}`), + }); + + expect(record.captures).toEqual([ + {type: 'image/png', visible: ['water']}, + {type: 'image/png', visible: ['roads_minor']}, + {type: 'image/png', visible: ['places']}, + ]); + expect(result.layers.map(l => l.name)).toEqual(['Water', 'Roads - Minor', 'Labels']); + expect(result.layers[1].blob.layers).toEqual(['roads_minor']); + expect(result).toMatchObject({width: 3308, height: 6864, dpi: 300}); + // Where the picture is, as the map which drew it has it. + expect(result.bounds).toEqual([-150, 61.12499878, -149.875, 61.25000121]); + expect(progress).toEqual(['Water 1/3', 'Roads - Minor 2/3', 'Labels 3/3']); + + expect(record.options).toMatchObject({ + center: frame.center, zoom: frame.zoom, pixelRatio: 2, interactive: false, + fadeDuration: 0, maxCanvasSize: [6864, 6864], + // Where this MapLibre reads it from; as an option of the map itself it is ignored. + canvasContextAttributes: {preserveDrawingBuffer: true}, + }); + expect(record.options).not.toHaveProperty('preserveDrawingBuffer'); + expect(record.options.container.style.width).toBe('1654px'); + expect(record.options.container.style.height).toBe('3432px'); + expect(setup).toHaveBeenCalledTimes(1); + }); + + test('the names of small roads are read, and drawn with the layer they are of', async () => { + const record = {captures: []}; + const readTile = jest.fn(async () => fakeTile([ + {properties: {kind: 'minor_road', name: 'Elm Street'}, coordinates: [[-149.9, 61.2], [-149.9001, 61.2]]}, + ])); + const town = {...TOWN, layers: TOWN.layers.map(l => ({...l, layout: {...l.layout, visibility: 'visible'}}))}; + await renderExport({ + MapClass: fakeMapClass(record), style: town, frame, readTile, + groups: [{name: 'Labels', ids: ['roads_labels_minor', 'roads_labels_major']}], + }); + expect(readTile).toHaveBeenCalledWith('pmtiles://a', expect.objectContaining({z: 14})); + expect(record.options.style.sources['export-road-names:a.pmtiles'].data.features).toHaveLength(1); + expect(record.options.style.layers[1].source).toBe('export-road-names:a.pmtiles'); + expect(record.captures).toEqual([{type: 'image/png', visible: ['roads_labels_minor', 'roads_labels_major']}]); + }); + + test('an edge a hair past the edge of the world is the edge of the world', async () => { + // What the map's arithmetic makes of the last quadrangle before the antimeridian. + const east = await renderExport({ + MapClass: fakeMapClass({captures: [], bounds: [179.875, 0, 180.00000000000125, 0.125]}), + style, frame, groups, + }); + expect(east.bounds).toEqual([179.875, 0, 180, 0.125]); + + const west = await renderExport({ + MapClass: fakeMapClass({captures: [], bounds: [-180.00000000000125, 0, -179.875, 0.125]}), + style, frame, groups, + }); + expect(west.bounds).toEqual([-180, 0, -179.875, 0.125]); + + // A map which is really across the antimeridian is left as it is, for the API to refuse. + const across = await renderExport({ + MapClass: fakeMapClass({captures: [], bounds: [179.9, 0, 180.1, 0.125]}), style, frame, groups, + }); + expect(across.bounds).toEqual([179.9, 0, 180.1, 0.125]); + }); + + test('nothing is left behind, whether it works or not', async () => { + const record = {captures: []}; + await renderExport({MapClass: fakeMapClass(record), style, frame, groups}); + expect(record.removed).toBe(true); + expect(record.options.container.isConnected).toBe(false); + + const failed = {captures: [], failBlob: true}; + await expect(renderExport({MapClass: fakeMapClass(failed), style, frame, groups})) + .rejects.toThrow('could not be made into an image'); + expect(failed.removed).toBe(true); + expect(failed.options.container.isConnected).toBe(false); + }); + + test('a photograph with no gaps is a JPEG, and one with gaps is not', async () => { + const photo = [{name: 'Satellite', ids: ['water'], raster: true}]; + const gaps = {captures: []}; + await renderExport({MapClass: fakeMapClass(gaps), style, frame, groups: photo}); + expect(gaps.captures[0].type).toBe('image/png'); + + const opaque = new Uint8ClampedArray([9, 9, 9, 255, 9, 9, 9, 255]); + getContext.mockImplementation(() => ({ + clearRect: jest.fn(), drawImage: jest.fn(), getImageData: () => ({data: opaque}), + })); + const whole = {captures: []}; + await renderExport({MapClass: fakeMapClass(whole), style, frame, groups: photo}); + expect(whole.captures[0].type).toBe('image/jpeg'); + + // A photograph which ends a little inside the map: all of it reduced has no gap to see, and + // one of its edges, looked at by itself, is all gap. + const looks = []; + getContext.mockImplementation(() => ({ + clearRect: jest.fn(), + drawImage: (canvas, x, y, width, height) => looks.push([x, y, width, height]), + getImageData: () => ({data: looks.length === 5 ? new Uint8ClampedArray([0, 0, 0, 0]) : opaque}), + })); + const strip = {captures: []}; + await renderExport({MapClass: fakeMapClass(strip), style, frame, groups: photo}); + expect(strip.captures[0].type).toBe('image/png'); + // All of it, then its top, bottom, left and right edges. + const [[, , width, height]] = looks; + expect(looks).toEqual([ + [0, 0, width, height], + [0, 0, width, 1], [0, height - 1, width, 1], [0, 0, 1, height], [width - 1, 0, 1, height], + ]); + // What is not a photograph is never a JPEG, gaps or none. + const drawn = {captures: []}; + await renderExport({MapClass: fakeMapClass(drawn), style, frame, groups: groups.slice(0, 1)}); + expect(drawn.captures[0].type).toBe('image/png'); + }); + + describe('when how sharp the map may be depends on how many images it is', () => { + // A map of fewer images may be sharper. + const frameFor = count => ({...frame, pixelRatio: count <= 2 ? 2 : 1, dpi: count <= 2 ? 300 : 150}); + // Nothing is drawn in the roads of this quadrangle. + const blankRoads = canvas => canvas.visible().join() === 'roads_minor'; + const looking = record => fakeMapClass(record, { + canvas: map => ({visible: () => [...map.visible]}), + }); + + test('a group with nothing in it is not drawn, sent or counted', async () => { + const record = {captures: []}; + const progress = []; + const lookings = []; + const rendered = await renderExport({ + MapClass: looking(record), style, frameFor, groups, isBlank: blankRoads, + onLooking: () => lookings.push(record.captures.length), + onProgress: (name, index, count, drawn) => progress.push([name, index, count, drawn.dpi]), + }); + // Looked at first, on a small map; told once, before anything is drawn to keep. + expect(lookings).toEqual([0]); + // Two of the three groups have something in them, so the map is as sharp as two may be. + // It is a map of its own, made that sharp: a canvas is not made larger once it is made. + expect(record.pixelRatios).toEqual([0.5, 2]); + expect(record.maps).toBe(2); + expect(record.removals).toBe(2); + expect(rendered.layers.map(layer => layer.name)).toEqual(['Water', 'Labels']); + expect(progress).toEqual([['Water', 0, 2, 300], ['Labels', 1, 2, 300]]); + expect(rendered.dpi).toBe(300); + expect(rendered.width).toBe(frame.cssWidth * 2); + // Each canvas is allowed to be as large as its map is. + const side = Math.max(frame.cssWidth, frame.cssHeight); + expect(record.sides).toEqual([Math.ceil(side * 0.5), Math.ceil(side * 2)]); + }); + + test('every group is drawn when all have something in them', async () => { + const record = {captures: []}; + const rendered = await renderExport({ + MapClass: looking(record), style, frameFor, groups, isBlank: () => false, + }); + expect(rendered.layers.map(layer => layer.name)).toEqual(groups.map(group => group.name)); + expect(record.pixelRatios).toEqual([0.5, 1]); + expect(rendered.dpi).toBe(150); + }); + + test('a map with nothing in any group is not exported', async () => { + const record = {captures: []}; + await expect(renderExport({ + MapClass: looking(record), style, frameFor, groups, isBlank: () => true, + })).rejects.toThrow('Nothing is drawn in any layer of the map'); + expect(record.captures).toEqual([]); + expect(record.removed).toBe(true); + }); + + test('a canvas the browser stopped drawing on is not a group with nothing in it', async () => { + const record = {captures: []}; + const lost = fakeMapClass(record, { + canvas: () => ({getContext: kind => (kind === 'webgl2' ? {isContextLost: () => true} : null)}), + }); + await expect(renderExport({MapClass: lost, style, frameFor, groups, isBlank: () => true})) + .rejects.toThrow('The browser stopped drawing the map'); + expect(record.captures).toEqual([]); + expect(record.removed).toBe(true); + }); + + test('is stopped after the last group is looked at, before the map to export from is made', async () => { + const record = {captures: []}; + let looked = 0; + await expect(renderExport({ + MapClass: looking(record), style, frameFor, groups, isBlank: () => !++looked, + // Stopped while the last group is looked at. + isCancelled: () => looked >= groups.length, + })).rejects.toMatchObject({cancelled: true}); + expect(looked).toBe(groups.length); + expect(record.maps).toBe(1); + expect(record.captures).toEqual([]); + }); + + test('is stopped while the groups are looked at', async () => { + const record = {captures: []}; + let looked = 0; + await expect(renderExport({ + MapClass: looking(record), style, frameFor, groups, isBlank: () => !++looked, + isCancelled: () => looked >= 1, + })).rejects.toMatchObject({cancelled: true}); + expect(looked).toBe(1); + expect(record.captures).toEqual([]); + }); + }); + + test('stops before a map is made when it is cancelled while the names of roads are read', async () => { + const record = {captures: []}; + let cancelled = false; + const readTile = jest.fn(async () => { + cancelled = true; + return null; + }); + await expect(renderExport({ + MapClass: fakeMapClass(record), style: TOWN, frame, readTile, isCancelled: () => cancelled, + groups: [{name: 'Labels', ids: ['roads_labels_minor']}], + })).rejects.toMatchObject({cancelled: true}); + expect(record.maps).toBeUndefined(); + }); + + test('stops between two groups when it is cancelled, and leaves nothing behind', async () => { + const record = {captures: []}; + const progress = []; + const rendering = renderExport({ + MapClass: fakeMapClass(record), style, frame, groups, + onProgress: name => progress.push(name), + // Cancelled while the first group is drawn. + isCancelled: () => record.captures.length >= 1, + }); + await expect(rendering).rejects.toMatchObject({cancelled: true}); + // The second group was not drawn, nor said to be. + expect(record.captures).toHaveLength(1); + expect(progress).toEqual(['Water']); + expect(record.removed).toBe(true); + }); + + test('a map which never finishes drawing is given up on', async () => { + jest.useFakeTimers(); + try { + const record = {captures: [], neverIdle: true}; + const rendering = renderExport({MapClass: fakeMapClass(record), style, frame, groups}); + const failure = expect(rendering).rejects.toThrow('took too long'); + // Once the map has loaded and is waiting to be drawn, the time runs out. + for (let i = 0; i < 20; i++) await Promise.resolve(); + // The time the page can not be seen (another tab is in front) is not counted: nothing + // is drawn then. + const hidden = jest.spyOn(document, 'hidden', 'get').mockReturnValue(true); + jest.advanceTimersByTime(600_000); + hidden.mockRestore(); + jest.advanceTimersByTime(119_000); + expect(record.removed).toBeFalsy(); + jest.advanceTimersByTime(2_000); + await failure; + expect(record.removed).toBe(true); + } finally { + jest.useRealTimers(); + } + }); +}); + +describe('what is written on the sheet', () => { + const style = { + sources: { + basemap: {type: 'vector'}, + satellite: {type: 'raster', attribution: 'Imagery © Somebody'}, + 'overlay:towers': {type: 'vector', attribution: 'Towers by Somebody Else'}, + unused: {type: 'vector', attribution: 'Not on this map'}, + }, + layers: [ + {id: 'background', type: 'background'}, + {id: 'water', type: 'fill', source: 'basemap'}, + {id: 'roads', type: 'line', source: 'basemap'}, + {id: 'satellite', type: 'raster', source: 'satellite'}, + {id: 'overlay:towers:points', type: 'circle', source: 'overlay:towers'}, + {id: 'hidden', type: 'fill', source: 'unused'}, + ], + }; + // The basemap learns where it is from when its file is read. + const loaded = {basemap: {attribution: '© OpenStreetMap contributors'}}; + const map = {getStyle: () => style, getSource: id => loaded[id]}; + const groups = [ + {name: 'Background', ids: ['background']}, + {name: 'Water', ids: ['water']}, + {name: 'Roads', ids: ['roads']}, + {name: 'Satellite', ids: ['satellite']}, + {name: 'Towers', ids: ['overlay:towers:points']}, + ]; + + test('says where the data of the exported layers is from, once each, as text', () => { + expect(exportCredits(map, groups)).toEqual([ + '© OpenStreetMap contributors', 'Imagery © Somebody', 'Towers by Somebody Else', + ]); + expect(exportCredits(map, groups.slice(0, 1))).toEqual([]); + expect(exportCredits(map, [])).toEqual([]); + }); + + test('an attribution which names many sources is each of them', () => { + const many = { + getStyle: () => ({ + sources: {a: {type: 'vector'}, b: {type: 'vector'}}, + layers: [{id: 'a', type: 'line', source: 'a'}, {id: 'b', type: 'line', source: 'b'}], + }), + getSource: id => ({ + a: {attribution: '© OpenStreetMap contributors | © OpenMapTiles | Somebody'}, + b: {attribution: 'Somebody | Somebody Else | '}, + })[id], + }; + expect(exportCredits(many, [{name: 'A', ids: ['a', 'b']}])).toEqual([ + '© OpenStreetMap contributors', '© OpenMapTiles', 'Somebody', 'Somebody Else', + ]); + }); + + test('says the day as the person exporting has it', () => { + expect(exportDate(new Date(2026, 0, 5, 23, 59))).toBe('2026-01-05'); + expect(exportDate(new Date(2026, 10, 15))).toBe('2026-11-15'); + }); + + test('is the name of the quadrangle, its credits and the day', () => { + expect(exportSheet(ANCHORAGE, map, groups.slice(1, 2), new Date(2026, 10, 15))).toEqual({ + name: '61°07′30″N 150°00′W', credits: ['© OpenStreetMap contributors'], date: '2026-11-15', + }); + }); + + test('says how far apart the contour lines are, when the map has them', () => { + const contours = {interval: 40, unit: 'feet'}; + const sheet = exportSheet(ANCHORAGE, map, groups.slice(1, 2), new Date(2026, 10, 15), null, contours); + expect(sheet.contours).toEqual(contours); + expect(exportSheet(ANCHORAGE, map, groups.slice(1, 2), new Date(2026, 10, 15), null, null)) + .not.toHaveProperty('contours'); + }); + + test('has the legend of the map, when the map has one', () => { + const legend = {ground: [1, 1, 1], lines: [{label: 'Highway', color: [0, 0, 0], width: 1}]}; + const sheet = exportSheet(ANCHORAGE, map, groups.slice(1, 2), new Date(2026, 10, 15), null, null, legend); + expect(sheet.legend).toEqual(legend); + expect(exportSheet(ANCHORAGE, map, groups.slice(1, 2), new Date(2026, 10, 15))).not.toHaveProperty('legend'); + }); +}); + +describe('how far apart the contour lines of an exported map are', () => { + const exported = [ + {name: 'Water', ids: ['water']}, + {name: 'Contours', ids: ['contour-lines', 'contour-lines-major', 'contour-labels']}, + ]; + const parts = ['contour-lines', 'contour-labels']; + + test('is the least of the two intervals, in the unit the map measures in', () => { + expect(exportContours(exported, parts, [40, 200], true)).toEqual({interval: 40, unit: 'feet'}); + expect(exportContours(exported, parts, [20, 100], false)).toEqual({interval: 20, unit: 'meters'}); + // The darker lines alone are still contour lines. + expect(exportContours([{name: 'Contours', ids: ['contour-lines-major']}], parts, [40, 200], true)) + .toEqual({interval: 40, unit: 'feet'}); + }); + + test('is nothing when the contours are not exported, or are not drawn', () => { + expect(exportContours(exported.slice(0, 1), parts, [40, 200], true)).toBeNull(); + expect(exportContours([], parts, [40, 200], true)).toBeNull(); + expect(exportContours(exported, parts, null, true)).toBeNull(); + }); +}); + +describe('what the PDF is called', () => { + test('says where it is of', () => { + expect(exportFileName(ANCHORAGE)).toBe('wrolpi-map_24k_N61.125_W150.000.pdf'); + expect(exportFileName(quadAt(151.21, -33.87))).toBe('wrolpi-map_24k_S33.875_E151.125.pdf'); + expect(exportTitle(ANCHORAGE)).toBe('1:24,000 61°07′30″N 150°00′W'); + }); + + test('says what the USGS calls it, when it calls it anything', () => { + const berthoud = {name: 'Berthoud', state: 'Colorado', exact: true}; + const anchorage = {name: 'Anchorage A-8 NW', state: 'Alaska', exact: false}; + expect(exportFileName(BERTHOUD, berthoud)).toBe('wrolpi-map_24k_Berthoud_N40.250_W105.125.pdf'); + expect(exportFileName(ANCHORAGE, anchorage)).toBe('wrolpi-map_24k_Anchorage_A_8_NW_N61.125_W150.000.pdf'); + expect(exportFileName(BERTHOUD, {name: '../Ni‘ihau: “North”?'})).toBe( + 'wrolpi-map_24k_Ni_ihau_North_N40.250_W105.125.pdf'); + // An accent is left off its letter. + expect(exportFileName(BERTHOUD, {name: 'Cañon City'})).toBe('wrolpi-map_24k_Canon_City_N40.250_W105.125.pdf'); + expect(exportFileName(BERTHOUD, {name: '///'})).toBe('wrolpi-map_24k_N40.250_W105.125.pdf'); + expect(exportTitle(BERTHOUD, berthoud)).toBe('1:24,000 Berthoud, Colorado'); + // A quadrangle of the grid which is not all of the named one is a part of it. + expect(exportTitle(ANCHORAGE, anchorage)).toBe('1:24,000 Part of Anchorage A-8 NW, Alaska'); + const map = {getStyle: () => ({layers: [], sources: {}}), getSource: () => undefined}; + expect(exportSheet(BERTHOUD, map, [], new Date(2026, 10, 15), berthoud)).toEqual({ + name: 'Berthoud, Colorado', credits: [], date: '2026-11-15', + }); + expect(exportSheet(BERTHOUD, map, [], new Date(2026, 10, 15), null).name).toBe('40°15′N 105°07′30″W'); + }); +}); + +describe('what a basemap draws from a deeper zoom', () => { + const style = { + sources: {a: {type: 'vector', url: 'pmtiles://a'}}, + layers: [ + {id: 'water_river', type: 'line', source: 'a', minzoom: 9}, + {id: 'water_stream', type: 'line', source: 'a', minzoom: 14}, + {id: 'roads_taxiway', type: 'line', source: 'a', minzoom: 13}, + {id: 'buildings_3d', type: 'fill-extrusion', source: 'a', minzoom: 15}, + {id: 'pois', type: 'symbol', source: 'a', minzoom: 14}, + ], + }; + const minzooms = zoom => Object.fromEntries( + exportStyle(style, [], {zoom}).layers.map(layer => [layer.id, layer.minzoom])); + + test('is drawn on a quadrangle, which is drawn a little short of there', () => { + // A quadrangle at 40 degrees. + expect(minzooms(13.85)).toEqual({ + water_river: 9, water_stream: 13, roads_taxiway: 13, buildings_3d: 15, pois: 14, + }); + // Far north, a quadrangle is drawn from tiles two zooms short. + expect(minzooms(12.7)).toMatchObject({water_stream: 12, roads_taxiway: 12, pois: 14}); + }); + + test('is as it was where the map is drawn that deep, and when the zoom is not said', () => { + expect(minzooms(14.2)).toMatchObject({water_stream: 14, roads_taxiway: 13}); + expect(minzooms(null)).toMatchObject({water_stream: 14}); + }); +}); + +describe('the map files which are of somewhere else', () => { + const style = { + sources: { + 'alaska.pmtiles': {type: 'vector', url: 'pmtiles:///media/alaska.pmtiles'}, + 'colorado.pmtiles': {type: 'vector', url: 'pmtiles:///media/colorado.pmtiles'}, + 'beside.pmtiles': {type: 'vector', url: 'pmtiles:///media/beside.pmtiles'}, + 'unsaid.pmtiles': {type: 'vector', url: 'pmtiles:///media/unsaid.pmtiles'}, + 'broken.pmtiles': {type: 'vector', url: 'pmtiles:///media/broken.pmtiles'}, + 'terrain': {type: 'raster-dem', url: 'contours://terrain'}, + 'pins': {type: 'geojson', data: {}}, + }, + }; + const edges = { + 'pmtiles:///media/alaska.pmtiles': [-180, 51, -129, 72], + 'pmtiles:///media/colorado.pmtiles': [-109.1, 36.9, -102, 41.1], + // It ends where the quadrangle begins. + 'pmtiles:///media/beside.pmtiles': [-106, 40, -105.125, 41], + 'pmtiles:///media/unsaid.pmtiles': null, + }; + const asked = []; + const readBounds = async url => { + asked.push(url); + if (url.includes('broken')) throw new Error('No such file'); + return edges[url]; + }; + + test('are those whose file says it is of elsewhere, and no other', async () => { + const warn = jest.spyOn(console, 'warn').mockImplementation(() => undefined); + try { + const outside = await sourcesOutside(style, BERTHOUD_BOUNDS, readBounds); + expect([...outside].sort()).toEqual(['alaska.pmtiles', 'beside.pmtiles']); + // Only a map file is asked. + expect(asked).toHaveLength(5); + } finally { + warn.mockRestore(); + } + }); + + test('are none of a style with no sources', async () => { + expect((await sourcesOutside({}, BERTHOUD_BOUNDS, readBounds)).size).toBe(0); + }); +}); + +describe('whether nothing is drawn on a canvas', () => { + let getContext; + afterEach(() => getContext.mockRestore()); + + // A canvas of `rows` rows, with something drawn in the rows of `drawn`. + const look = (rows, drawn = []) => { + const bands = []; + getContext = jest.spyOn(HTMLCanvasElement.prototype, 'getContext').mockImplementation(() => { + let top = 0; + return { + clearRect: jest.fn(), + drawImage: (canvas, x, y) => { + top = y; + }, + getImageData: (x, y, width, height) => { + bands.push([top, height]); + const data = new Uint8ClampedArray(width * height * 4); + // One pixel, barely there. + for (const row of drawn) if (row >= top && row < top + height) data[(row - top) * width * 4 + 3] = 1; + return {data}; + }, + }; + }); + return {blank: isBlankCanvas({width: 4, height: rows}), bands}; + }; + + test('every row is looked at, a band at a time', () => { + expect(look(600)).toEqual({blank: true, bands: [[0, 256], [256, 256], [512, 88]]}); + }); + + test('one faint pixel is something drawn, and no more is looked at', () => { + expect(look(600, [599]).blank).toBe(false); + expect(look(600, [300])).toEqual({blank: false, bands: [[0, 256], [256, 256]]}); + }); + + test('a pixel which is not seen is nothing drawn, whatever color it has a trace of', () => { + getContext = jest.spyOn(HTMLCanvasElement.prototype, 'getContext').mockImplementation(() => ({ + clearRect: jest.fn(), + drawImage: jest.fn(), + // Red, green and blue, and no alpha: what a map leaves where it drew nothing. + getImageData: (x, y, width, height) => ({data: new Uint8ClampedArray(width * height * 4).fill(1) + .map((value, index) => (index % 4 === 3 ? 0 : value))}), + })); + expect(isBlankCanvas({width: 4, height: 4})).toBe(true); + }); + + test('a canvas which can not be looked at is not taken to be blank', () => { + getContext = jest.spyOn(HTMLCanvasElement.prototype, 'getContext').mockImplementation(() => null); + expect(isBlankCanvas({width: 4, height: 4})).toBe(false); + }); +}); diff --git a/app/src/components/mapExportLegend.js b/app/src/components/mapExportLegend.js new file mode 100644 index 00000000..9bb88a9a --- /dev/null +++ b/app/src/components/mapExportLegend.js @@ -0,0 +1,117 @@ +// The legend of an exported map: what its lines are, each as the map draws it. +// +// The map's style says how a road is drawn at each zoom, and a sheet is drawn at one. The lines are +// described here, where the style can be read, and drawn on the sheet by the API. + +import {expression, latest} from "@maplibre/maplibre-gl-style-spec"; +import {EXPORT_CSS_DPI} from "./mapExport"; + +const POINTS_PER_INCH = 72; +const WHITE = [1, 1, 1]; +// The thinnest line (points) a legend has. A style brings a line in from nothing as the map is +// zoomed in, and a line of a few hundredths of a point is not one anybody sees on a sheet. +export const LEGEND_LEAST_WIDTH = 0.1; + +// The lines a legend may have, from the top: what each is called, the layer of the basemap (or of +// the contours) which draws it, and the layers which may draw its edges under it. +export const LEGEND_LINES = [ + {label: "Highway", line: "roads_highway", casings: ["roads_highway_casing_late", "roads_highway_casing_early"]}, + {label: "Major road", line: "roads_major", casings: ["roads_major_casing_late", "roads_major_casing_early"]}, + {label: "Minor road", line: "roads_minor", casings: ["roads_minor_casing"]}, + {label: "Path or track", line: "roads_other"}, + {label: "Railway", line: "roads_rail"}, + {label: "Boundary", line: "boundaries"}, + {label: "Index contour", line: "contour-lines-major"}, + {label: "Contour", line: "contour-lines"}, +]; + +// The name of a basemap layer without the source it is of ("oregon.pmtiles:water" is "water"). +function layerName(layerId) { + const id = String(layerId); + return id.includes(":") ? id.split(":").slice(1).join(":") : id; +} + +// What a property of a layer is at a zoom; the style's own default when the layer does not say. +function valueAt(layer, group, property, zoom) { + const spec = latest[`${group}_${layer.type}`]?.[property]; + if (!spec) return undefined; + const value = layer[group]?.[property] ?? spec.default; + if (value === undefined) return undefined; + try { + return expression.normalizePropertyExpression(value, spec).evaluate({zoom}); + } catch (e) { + return undefined; + } +} + +// A color of the style as red, green and blue from 0 to 1, and how opaque it is. +function colorParts(color) { + if (!color || !Number.isFinite(color.a) || color.a <= 0) return null; + // The style keeps a color multiplied by its opacity. + const part = n => Math.round(Math.min(1, Math.max(0, n / color.a)) * 1000) / 1000; + return {color: [part(color.r), part(color.g), part(color.b)], opacity: color.a}; +} + +function drawnAt(layer, zoom) { + return (layer.minzoom === undefined || zoom >= layer.minzoom) && (layer.maxzoom === undefined || zoom < layer.maxzoom); +} + +const round = n => Math.round(n * 100) / 100; + +// The legend of a map which is exported: {ground, lines}, for the sheet (see `Sheet.legend` in +// modules/map/sheet.py), or null when the map has none of the lines a legend is of. +// +// style: the map's style. groups: the layers which are exported (of exportGroups). zoom: the zoom +// the map is exported at. cssDpi: how many CSS pixels of the style are an inch of the sheet. +// +// A line is in the legend when its layer is exported and draws a line which can be seen at that +// zoom: a path which the style only draws from zoom 14 is not on a sheet drawn at 13, nor in its +// legend, and at 14.2 it is too thin to be on either. +export function exportLegend(style, groups, zoom, cssDpi = EXPORT_CSS_DPI) { + const exported = new Set(groups.flatMap(group => group.ids)); + const layers = (style.layers || []).filter(layer => exported.has(layer.id) && drawnAt(layer, zoom)); + const points = POINTS_PER_INCH / cssDpi; + const find = name => layers.find(layer => layer.type === "line" && layerName(layer.id) === name); + + const lines = []; + for (const {label, line, casings = []} of LEGEND_LINES) { + const layer = find(line); + if (!layer) continue; + const width = valueAt(layer, "paint", "line-width", zoom); + const parts = colorParts(valueAt(layer, "paint", "line-color", zoom)); + if (!parts || !(width * points >= LEGEND_LEAST_WIDTH)) continue; + const entry = { + label, + color: parts.color, + width: round(width * points), + opacity: round(parts.opacity * (valueAt(layer, "paint", "line-opacity", zoom) ?? 1)), + }; + // The lengths of a dash are in widths of its line. + const dash = valueAt(layer, "paint", "line-dasharray", zoom); + if (Array.isArray(dash) && dash.length > 1) entry.dash = dash.map(n => round(n * width * points)); + // The edges of a road are a wider line under it, drawn as two lines with a gap between them. + const casing = casings.map(find).find(Boolean); + if (casing) { + const edge = valueAt(casing, "paint", "line-width", zoom); + const gap = valueAt(casing, "paint", "line-gap-width", zoom) ?? 0; + const color = colorParts(valueAt(casing, "paint", "line-color", zoom)); + if (color && edge > 0) { + entry.casing_color = color.color; + entry.casing_width = round((gap + 2 * edge) * points); + } + } + lines.push(entry); + } + if (!lines.length) return null; + + // The land the lines are on: the topmost of the layers which color all of it. + let ground = WHITE; + for (const layer of layers) { + const name = layerName(layer.id); + const color = layer.type === "background" ? valueAt(layer, "paint", "background-color", zoom) + : layer.type === "fill" && name === "earth" ? valueAt(layer, "paint", "fill-color", zoom) : null; + const parts = colorParts(color); + if (parts) ground = parts.color; + } + return {ground, lines}; +} diff --git a/app/src/components/mapExportLegend.test.js b/app/src/components/mapExportLegend.test.js new file mode 100644 index 00000000..78c62d3c --- /dev/null +++ b/app/src/components/mapExportLegend.test.js @@ -0,0 +1,133 @@ +import {exportLegend, LEGEND_LEAST_WIDTH, LEGEND_LINES} from './mapExportLegend'; + +// A basemap as the map's style has it: roads with edges under them, at widths which change with +// the zoom; and the contours of the terrain. +const grows = (...stops) => ['interpolate', ['exponential', 1.6], ['zoom'], ...stops]; +const STYLE = { + layers: [ + {id: 'background', type: 'background', paint: {'background-color': '#cccccc'}}, + {id: 'earth', type: 'fill', paint: {'fill-color': '#e2dfda'}}, + {id: 'roads_minor_casing', type: 'line', paint: { + 'line-color': '#e0e0e0', 'line-gap-width': grows(11, 0, 12.5, 0.5, 15, 2), 'line-width': grows(12, 0, 12.5, 1), + }}, + {id: 'roads_highway_casing_late', type: 'line', minzoom: 12, paint: { + 'line-color': '#e0e0e0', 'line-gap-width': 2, 'line-width': 1, + }}, + {id: 'roads_highway_casing_early', type: 'line', maxzoom: 12, paint: { + 'line-color': '#000000', 'line-gap-width': 1, 'line-width': 0.5, + }}, + {id: 'roads_other', type: 'line', paint: {'line-color': '#ebebeb', 'line-dasharray': [3, 1], 'line-width': grows(14, 0, 20, 7)}}, + {id: 'roads_minor', type: 'line', paint: { + 'line-color': grows(11, '#ebebeb', 16, '#ffffff'), 'line-width': grows(11, 0, 12.5, 0.5, 15, 2), + }}, + {id: 'roads_highway', type: 'line', paint: {'line-color': '#ffffff', 'line-width': 2}}, + {id: 'roads_rail', type: 'line', paint: { + 'line-dasharray': [0.3, 0.75], 'line-opacity': 0.5, 'line-color': '#a7b1b3', 'line-width': 1, + }}, + {id: 'boundaries', type: 'line', paint: { + 'line-color': '#adadad', 'line-width': 0.4, 'line-dasharray': ['step', ['zoom'], ['literal', [2]], 4, ['literal', [2, 1]]], + }}, + {id: 'roads_labels_minor', type: 'symbol'}, + {id: 'contour-lines', type: 'line', paint: {'line-color': 'rgba(150,100,50,0.3)', 'line-width': 0.5}}, + {id: 'contour-lines-major', type: 'line', paint: {'line-color': 'rgba(150,100,50,0.5)', 'line-width': 1}}, + ], +}; +const ALL = [{name: 'Everything', ids: STYLE.layers.map(layer => layer.id)}]; +const only = (...ids) => [{name: 'Some', ids}]; +const labels = legend => legend.lines.map(line => line.label); + +describe('the legend of an exported map', () => { + test('is of the lines which are exported and drawn at the zoom of the sheet, from the top', () => { + const legend = exportLegend(STYLE, ALL, 13.2); + // A path is drawn only from zoom 14: it is not on this sheet. + expect(labels(legend)).toEqual(['Highway', 'Minor road', 'Railway', 'Boundary', 'Index contour', 'Contour']); + expect(labels(exportLegend(STYLE, ALL, 15))).toContain('Path or track'); + // In the order they are listed, whatever order the style has them in. + const order = LEGEND_LINES.map(line => line.label); + expect(labels(legend)).toEqual(order.filter(label => labels(legend).includes(label))); + }); + + test('a line is as wide on the sheet as the map draws it: 150 pixels of the style are an inch', () => { + const {lines} = exportLegend(STYLE, ALL, 13.2); + const highway = lines.find(line => line.label === 'Highway'); + // 2 pixels are 0.96 points; its edges are a pixel each side of it. + expect(highway).toEqual({ + label: 'Highway', color: [1, 1, 1], width: 0.96, opacity: 1, + casing_color: [0.878, 0.878, 0.878], casing_width: 1.92, + }); + // At another scale of the style it is as much wider. + expect(exportLegend(STYLE, ALL, 13.2, 75).lines[0].width).toBe(1.92); + }); + + test('a color and a width which change with the zoom are those of the zoom', () => { + const at = zoom => exportLegend(STYLE, ALL, zoom).lines.find(line => line.label === 'Minor road'); + expect(at(13.2).width).toBeGreaterThan(at(12.6).width); + expect(at(13.2).width).toBeLessThan(at(15).width); + expect(at(15).width).toBe(0.96); + expect(at(12.6).color[0]).toBeLessThan(at(15.9).color[0]); + // The edges of a road are those of the layer which draws them at that zoom. + const highway = zoom => exportLegend(STYLE, ALL, zoom).lines[0]; + expect(highway(13).casing_color).toEqual([0.878, 0.878, 0.878]); + expect(highway(11).casing_color).toEqual([0, 0, 0]); + expect(highway(11).casing_width).toBe(0.96); + }); + + test('a broken line has its dashes, and a faint one how faint it is', () => { + const {lines} = exportLegend(STYLE, ALL, 13.2); + const line = label => lines.find(i => i.label === label); + // The dashes of a style are in widths of the line: 0.3 and 0.75 of 0.48 points. + expect(line('Railway')).toMatchObject({dash: [0.14, 0.36], opacity: 0.5, width: 0.48}); + expect(line('Boundary').dash).toEqual([0.38, 0.19]); + // A color which can be seen through is that color, and how much of it. + expect(line('Contour')).toEqual({label: 'Contour', color: [0.588, 0.392, 0.196], width: 0.24, opacity: 0.3}); + expect(line('Index contour')).toMatchObject({width: 0.48, opacity: 0.5}); + expect(line('Highway')).not.toHaveProperty('dash'); + }); + + test('is on the color of the land which is exported', () => { + expect(exportLegend(STYLE, ALL, 13.2).ground).toEqual([0.886, 0.875, 0.855]); + // Without the land the lines are on the color under it, and without that on paper. + expect(exportLegend(STYLE, only('background', 'roads_highway'), 13.2).ground).toEqual([0.8, 0.8, 0.8]); + expect(exportLegend(STYLE, only('roads_highway'), 13.2).ground).toEqual([1, 1, 1]); + }); + + test('has only what is exported', () => { + const legend = exportLegend(STYLE, only('roads_highway', 'contour-lines'), 13.2); + expect(labels(legend)).toEqual(['Highway', 'Contour']); + // The road without its edges. + expect(legend.lines[0]).not.toHaveProperty('casing_color'); + // A map with none of the lines has no legend. + expect(exportLegend(STYLE, only('earth', 'roads_labels_minor'), 13.2)).toBeNull(); + expect(exportLegend(STYLE, [], 13.2)).toBeNull(); + expect(exportLegend({}, ALL, 13.2)).toBeNull(); + }); + + test('the layers of a second basemap file are the same lines', () => { + const style = {layers: STYLE.layers.map(layer => ({...layer, id: `b.pmtiles:${layer.id}`}))}; + const groups = [{name: 'Everything', ids: style.layers.map(layer => layer.id)}]; + expect(labels(exportLegend(style, groups, 13.2))).toEqual(labels(exportLegend(STYLE, ALL, 13.2))); + }); + + test('a line too thin to be seen is not in the legend', () => { + // As the basemap draws a path: from nothing at zoom 14, where a quadrangle near the equator is drawn. + const path = {id: 'roads_other', type: 'line', paint: {'line-color': '#ebebeb', 'line-width': grows(14, 0, 20, 7)}}; + const style = {layers: [path, {id: 'roads_highway', type: 'line', paint: {'line-width': 2}}]}; + const groups = only('roads_other', 'roads_highway'); + expect(labels(exportLegend(style, groups, 14.2))).toEqual(['Highway']); + // Once it is a tenth of a point wide it is. + expect(labels(exportLegend(style, groups, 15.5))).toEqual(['Highway', 'Path or track']); + const least = {layers: [{id: 'roads_highway', type: 'line', paint: {'line-width': LEGEND_LEAST_WIDTH * 150 / 72}}]}; + expect(exportLegend(least, only('roads_highway'), 13).lines[0].width).toBe(LEGEND_LEAST_WIDTH); + const less = {layers: [{id: 'roads_highway', type: 'line', paint: {'line-width': 0.2}}]}; + expect(exportLegend(less, only('roads_highway'), 13)).toBeNull(); + }); + + test('a layer which says nothing of its line is drawn as a style draws one', () => { + const style = {layers: [{id: 'roads_highway', type: 'line'}]}; + expect(exportLegend(style, only('roads_highway'), 13).lines).toEqual([ + {label: 'Highway', color: [0, 0, 0], width: 0.48, opacity: 1}]); + // What can not be made a color or a width of is left out. + const broken = {layers: [{id: 'roads_highway', type: 'line', paint: {'line-color': ['nonsense'], 'line-width': 1}}]}; + expect(exportLegend(broken, only('roads_highway'), 13)).toBeNull(); + }); +}); diff --git a/app/src/components/mapOverlays.test.js b/app/src/components/mapOverlays.test.js index 6679f1a1..a230a16f 100644 --- a/app/src/components/mapOverlays.test.js +++ b/app/src/components/mapOverlays.test.js @@ -1,6 +1,8 @@ -import {addOverlaysToMap, orderOverlayLayers} from '../map-shared/overlays.js'; +import {addOverlaysToMap, isOverlayLabelLayer, orderOverlayLayers} from '../map-shared/overlays.js'; import { addOverlaysToStyle, + basemapLabelsStart, + labelsOverGround, buildOverlayLayers, buildOverlaySource, isBasemapLayer, @@ -240,7 +242,7 @@ describe('the style of an overlay', () => { expect(visibility(setOverlayEnabled(state, FEATURES, true))).toEqual(['visible', 'none', 'visible']); }); - test('a raster overlay goes under the basemap labels, vector overlays on top', () => { + test('the ground of an overlay goes under the basemap labels, and what it marks goes on top', () => { const sources = {basemap: {}}; const layers = [ {id: 'earth', type: 'fill'}, {id: 'roads', type: 'line'}, @@ -250,19 +252,114 @@ describe('the style of an overlay', () => { expect(Object.keys(sources)).toEqual(['basemap', 'overlay:extras/features.pmtiles', 'overlay:satellite.pmtiles']); expect(layers.map(l => l.id)).toEqual([ 'earth', 'roads', + // A picture under an area under a line: none of them over a name. 'overlay:satellite.pmtiles:raster', - 'places', 'pois', - // Fills under lines under points. 'overlay:extras/features.pmtiles:flood_zones:fill', 'overlay:extras/features.pmtiles:power_lines:line', + 'places', 'pois', 'overlay:extras/features.pmtiles:towers:circle', ]); }); - test('a raster overlay is drawn last when the basemap has no labels', () => { + test('the ground of an overlay is over the ground of every basemap file', () => { + // A map of two basemap files: the labels of the first are under the ground of the second. + const layers = [ + {id: 'earth', type: 'fill'}, {id: 'roads', type: 'line'}, {id: 'places', type: 'symbol'}, + {id: 'second.pmtiles:water', type: 'fill'}, {id: 'second.pmtiles:roads', type: 'line'}, + {id: 'second.pmtiles:places', type: 'symbol'}, {id: 'second.pmtiles:pois', type: 'symbol'}, + ]; + expect(basemapLabelsStart(layers)).toBe(5); + addOverlaysToStyle({}, layers, [FEATURES, SATELLITE], {}); + expect(layers.map(l => l.id)).toEqual([ + 'earth', 'roads', 'places', + 'second.pmtiles:water', 'second.pmtiles:roads', + // Over the land, water and roads of both files; under the labels which are over them. + 'overlay:satellite.pmtiles:raster', + 'overlay:extras/features.pmtiles:flood_zones:fill', + 'overlay:extras/features.pmtiles:power_lines:line', + 'second.pmtiles:places', 'second.pmtiles:pois', + 'overlay:extras/features.pmtiles:towers:circle', + ]); + }); + + test('the ground of an overlay is under the basemap labels when the map has contours', () => { + const layers = [ + {id: 'earth', type: 'fill'}, {id: 'places', type: 'symbol'}, + {id: 'second.pmtiles:water', type: 'fill'}, {id: 'second.pmtiles:places', type: 'symbol'}, + {id: 'contour-lines', type: 'line', source: 'contours'}, + {id: 'contour-labels', type: 'symbol', source: 'contours'}, + ]; + addOverlaysToStyle({}, layers, [FEATURES], {}); + expect(layers.map(l => l.id)).toEqual([ + 'earth', 'places', 'second.pmtiles:water', + 'overlay:extras/features.pmtiles:flood_zones:fill', + 'overlay:extras/features.pmtiles:power_lines:line', + 'second.pmtiles:places', + 'contour-lines', 'contour-labels', + 'overlay:extras/features.pmtiles:towers:circle', + ]); + }); + + test('the labels of every basemap file go over the ground of every file', () => { + const layers = [ + {id: 'earth', type: 'fill'}, {id: 'roads', type: 'line'}, {id: 'places', type: 'symbol'}, + {id: 'second.pmtiles:water', type: 'fill'}, {id: 'second.pmtiles:places', type: 'symbol'}, + {id: 'third.pmtiles:roads', type: 'line'}, {id: 'third.pmtiles:pois', type: 'symbol'}, + ]; + const ordered = labelsOverGround(layers); + expect(ordered.map(l => l.id)).toEqual([ + 'earth', 'roads', 'second.pmtiles:water', 'third.pmtiles:roads', + 'places', 'second.pmtiles:places', 'third.pmtiles:pois', + ]); + // The same layers, and what was given is not changed. + expect(ordered).toHaveLength(layers.length); + expect(layers[2].id).toBe('places'); + expect(labelsOverGround(undefined)).toEqual([]); + + // An overlay then goes under the labels of all three files, and over the ground of all three. + addOverlaysToStyle({}, ordered, [FEATURES], {}); + expect(ordered.map(l => l.id)).toEqual([ + 'earth', 'roads', 'second.pmtiles:water', 'third.pmtiles:roads', + 'overlay:extras/features.pmtiles:flood_zones:fill', + 'overlay:extras/features.pmtiles:power_lines:line', + 'places', 'second.pmtiles:places', 'third.pmtiles:pois', + 'overlay:extras/features.pmtiles:towers:circle', + ]); + }); + + test('where the labels of a basemap begin', () => { + const symbol = id => ({id, type: 'symbol'}); + const line = id => ({id, type: 'line'}); + expect(basemapLabelsStart([])).toBe(0); + expect(basemapLabelsStart(undefined)).toBe(0); + expect(basemapLabelsStart([line('roads')])).toBe(1); + expect(basemapLabelsStart([symbol('places')])).toBe(0); + // The contour lines are drawn after the basemap's labels, and are not of the basemap: what goes + // under the labels does not go under the contours instead, which would be over every label. + const contours = [ + {id: 'contour-lines', type: 'line', source: 'contours'}, + {id: 'contour-labels', type: 'symbol', source: 'contours'}, + ]; + expect(basemapLabelsStart([line('roads'), symbol('places'), symbol('pois'), ...contours])).toBe(1); + // With no label over the basemap's ground, it is over that ground and under the contours. + expect(basemapLabelsStart([line('roads'), ...contours])).toBe(1); + // An overlay which is already on the map is not of the basemap. + expect(basemapLabelsStart([ + line('roads'), {id: 'overlay:a.pmtiles:x:line', type: 'line'}, symbol('places'), + {id: 'overlay:a.pmtiles:x:circle', type: 'circle'}, + ])).toBe(2); + }); + + test('an overlay is drawn last when the basemap has no labels', () => { const layers = [{id: 'earth', type: 'fill'}]; - addOverlaysToStyle({}, layers, [SATELLITE], {}); - expect(layers.map(l => l.id)).toEqual(['earth', 'overlay:satellite.pmtiles:raster']); + addOverlaysToStyle({}, layers, [SATELLITE, FEATURES], {}); + expect(layers.map(l => l.id)).toEqual([ + 'earth', + 'overlay:satellite.pmtiles:raster', + 'overlay:extras/features.pmtiles:flood_zones:fill', + 'overlay:extras/features.pmtiles:power_lines:line', + 'overlay:extras/features.pmtiles:towers:circle', + ]); }); }); @@ -371,8 +468,11 @@ describe('adding overlays to a map a layer at a time', () => { const whole = BASEMAP.map(l => ({...l})); addOverlaysToStyle(sources, whole, [FEATURES, SATELLITE], {}); expect(map.layers.map(l => l.id)).toEqual(whole.map(l => l.id)); - // The raster is under the basemap's labels. - expect(map.layers.map(l => l.id).indexOf('overlay:satellite.pmtiles:raster')).toBe(1); + // The raster, and the overlay's areas and lines, are under the basemap's labels; its points are over them. + const ids = map.layers.map(l => l.id); + expect(ids.indexOf('overlay:satellite.pmtiles:raster')).toBe(1); + expect(ids.indexOf('overlay:extras/features.pmtiles:power_lines:line')).toBeLessThan(ids.indexOf('places')); + expect(ids.indexOf('overlay:extras/features.pmtiles:towers:circle')).toBeGreaterThan(ids.indexOf('pois')); }); test('layers are added as the user last chose to see them', () => { @@ -389,10 +489,11 @@ describe('adding overlays to a map a layer at a time', () => { const refused = addOverlaysToMap(map, [FEATURES, other], {}, URLS); expect(refused).toEqual({'extras/features.pmtiles': 1, 'other.pmtiles': 1}); expect(map.layers.map(l => l.id)).toEqual([ - 'earth', 'places', 'pois', + 'earth', 'overlay:extras/features.pmtiles:flood_zones:fill', 'overlay:extras/features.pmtiles:power_lines:line', 'overlay:other.pmtiles:roads:line', + 'places', 'pois', ]); }); @@ -412,23 +513,32 @@ describe('adding overlays to a map a layer at a time', () => { expect(map.layers.map(l => l.id)).toEqual(before); }); - test('an overlay with its own style keeps that style\'s order, under the generic ones', () => { + test('an overlay with its own style keeps that style\'s order, under the generic ones, in each part', () => { const styled = { ...FEATURES, map_path: 'styled.pmtiles', styleLayers: [ {id: 'overlay:styled.pmtiles:towers:icons', type: 'symbol', source: 'overlay:styled.pmtiles', 'source-layer': 'towers'}, {id: 'overlay:styled.pmtiles:flood_zones:area', type: 'fill', source: 'overlay:styled.pmtiles', 'source-layer': 'flood_zones'}, + {id: 'overlay:styled.pmtiles:towers:names', type: 'symbol', source: 'overlay:styled.pmtiles', 'source-layer': 'towers'}, + {id: 'overlay:styled.pmtiles:power_lines:wires', type: 'line', source: 'overlay:styled.pmtiles', 'source-layer': 'power_lines'}, ], }; - const {rasters, vectors} = orderOverlayLayers([FEATURES, styled, SATELLITE], {}); - expect(rasters.map(l => l.id)).toEqual(['overlay:satellite.pmtiles:raster']); - expect(vectors.map(l => l.id)).toEqual([ - 'overlay:styled.pmtiles:towers:icons', + const {under, over} = orderOverlayLayers([FEATURES, styled, SATELLITE], {}); + // What goes under the basemap's labels: no text, icon or point. + expect(under.map(l => l.id)).toEqual([ + 'overlay:satellite.pmtiles:raster', 'overlay:styled.pmtiles:flood_zones:area', + 'overlay:styled.pmtiles:power_lines:wires', 'overlay:extras/features.pmtiles:flood_zones:fill', 'overlay:extras/features.pmtiles:power_lines:line', + ]); + // What goes over them: every label, whichever overlay it is of. + expect(over.map(l => l.id)).toEqual([ + 'overlay:styled.pmtiles:towers:icons', + 'overlay:styled.pmtiles:towers:names', 'overlay:extras/features.pmtiles:towers:circle', ]); + expect([...under, ...over].every(l => isOverlayLabelLayer(l) === over.includes(l))).toBe(true); }); }); diff --git a/app/src/components/mapPrintStyle.js b/app/src/components/mapPrintStyle.js new file mode 100644 index 00000000..703f7f27 --- /dev/null +++ b/app/src/components/mapPrintStyle.js @@ -0,0 +1,353 @@ +// The map as it is printed. The light and dark maps are made for a screen, which is lit: their +// roads are white on pale gray and their streams half a pixel of pale blue, which is nothing on +// paper. The printed map is drawn on white, with dark lines and names, in the colors a topographic +// sheet has: black for what was built, blue for water, green for what grows, brown for the land. + +import {layersWithCustomTheme, namedTheme} from "protomaps-themes-base"; + +// What the map is called where a look is chosen and remembered. +export const PRINT_LOOK = "print"; +// The looks a map may be exported in: the printed map, and the two a screen has. +export const EXPORT_LOOKS = [ + {value: PRINT_LOOK, label: "Print"}, + {value: "light", label: "Light"}, + {value: "dark", label: "Dark"}, +]; +const STORAGE_KEY_LOOK = "wrolpi-map-export-look"; +const STORAGE_KEY_COLORS = "wrolpi-map-print-colors"; + +const BLACK = "#1a1a1a"; +const CASING = "#4d4d4d"; +const WHITE = "#ffffff"; +const WATER = "#a9d4f2"; +// Water which is a line (a stream) or a name is darker than water which is an area: a thin pale +// line is not seen. +const WATER_LINE = "#2f7fc4"; +const WATER_NAME = "#1b5fa3"; +const HIGHWAY = "#e2725b"; +const MAJOR = "#f2c14e"; +const TUNNEL = "#e6e6e6"; +const TUNNEL_CASING = "#9a9a9a"; + +// The colors of the printed map which are not the light map's. A basemap is drawn in some seventy +// colors (see `namedTheme`), and these are every one which is seen at the scale of a quadrangle. +export const PRINT_COLORS = { + background: WHITE, + earth: WHITE, + park_a: "#dcefd0", + park_b: "#c2e2b0", + wood_a: "#d3ebc6", + wood_b: "#b5dca4", + scrub_a: "#e3edcd", + scrub_b: "#cfe0b3", + hospital: "#f3e3e0", + school: "#f1ead9", + industrial: "#e6e4ec", + pedestrian: "#efefef", + glacier: "#eef7fd", + sand: "#f4ecd2", + beach: "#f4ecd2", + aerodrome: "#e7e7ee", + runway: "#a9a9b3", + zoo: "#d6ecd6", + military: "#eedddd", + water: WATER, + pier: "#d9d9d9", + buildings: "#6e6e6e", + + tunnel_other_casing: TUNNEL_CASING, + tunnel_minor_casing: TUNNEL_CASING, + tunnel_link_casing: TUNNEL_CASING, + tunnel_major_casing: TUNNEL_CASING, + tunnel_highway_casing: TUNNEL_CASING, + tunnel_other: TUNNEL, + tunnel_minor: TUNNEL, + tunnel_link: TUNNEL, + tunnel_major: TUNNEL, + tunnel_highway: TUNNEL, + + minor_service_casing: CASING, + minor_casing: CASING, + link_casing: CASING, + major_casing_late: BLACK, + major_casing_early: BLACK, + highway_casing_late: BLACK, + highway_casing_early: BLACK, + other: CASING, + minor_service: WHITE, + minor_a: WHITE, + minor_b: WHITE, + link: MAJOR, + major: MAJOR, + highway: HIGHWAY, + + bridges_other_casing: CASING, + bridges_minor_casing: CASING, + bridges_link_casing: CASING, + bridges_major_casing: BLACK, + bridges_highway_casing: BLACK, + bridges_other: CASING, + bridges_minor: WHITE, + bridges_link: MAJOR, + bridges_major: MAJOR, + bridges_highway: HIGHWAY, + + railway: BLACK, + boundaries: "#5b4b8a", + + waterway_label: WATER_NAME, + ocean_label: WATER_NAME, + peak_label: "#6b4423", + roads_label_minor: BLACK, + roads_label_minor_halo: WHITE, + roads_label_major: BLACK, + roads_label_major_halo: WHITE, + subplace_label: "#333333", + subplace_label_halo: WHITE, + city_label: "#000000", + city_label_halo: WHITE, + state_label: "#555555", + state_label_halo: WHITE, + country_label: "#555555", + address_label: "#444444", + address_label_halo: WHITE, + pois: { + blue: "#12648a", + green: "#17643a", + lapis: "#24449c", + pink: "#b02f85", + red: "#b5304f", + slategray: "#4b3f69", + tangerine: "#9a4e03", + turquoise: "#00808c", + }, + landcover: { + grassland: "rgba(228, 242, 216, 1)", + barren: "rgba(248, 241, 222, 1)", + urban_area: "rgba(240, 240, 240, 1)", + farmland: "rgba(234, 243, 216, 1)", + glacier: "rgba(238, 247, 253, 1)", + scrub: "rgba(229, 238, 208, 1)", + forest: "rgba(205, 232, 194, 1)", + }, +}; + +// What a color does not say of a layer of the printed map: how wide its line is, and how much of +// it is seen. {layer id: paint which is the layer's on paper}. +export const PRINT_PAINT = { + // A stream is half a pixel on a screen, and a river is the color of a lake. + water_stream: {"line-color": WATER_LINE, "line-width": 1.2}, + water_river: {"line-color": WATER_LINE}, + // A path is not drawn on a screen until the map is deeper than a quadrangle is drawn. + roads_other: {"line-width": 1.2, "line-dasharray": [4, 2]}, + roads_bridges_other: {"line-width": 1.2, "line-dasharray": [4, 2]}, + // A basemap draws a ramp on a bridge in the color of a minor road on one, not in a ramp's. + roads_bridges_link: {"line-color": MAJOR}, + roads_rail: {"line-opacity": 1}, + boundaries: {"line-width": 1.2}, + boundaries_country: {"line-width": 1.6}, + buildings: {"fill-opacity": 0.75}, +}; + +// The contour lines and their heights, which are not of a basemap: brown, and dark enough to follow. +export const PRINT_CONTOURS = { + minor: {"line-color": "rgba(140, 85, 35, 0.55)", "line-width": 0.6}, + major: {"line-color": "rgba(140, 85, 35, 0.9)", "line-width": 1.1}, + label: {"text-color": "rgba(110, 65, 25, 1)", "text-halo-color": "rgba(255, 255, 255, 0.9)"}, +}; + +const HEX_COLOR = /^#[0-9a-f]{6}$/i; + +function channels(hex) { + return [1, 3, 5].map(at => parseInt(hex.slice(at, at + 2), 16)); +} + +// A color part of the way (0 to 1) to another: `mix("#336699", "#ffffff", 0.4)` is paler. +export function mix(hex, toward, part) { + const to = channels(toward); + return "#" + channels(hex) + .map((value, index) => Math.round(value + (to[index] - value) * part).toString(16).padStart(2, "0")) + .join(""); +} + +const paler = (hex, part) => mix(hex, WHITE, part); +const darker = (hex, part) => mix(hex, "#000000", part); + +function rgba(hex, alpha) { + return `rgba(${channels(hex).join(", ")}, ${alpha})`; +} + +// The colors of the printed map which a person may choose, in the order they are offered. Each is +// of a group of the layer control (`group`), is called `label` there, and is `color` until another +// is chosen. A basemap has several colors where a person chooses one (a park and a wood are both +// what grows), so a chosen color says what the others are: +// colors(color): the colors of the basemap (see PRINT_COLORS) it stands for. +// paint(color): the paint of layers (see PRINT_PAINT) which is of that color. +// contours(color): the paint of the contour lines and their heights (see PRINT_CONTOURS). +// The edge of a road is not chosen: it is what makes a road a line on paper, and stays dark. +export const PRINT_SWATCHES = [ + { + id: "water", group: "Water", label: "Water", color: WATER, + colors: color => ({water: color, waterway_label: darker(color, 0.55), ocean_label: darker(color, 0.55)}), + // A line of water is darker than an area of it: a thin pale line is not seen. + paint: color => ({ + water_stream: {"line-color": darker(color, 0.4)}, + water_river: {"line-color": darker(color, 0.4)}, + }), + }, + { + id: "vegetation", group: "Land Cover", label: "Parks and woods", color: "#c2e2b0", + colors: color => ({ + park_a: paler(color, 0.4), park_b: color, + wood_a: paler(color, 0.25), wood_b: darker(color, 0.06), + scrub_a: paler(color, 0.5), scrub_b: paler(color, 0.2), + zoo: paler(color, 0.35), + }), + }, + { + id: "built", group: "Land Cover", label: "Schools, hospitals and industry", color: "#e6e4ec", + colors: color => ({ + hospital: color, school: color, industrial: color, military: color, + pedestrian: paler(color, 0.3), aerodrome: color, + }), + }, + { + id: "bare", group: "Land Cover", label: "Sand and ice", color: "#f4ecd2", + colors: color => ({sand: color, beach: color, glacier: paler(color, 0.5)}), + }, + { + id: "buildings", group: "Buildings", label: "Buildings", color: "#6e6e6e", + colors: color => ({buildings: color}), + }, + { + id: "highway", group: "Roads - Highway", label: "Highways", color: HIGHWAY, + colors: color => ({highway: color, bridges_highway: color}), + }, + { + id: "major", group: "Roads - Major", label: "Major roads", color: MAJOR, + colors: color => ({major: color, link: color, bridges_major: color}), + // A ramp on a bridge, which a basemap does not draw in a color of its own. + paint: color => ({roads_bridges_link: {"line-color": color}}), + }, + { + id: "minor", group: "Roads - Minor", label: "Minor roads", color: WHITE, + colors: color => ({minor_service: color, minor_a: color, minor_b: color, bridges_minor: color}), + }, + { + id: "rail", group: "Rail & Runways", label: "Railways", color: BLACK, + colors: color => ({railway: color}), + }, + { + id: "boundaries", group: "Boundaries", label: "Boundaries", color: "#5b4b8a", + colors: color => ({boundaries: color}), + }, + { + id: "contours", group: "Contours", label: "Contours", color: "#8c5523", + contours: color => ({ + minor: {"line-color": rgba(color, 0.55)}, + major: {"line-color": rgba(color, 0.9)}, + label: {"text-color": darker(color, 0.2)}, + }), + }, + { + id: "names", group: "Labels", label: "Names", color: BLACK, + colors: color => ({ + roads_label_minor: color, roads_label_major: color, city_label: color, subplace_label: color, + address_label: color, state_label: paler(color, 0.3), country_label: paler(color, 0.3), + }), + }, + { + id: "halo", group: "Labels", label: "Around names", color: WHITE, + colors: color => ({ + roads_label_minor_halo: color, roads_label_major_halo: color, city_label_halo: color, + subplace_label_halo: color, state_label_halo: color, address_label_halo: color, + }), + contours: color => ({label: {"text-halo-color": rgba(color, 0.9)}}), + }, +]; + +// What was chosen ({swatch id: "#rrggbb"}) with all that is not a choice left out: a color of no +// swatch, a color which is not one, and a color which is the swatch's own. +export function chosenColors(chosen) { + const colors = {}; + for (const {id, color} of PRINT_SWATCHES) { + const value = chosen?.[id]; + if (typeof value === "string" && HEX_COLOR.test(value) && value.toLowerCase() !== color.toLowerCase()) { + colors[id] = value.toLowerCase(); + } + } + return colors; +} + +// Each kind of thing a swatch says, with what was chosen over what the printed map has. +function withChosen(kind, picked, base) { + const result = {...base}; + const colors = chosenColors(picked); + for (const swatch of PRINT_SWATCHES) { + const color = colors[swatch.id]; + if (!color || !swatch[kind]) continue; + for (const [key, value] of Object.entries(swatch[kind](color))) { + result[key] = typeof value === "object" ? {...result[key], ...value} : value; + } + } + return result; +} + +// Every color of the printed map. colors: what a person chose ({swatch id: "#rrggbb"}). +export function printTheme(colors = {}) { + return withChosen("colors", colors, {...namedTheme("light"), ...PRINT_COLORS}); +} + +// The paint of the contour lines and their heights on the printed map. +export function printContours(colors = {}) { + return withChosen("contours", colors, PRINT_CONTOURS); +} + +// The layers of a basemap file (a source of the map's style) as they are printed. +export function printLayers(source, colors = {}, lang = undefined) { + const paints = withChosen("paint", colors, PRINT_PAINT); + return layersWithCustomTheme(source, printTheme(colors), lang).map(layer => { + const paint = paints[layer.id]; + return paint ? {...layer, paint: {...layer.paint, ...paint}} : layer; + }); +} + +// The colors a person chose for the printed map, in this browser. +export function savedPrintColors() { + try { + return chosenColors(JSON.parse(localStorage.getItem(STORAGE_KEY_COLORS))); + } catch (e) { + return {}; + } +} + +// Remember what was chosen; with nothing chosen, nothing is kept. +export function savePrintColors(colors) { + const kept = chosenColors(colors); + try { + if (Object.keys(kept).length) localStorage.setItem(STORAGE_KEY_COLORS, JSON.stringify(kept)); + else localStorage.removeItem(STORAGE_KEY_COLORS); + } catch (e) { /* ignore */ } + return kept; +} + +// The look a map was last exported in, in this browser: the printed map until another is chosen. +export function savedExportLook() { + try { + const saved = localStorage.getItem(STORAGE_KEY_LOOK); + if (EXPORT_LOOKS.some(look => look.value === saved)) return saved; + } catch (e) { /* ignore */ } + return PRINT_LOOK; +} + +export function saveExportLook(look) { + try { localStorage.setItem(STORAGE_KEY_LOOK, look); } catch (e) { /* ignore */ } +} + +// The flavor and the sprite of the map's style for a look: {flavor, sprite}. Nothing for no look, +// which is the map as the screen has it. +export function lookStyle(look) { + if (look === PRINT_LOOK) return {flavor: PRINT_LOOK, sprite: "light"}; + if (look === "light" || look === "dark") return {flavor: look, sprite: look}; + return {}; +} diff --git a/app/src/components/mapPrintStyle.test.js b/app/src/components/mapPrintStyle.test.js new file mode 100644 index 00000000..8b0ca202 --- /dev/null +++ b/app/src/components/mapPrintStyle.test.js @@ -0,0 +1,151 @@ +import layers, {namedTheme} from 'protomaps-themes-base'; +import { + chosenColors, EXPORT_LOOKS, lookStyle, mix, PRINT_COLORS, PRINT_CONTOURS, PRINT_LOOK, PRINT_PAINT, PRINT_SWATCHES, + printContours, printLayers, printTheme, savedExportLook, savedPrintColors, saveExportLook, savePrintColors, +} from './mapPrintStyle'; + +describe('the printed map', () => { + const printed = printLayers('a.pmtiles'); + const byId = Object.fromEntries(printed.map(layer => [layer.id, layer])); + + test('has every layer the light map has, of the same source', () => { + const light = layers('a.pmtiles', 'light'); + expect(printed.map(layer => layer.id)).toEqual(light.map(layer => layer.id)); + expect(new Set(printed.map(layer => layer.source).filter(Boolean))).toEqual(new Set(['a.pmtiles'])); + }); + + test('is drawn on white, in dark lines', () => { + expect(byId.background.paint['background-color']).toBe('#ffffff'); + expect(byId.earth.paint['fill-color']).toBe('#ffffff'); + // The edge of a road is what is seen of it on paper. + expect(byId.roads_minor_casing.paint['line-color']).toBe('#4d4d4d'); + expect(byId.roads_highway.paint['line-color']).toBe(PRINT_COLORS.highway); + expect(byId.roads_labels_minor.paint['text-color']).toBe('#1a1a1a'); + expect(byId.roads_labels_minor.paint['text-halo-color']).toBe('#ffffff'); + }); + + test('has lines which are wide enough to see', () => { + // A stream is not the color of a lake, nor half a pixel. + expect(byId.water_stream.paint['line-width']).toBeGreaterThan(1); + expect(byId.water_stream.paint['line-color']).not.toBe(byId.water.paint['fill-color']); + // A path is drawn however deep the map is, and is still a broken line. + expect(byId.roads_other.paint['line-width']).toBe(1.2); + expect(byId.roads_other.paint['line-dasharray']).toEqual([4, 2]); + expect(byId.roads_rail.paint['line-opacity']).toBe(1); + }); + + test('changes only layers a basemap has, and colors it has', () => { + for (const id of Object.keys(PRINT_PAINT)) expect(Object.keys(byId)).toContain(id); + const light = namedTheme('light'); + for (const color of Object.keys(PRINT_COLORS)) expect(Object.keys(light)).toContain(color); + expect(Object.keys(printTheme()).sort()).toEqual(Object.keys(light).sort()); + expect(Object.keys(PRINT_COLORS.pois).sort()).toEqual(Object.keys(light.pois).sort()); + expect(Object.keys(PRINT_COLORS.landcover).sort()).toEqual(Object.keys(light.landcover).sort()); + }); +}); + +describe('the look a map is exported in', () => { + beforeEach(() => localStorage.clear()); + + test('is the printed map until another is chosen, and is remembered', () => { + expect(savedExportLook()).toBe(PRINT_LOOK); + saveExportLook('dark'); + expect(savedExportLook()).toBe('dark'); + // What is not a look is not remembered as one. + localStorage.setItem('wrolpi-map-export-look', 'sepia'); + expect(savedExportLook()).toBe(PRINT_LOOK); + expect(EXPORT_LOOKS.map(look => look.value)).toEqual([PRINT_LOOK, 'light', 'dark']); + }); + + test('says how the map is drawn', () => { + // The printed map has the icons of the light one. + expect(lookStyle(PRINT_LOOK)).toEqual({flavor: PRINT_LOOK, sprite: 'light'}); + expect(lookStyle('light')).toEqual({flavor: 'light', sprite: 'light'}); + expect(lookStyle('dark')).toEqual({flavor: 'dark', sprite: 'dark'}); + // With no look chosen, the map is as the screen has it: nothing is said. + expect(lookStyle(null)).toEqual({}); + }); +}); + +describe('the colors a person chooses for the printed map', () => { + beforeEach(() => localStorage.clear()); + + test('each is a color the printed map has until another is chosen', () => { + const theme = printTheme(); + const paints = Object.fromEntries(printLayers('a.pmtiles').map(layer => [layer.id, layer.paint])); + for (const swatch of PRINT_SWATCHES) { + // Choosing the color it has changes nothing: what it stands for is what the map has. + const same = {[swatch.id]: swatch.color}; + expect(chosenColors(same)).toEqual({}); + // Every color and layer it speaks of is one a basemap has. + for (const key of Object.keys(swatch.colors?.(swatch.color) || {})) expect(Object.keys(theme)).toContain(key); + for (const id of Object.keys(swatch.paint?.(swatch.color) || {})) expect(Object.keys(paints)).toContain(id); + for (const key of Object.keys(swatch.contours?.(swatch.color) || {})) { + expect(Object.keys(PRINT_CONTOURS)).toContain(key); + } + } + // No two have one name, and none speaks of a color another does. + expect(new Set(PRINT_SWATCHES.map(swatch => swatch.id)).size).toBe(PRINT_SWATCHES.length); + const spoken = PRINT_SWATCHES.flatMap(swatch => Object.keys(swatch.colors?.(swatch.color) || {})); + expect(new Set(spoken).size).toBe(spoken.length); + }); + + test('a chosen color is the color of all it stands for', () => { + const byId = Object.fromEntries( + printLayers('a.pmtiles', {water: '#ff00ff', minor: '#00ff00'}).map(layer => [layer.id, layer])); + expect(byId.water.paint['fill-color']).toBe('#ff00ff'); + // A line of water is darker than an area of it, and as wide as the printed map has it. + expect(byId.water_stream.paint['line-color']).toBe(mix('#ff00ff', '#000000', 0.4)); + expect(byId.water_stream.paint['line-width']).toBe(PRINT_PAINT.water_stream['line-width']); + expect(JSON.stringify(byId.roads_minor.paint['line-color'])).toContain('#00ff00'); + // The edge of a road is not chosen. + expect(byId.roads_bridges_link.paint['line-color']).toBe(PRINT_COLORS.major); + expect(byId.roads_minor_casing.paint['line-color']).toBe('#4d4d4d'); + // What was not chosen is as it was. + expect(byId.roads_highway.paint['line-color']).toBe(PRINT_COLORS.highway); + }); + + test('a ramp is the color of a major road, on a bridge as off one', () => { + const ramps = colors => { + const byId = Object.fromEntries(printLayers('a.pmtiles', colors).map(layer => [layer.id, layer])); + return [byId.roads_link.paint['line-color'], byId.roads_bridges_link.paint['line-color']]; + }; + expect(ramps({})).toEqual([PRINT_COLORS.major, PRINT_COLORS.major]); + expect(ramps({major: '#123456'})).toEqual(['#123456', '#123456']); + // The color of a minor road is not a ramp's. + expect(ramps({minor: '#00ff00'})).toEqual([PRINT_COLORS.major, PRINT_COLORS.major]); + }); + + test('several colors of a basemap are shades of the one chosen', () => { + const theme = printTheme({vegetation: '#008000'}); + expect(theme.park_b).toBe('#008000'); + expect(theme.park_a).toBe(mix('#008000', '#ffffff', 0.4)); + expect(theme.wood_b).not.toBe(theme.park_b); + expect(mix('#000000', '#ffffff', 0.5)).toBe('#808080'); + }); + + test('contours are the color chosen for them, and their heights have the halo of names', () => { + expect(printContours()).toEqual(PRINT_CONTOURS); + const contours = printContours({contours: '#102030', halo: '#fffacd'}); + expect(contours.minor).toEqual({'line-color': 'rgba(16, 32, 48, 0.55)', 'line-width': 0.6}); + expect(contours.major['line-color']).toBe('rgba(16, 32, 48, 0.9)'); + expect(contours.label['text-halo-color']).toBe('rgba(255, 250, 205, 0.9)'); + }); + + test('what is not a choice is not kept', () => { + expect(chosenColors({water: '#FF00FF', sky: '#0000ff', minor: 'green', highway: 7, major: '#fff'})) + .toEqual({water: '#ff00ff'}); + expect(chosenColors(null)).toEqual({}); + }); + + test('are remembered in the browser, and forgotten when there are none', () => { + expect(savedPrintColors()).toEqual({}); + expect(savePrintColors({water: '#ff00ff', sky: '#0000ff'})).toEqual({water: '#ff00ff'}); + expect(savedPrintColors()).toEqual({water: '#ff00ff'}); + savePrintColors({}); + expect(localStorage.getItem('wrolpi-map-print-colors')).toBeNull(); + // What was kept is not what this keeps. + localStorage.setItem('wrolpi-map-print-colors', 'not JSON'); + expect(savedPrintColors()).toEqual({}); + }); +}); diff --git a/app/src/components/mapQuads.js b/app/src/components/mapQuads.js new file mode 100644 index 00000000..43fba0cf --- /dev/null +++ b/app/src/components/mapQuads.js @@ -0,0 +1,128 @@ +// The areas a map can be exported by: the 7.5-minute quadrangles of a 1:24,000 topographic map. +// +// A quadrangle is 7.5 minutes of latitude by 7.5 minutes of longitude, its edges on whole multiples +// of that. The grid is arithmetic, so it needs no data and covers the whole world. + +export const QUAD_DEGREES = 0.125; +export const QUAD_SCALE = 24000; +// The grid is not drawn below this zoom: its cells would be too small to choose between. +export const QUAD_MIN_ZOOM = 8; + +const QUADS_PER_DEGREE = 1 / QUAD_DEGREES; +// Web Mercator draws no further north or south than this. +const MAX_LATITUDE = 85; +const MAX_GRID_LINES = 400; + +function wrapLongitude(lng) { + return ((lng + 180) % 360 + 360) % 360 - 180; +} + +function quadOf(row, col) { + return { + id: `${row}:${col}`, + row, + col, + west: col * QUAD_DEGREES, + south: row * QUAD_DEGREES, + east: (col + 1) * QUAD_DEGREES, + north: (row + 1) * QUAD_DEGREES, + }; +} + +// The quadrangle a point is in, or null where there is none (off the map, or not a place). +export function quadAt(lng, lat) { + if (!Number.isFinite(lng) || !Number.isFinite(lat) || Math.abs(lat) >= MAX_LATITUDE) return null; + return quadOf(Math.floor(lat * QUADS_PER_DEGREE), Math.floor(wrapLongitude(lng) * QUADS_PER_DEGREE)); +} + +// The outline of a quadrangle, as GeoJSON. +export function quadPolygon(quad) { + const {west, south, east, north} = quad; + return { + type: "Feature", + properties: {id: quad.id}, + geometry: { + type: "Polygon", + coordinates: [[[west, south], [east, south], [east, north], [west, north], [west, south]]], + }, + }; +} + +export const EMPTY_FEATURES = {type: "FeatureCollection", features: []}; + +// The lines of the grid across `bounds` ({west, south, east, north}, as the map gives them; east may +// be past 180), as GeoJSON. Null when there would be too many lines to be of use. +export function quadGridLines(bounds) { + const south = Math.max(bounds.south, -MAX_LATITUDE); + const north = Math.min(bounds.north, MAX_LATITUDE); + const firstRow = Math.floor(south * QUADS_PER_DEGREE); + const lastRow = Math.ceil(north * QUADS_PER_DEGREE); + const firstCol = Math.floor(bounds.west * QUADS_PER_DEGREE); + const lastCol = Math.ceil(bounds.east * QUADS_PER_DEGREE); + if (!(lastRow > firstRow) || !(lastCol > firstCol)) return EMPTY_FEATURES; + if ((lastRow - firstRow) + (lastCol - firstCol) > MAX_GRID_LINES) return null; + + const [west, east] = [firstCol * QUAD_DEGREES, lastCol * QUAD_DEGREES]; + const [bottom, top] = [firstRow * QUAD_DEGREES, lastRow * QUAD_DEGREES]; + const lines = []; + for (let row = firstRow; row <= lastRow; row++) { + lines.push([[west, row * QUAD_DEGREES], [east, row * QUAD_DEGREES]]); + } + for (let col = firstCol; col <= lastCol; col++) { + lines.push([[col * QUAD_DEGREES, bottom], [col * QUAD_DEGREES, top]]); + } + return { + type: "FeatureCollection", + features: [{type: "Feature", properties: {}, geometry: {type: "MultiLineString", coordinates: lines}}], + }; +} + +// 37.875 -> 37°52′30″ +function degreesMinutesSeconds(value) { + const seconds = Math.round(Math.abs(value) * 3600); + const d = Math.floor(seconds / 3600); + const m = Math.floor((seconds % 3600) / 60); + const s = seconds % 60; + const pad = n => String(n).padStart(2, "0"); + return s ? `${d}°${pad(m)}′${pad(s)}″` : `${d}°${pad(m)}′`; +} + +export function formatLatitude(lat) { + return `${degreesMinutesSeconds(lat)}${lat < 0 ? "S" : "N"}`; +} + +export function formatLongitude(lng) { + return `${degreesMinutesSeconds(lng)}${lng < 0 ? "W" : "E"}`; +} + +// What to call a quadrangle: where its southwest corner is. +export function quadLabel(quad) { + return `${formatLatitude(quad.south)} ${formatLongitude(quad.west)}`; +} + +// What the USGS calls a quadrangle, from what the API says of it ({name, state, exact}): "Berthoud, +// Colorado". A quadrangle of the grid which is not all of the named one (they are wider in +// Alaska) is a part of it. +export function quadTitle(named) { + if (!named?.name) return null; + const title = named.state ? `${named.name}, ${named.state}` : named.name; + return named.exact === false ? `Part of ${title}` : title; +} + +// How far it is across and up a quadrangle on the ground (meters, along its middle), and on a sheet +// printed at 1:24,000 (millimeters). +export function quadSize(quad) { + const latitude = (quad.south + quad.north) / 2 * Math.PI / 180; + // The length of a degree on the WGS84 ellipsoid. + const metersPerDegreeLatitude = 111132.92 - 559.82 * Math.cos(2 * latitude) + 1.175 * Math.cos(4 * latitude); + const metersPerDegreeLongitude = 111412.84 * Math.cos(latitude) - 93.5 * Math.cos(3 * latitude) + + 0.118 * Math.cos(5 * latitude); + const widthMeters = metersPerDegreeLongitude * QUAD_DEGREES; + const heightMeters = metersPerDegreeLatitude * QUAD_DEGREES; + return { + widthMeters, + heightMeters, + sheetWidthMm: widthMeters * 1000 / QUAD_SCALE, + sheetHeightMm: heightMeters * 1000 / QUAD_SCALE, + }; +} diff --git a/app/src/components/mapQuads.test.js b/app/src/components/mapQuads.test.js new file mode 100644 index 00000000..3bf461f1 --- /dev/null +++ b/app/src/components/mapQuads.test.js @@ -0,0 +1,111 @@ +import { + EMPTY_FEATURES, + formatLatitude, + formatLongitude, + quadAt, + quadGridLines, + quadLabel, + quadPolygon, + quadSize, +} from './mapQuads'; + +describe('the quadrangle a point is in', () => { + test('has its edges on whole multiples of 7.5 minutes', () => { + expect(quadAt(-105.0595, 40.31)).toEqual({ + id: '322:-841', row: 322, col: -841, west: -105.125, south: 40.25, east: -105, north: 40.375, + }); + // South and east of the origin. + expect(quadAt(151.21, -33.87)).toMatchObject({west: 151.125, south: -33.875, east: 151.25, north: -33.75}); + }); + + test('a point on an edge belongs to the quadrangle north and east of it', () => { + expect(quadAt(-105.125, 40.25)).toMatchObject({west: -105.125, south: 40.25}); + expect(quadAt(-105.1250001, 40.2499999)).toMatchObject({west: -105.25, south: 40.125}); + }); + + test('is the same wherever around the world the map has been dragged to', () => { + expect(quadAt(-105.0595 + 360, 40.31)).toEqual(quadAt(-105.0595, 40.31)); + expect(quadAt(-105.0595 - 720, 40.31)).toEqual(quadAt(-105.0595, 40.31)); + expect(quadAt(180, 0)).toMatchObject({west: -180, east: -179.875}); + }); + + test('is nothing off the map', () => { + expect(quadAt(0, 86)).toBeNull(); + expect(quadAt(0, -85)).toBeNull(); + expect(quadAt(NaN, 0)).toBeNull(); + expect(quadAt(0, undefined)).toBeNull(); + }); + + test('has an outline which closes', () => { + const ring = quadPolygon(quadAt(-105.0595, 40.31)).geometry.coordinates[0]; + expect(ring).toEqual([[-105.125, 40.25], [-105, 40.25], [-105, 40.375], [-105.125, 40.375], [-105.125, 40.25]]); + }); +}); + +describe('the grid across the map', () => { + const lines = bounds => quadGridLines(bounds).features[0].geometry.coordinates; + + test('covers the view, out to the edges of the quadrangles it shows part of', () => { + const grid = lines({west: -105.175, south: 40.26, east: -104.925, north: 40.4}); + // Parallels at 40.25, 40.375, 40.5; meridians at -105.25, -105.125, -105, -104.875. + expect(grid).toHaveLength(7); + expect(grid.slice(0, 3)).toEqual([ + [[-105.25, 40.25], [-104.875, 40.25]], + [[-105.25, 40.375], [-104.875, 40.375]], + [[-105.25, 40.5], [-104.875, 40.5]], + ]); + expect(grid[3]).toEqual([[-105.25, 40.25], [-105.25, 40.5]]); + expect(grid[6]).toEqual([[-104.875, 40.25], [-104.875, 40.5]]); + }); + + test('is not made when the view is of too many quadrangles', () => { + expect(quadGridLines({west: -125, south: 25, east: -66, north: 50})).toBeNull(); + }); + + test('stops where the map does', () => { + const grid = lines({west: 0, south: 84.9, east: 0.1, north: 89}); + expect(Math.max(...grid.flat().map(point => point[1]))).toBe(85); + }); + + test('is empty for a view of nothing', () => { + expect(quadGridLines({west: 0, south: 88, east: 1, north: 89})).toBe(EMPTY_FEATURES); + }); +}); + +describe('what a quadrangle is called', () => { + test('is where its southwest corner is', () => { + expect(quadLabel(quadAt(-105.0595, 40.31))).toBe('40°15′N 105°07′30″W'); + expect(quadLabel(quadAt(-104.925, 40.4))).toBe('40°22′30″N 105°00′W'); + expect(quadLabel(quadAt(151.21, -33.87))).toBe('33°52′30″S 151°07′30″E'); + }); + + test('a coordinate is written in degrees, minutes and seconds', () => { + expect(formatLatitude(0)).toBe('0°00′N'); + expect(formatLatitude(-0.125)).toBe('0°07′30″S'); + expect(formatLongitude(-179.875)).toBe('179°52′30″W'); + }); +}); + +describe('the size of a quadrangle', () => { + test('is narrower further from the equator, and about as tall everywhere', () => { + const equator = quadSize(quadAt(0, 0)); + const colorado = quadSize(quadAt(-105.0595, 40.31)); + const alaska = quadSize(quadAt(-150, 64.8)); + expect(equator.widthMeters).toBeGreaterThan(colorado.widthMeters); + expect(colorado.widthMeters).toBeGreaterThan(alaska.widthMeters); + for (const size of [equator, colorado, alaska]) { + expect(size.heightMeters).toBeGreaterThan(13800); + expect(size.heightMeters).toBeLessThan(14000); + } + }); + + test('is that of a 1:24,000 sheet', () => { + // A quadrangle at 40 degrees north is about 10.6 km by 13.9 km: about 17.4 by 22.8 inches of paper. + const {widthMeters, heightMeters, sheetWidthMm, sheetHeightMm} = quadSize(quadAt(-105.0595, 40.31)); + expect(widthMeters / 1000).toBeCloseTo(10.62, 1); + expect(heightMeters / 1000).toBeCloseTo(13.88, 1); + expect(sheetWidthMm / 25.4).toBeCloseTo(17.4, 0); + expect(sheetHeightMm / 25.4).toBeCloseTo(22.8, 0); + expect(sheetWidthMm).toBeCloseTo(widthMeters / 24, 6); + }); +}); diff --git a/app/src/components/mapTiles.js b/app/src/components/mapTiles.js new file mode 100644 index 00000000..7e3addf1 --- /dev/null +++ b/app/src/components/mapTiles.js @@ -0,0 +1,29 @@ +// Reading the tiles of a map file, as the map does not: one at a time, for what is in them. + +import {PMTiles} from "pmtiles"; +import {VectorTile} from "@mapbox/vector-tile"; +import Pbf from "pbf"; + +const PROTOCOL = "pmtiles://"; +const archives = new Map(); + +function archive(url) { + const address = url.startsWith(PROTOCOL) ? url.slice(PROTOCOL.length) : url; + if (!archives.has(address)) archives.set(address, new PMTiles(address)); + return archives.get(address); +} + +// A tile of the vector map file which a source of the map's style has as its `url`, or null when +// the file has no such tile (it is not of that place, or does not go that deep). +export async function readVectorTile(url, {z, x, y}) { + const tile = await archive(url).getZxy(z, x, y); + return tile?.data ? new VectorTile(new Pbf(new Uint8Array(tile.data))) : null; +} + +// The west, south, east and north edges (degrees) of what a map file is of, as the file says; null +// when it does not say. +export async function readTileBounds(url) { + const {minLon, minLat, maxLon, maxLat} = await archive(url).getHeader(); + const edges = [minLon, minLat, maxLon, maxLat]; + return edges.every(Number.isFinite) && minLon < maxLon && minLat < maxLat ? edges : null; +} diff --git a/app/src/components/mapTiles.test.js b/app/src/components/mapTiles.test.js new file mode 100644 index 00000000..fb863f2d --- /dev/null +++ b/app/src/components/mapTiles.test.js @@ -0,0 +1,51 @@ +import {readTileBounds, readVectorTile} from './mapTiles'; + +const mockOpened = []; +const mockTiles = {}; +const mockHeaders = {}; + +jest.mock('pmtiles', () => ({ + PMTiles: class { + constructor(address) { + this.address = address; + mockOpened.push(address); + } + + async getHeader() { + return mockHeaders[this.address] || {}; + } + + async getZxy(z, x, y) { + return mockTiles[`${this.address} ${z}/${x}/${y}`]; + } + }, +})); + +describe('reading a tile of a map file', () => { + test('is of the file a source of the map has as its URL, which is opened once', async () => { + // A tile with nothing in it. + mockTiles['https://example.com/a.pmtiles 14/3/5'] = {data: new ArrayBuffer(0)}; + const tile = await readVectorTile('pmtiles://https://example.com/a.pmtiles', {z: 14, x: 3, y: 5}); + expect(tile.layers).toEqual({}); + await readVectorTile('pmtiles://https://example.com/a.pmtiles', {z: 14, x: 3, y: 6}); + expect(mockOpened).toEqual(['https://example.com/a.pmtiles']); + }); + + test('is nothing when the file has no such tile', async () => { + expect(await readVectorTile('pmtiles:///media/b.pmtiles', {z: 14, x: 0, y: 0})).toBeNull(); + expect(mockOpened).toContain('/media/b.pmtiles'); + }); +}); + +describe('the edges of a map file', () => { + test('are what the file says: west, south, east and north', async () => { + mockHeaders['/media/c.pmtiles'] = {minLon: -150, minLat: 61, maxLon: -149, maxLat: 62, maxZoom: 15}; + expect(await readTileBounds('pmtiles:///media/c.pmtiles')).toEqual([-150, 61, -149, 62]); + }); + + test('are not known when the file does not say', async () => { + mockHeaders['/media/d.pmtiles'] = {minLon: 0, minLat: 0, maxLon: 0, maxLat: 0}; + expect(await readTileBounds('pmtiles:///media/d.pmtiles')).toBeNull(); + expect(await readTileBounds('pmtiles:///media/e.pmtiles')).toBeNull(); + }); +}); diff --git a/app/src/map-shared/map-shared.test.js b/app/src/map-shared/map-shared.test.js index 2ef4e845..3ccd79c0 100644 --- a/app/src/map-shared/map-shared.test.js +++ b/app/src/map-shared/map-shared.test.js @@ -2,15 +2,17 @@ const fs = require('fs'); const path = require('path'); // The standalone map viewer (modules/map/static/index.html) has no build step: it loads copies of -// the shared overlay modules as they are. The copies must be the modules. +// the shared map modules as they are. The copies must be the modules. const SHARED = __dirname; const COPIES = path.join(__dirname, '../../../modules/map/static/js'); const MODULES = fs.readdirSync(SHARED).filter(name => name.endsWith('.js') && !name.endsWith('.test.js')); describe('the shared map modules', () => { - test('are the two the standalone viewer loads', () => { - expect(MODULES.sort()).toEqual(['overlayStyle.js', 'overlays.js']); + test('are those the standalone viewer loads', () => { + expect(MODULES.sort()).toEqual(['overlayStyle.js', 'overlays.js', 'terrain.js']); + const viewer = fs.readFileSync(path.join(COPIES, '../index.html'), 'utf8'); + for (const name of MODULES) expect(viewer).toContain(`import("/js/${name}")`); }); test.each(MODULES)('%s is copied to the standalone viewer as it is (run `npm run sync:map-shared`)', (name) => { diff --git a/app/src/map-shared/overlays.js b/app/src/map-shared/overlays.js index 05b47006..640a740d 100644 --- a/app/src/map-shared/overlays.js +++ b/app/src/map-shared/overlays.js @@ -252,10 +252,17 @@ export function buildOverlayLayers(file, state) { return styleLayers; } -// The style layers of every overlay, in the order they are drawn. A raster overlay goes under the -// basemap's labels (`rasters`) so the map stays readable; vector overlays go on top (`vectors`): an -// overlay with its own style in that style's order, then the generic ones, fills under lines under -// points. +// Whether a layer of an overlay is of its labels: its text, its icons, and the points it marks. The +// rest of an overlay is its ground: areas, lines, pictures. +export function isOverlayLabelLayer(layer) { + return layer?.type === "symbol" || layer?.type === "circle"; +} + +// The style layers of every overlay, in the order they are drawn. Labels are always on top: the +// ground of every overlay goes under the basemap's labels (`under`), so an area an overlay fills +// does not cover the name of what is in it, and the labels of every overlay go over them (`over`). +// In each, a raster is lowest, then an overlay with its own style in that style's order, then the +// generic ones, fills under lines under points. export function orderOverlayLayers(overlays, state) { const rasters = []; const styled = []; @@ -271,7 +278,49 @@ export function orderOverlayLayers(overlays, state) { else generic[layer.type].push(layer); } } - return {rasters, vectors: [...styled, ...generic.fill, ...generic.line, ...generic.circle]}; + const vectors = [...styled, ...generic.fill, ...generic.line, ...generic.circle]; + return { + under: [...rasters, ...vectors.filter(layer => !isOverlayLabelLayer(layer))], + over: vectors.filter(isOverlayLabelLayer), + }; +} + +// The layers of a basemap with every label over all of its ground: the ground in the order it was +// in, then the labels in the order they were in. +// +// A map of several basemap files is their layers one file after another, so the labels of each file +// but the last are under the land, the water and the roads of the files after it, and under +// anything which is put under "the labels". Labels are always on top. +export function labelsOverGround(layers) { + layers = layers || []; + return [...layers.filter(l => l.type !== "symbol"), ...layers.filter(l => l.type === "symbol")]; +} + +// The source of the contour lines both viewers draw from the terrain. They are added to a style +// after the basemap's labels, lines and labels both, and are not of the basemap. +const CONTOUR_SOURCE = "contours"; + +// Where the basemap's labels begin: the index of the first of the labels which are over all of the +// basemap's ground. Where no label is over its ground, the index after the last of its ground. +// +// Not the map's first label: a map of several basemap files has the labels of the first file under +// the ground of the next, and an overlay put there would be under the land and the water of every +// file after the first. Nor before the last layer which is not a label: the contour lines are +// drawn after the basemap's labels, and an overlay put under them would be over every label. +export function basemapLabelsStart(layers) { + layers = layers || []; + const ofBasemap = layer => !isOverlayLayerId(layer.id) && layer.source !== CONTOUR_SOURCE; + let lastGround = -1; + for (let i = layers.length - 1; i >= 0; i--) { + if (ofBasemap(layers[i]) && layers[i].type !== "symbol") { + lastGround = i; + break; + } + } + for (let i = lastGround + 1; i < layers.length; i++) { + if (ofBasemap(layers[i]) && layers[i].type === "symbol") return i; + } + return lastGround + 1; } // Add the overlays to a style's sources and layers (the basemap's are already there). @@ -279,10 +328,9 @@ export function addOverlaysToStyle(styleSources, allLayers, overlays, state, url for (const file of overlays || []) { styleSources[overlaySourceId(file)] = buildOverlaySource(file, urls); } - const {rasters, vectors} = orderOverlayLayers(overlays, state); - const firstLabel = allLayers.findIndex(l => l.type === "symbol"); - allLayers.splice(firstLabel === -1 ? allLayers.length : firstLabel, 0, ...rasters); - allLayers.push(...vectors); + const {under, over} = orderOverlayLayers(overlays, state); + allLayers.splice(basemapLabelsStart(allLayers), 0, ...under); + allLayers.push(...over); } // Add the overlays to a map whose style has loaded, a layer at a time. For a viewer which cannot @@ -295,8 +343,9 @@ export function addOverlaysToMap(map, overlays, state, urls) { const id = overlaySourceId(file); if (!map.getSource(id)) map.addSource(id, buildOverlaySource(file, urls)); } - const firstLabel = (map.getStyle()?.layers || []).find(l => l.type === "symbol"); - const {rasters, vectors} = orderOverlayLayers(overlays, state); + const mapLayers = map.getStyle()?.layers || []; + const firstLabel = mapLayers[basemapLabelsStart(mapLayers)]; + const {under, over} = orderOverlayLayers(overlays, state); const add = (layer, before) => { if (map.getLayer(layer.id)) return; try { @@ -307,8 +356,8 @@ export function addOverlaysToMap(map, overlays, state, urls) { refused[mapPath] = (refused[mapPath] || 0) + 1; } }; - for (const layer of rasters) add(layer, firstLabel?.id); - for (const layer of vectors) add(layer, undefined); + for (const layer of under) add(layer, firstLabel?.id); + for (const layer of over) add(layer, undefined); return refused; } diff --git a/app/src/map-shared/terrain.js b/app/src/map-shared/terrain.js new file mode 100644 index 00000000..8cdc3715 --- /dev/null +++ b/app/src/map-shared/terrain.js @@ -0,0 +1,59 @@ +// How the map reads a terrain (elevation) file: how deep into it to look, and how far apart the +// contour lines are. Shared by the app's map viewer and the standalone viewer, which loads a copy +// of this file as it is: no imports from the app, no dependencies. + +// How deep the terrain file which WROLPi offers goes, and what a file is taken to be when it does +// not say. +export const DEFAULT_TERRAIN_MAX_ZOOM = 8; +// No terrain file is read deeper than this. +const DEEPEST_TERRAIN_ZOOM = 15; + +// How far apart the contour lines are at each zoom of the map: [minor, major], in the unit the map +// measures in. A zoom between two of these uses the one below it. +// +// A 1:24,000 sheet has a line every 40 feet (or 20 meters), which is what the deepest have: finer +// lines than that are more than the terrain says, and more than a hillside has room for. +const CONTOUR_FEET = { + 4: [1000, 5000], 5: [500, 2500], 6: [200, 1000], 7: [200, 1000], 8: [100, 500], + 9: [100, 500], 10: [100, 500], 11: [40, 200], 12: [40, 200], +}; +const CONTOUR_METERS = { + 4: [500, 2500], 5: [200, 1000], 6: [100, 500], 7: [100, 500], 8: [50, 200], + 9: [50, 200], 10: [50, 200], 11: [20, 100], 12: [20, 100], +}; + +// How deep a terrain file goes: the deepest zoom it has tiles of. `file` is as the API lists it. +export function terrainMaxZoom(file) { + const zoom = Number(file && file.max_zoom); + if (!Number.isInteger(zoom) || zoom < 1) return DEFAULT_TERRAIN_MAX_ZOOM; + return Math.min(zoom, DEEPEST_TERRAIN_ZOOM); +} + +// The contour intervals for a terrain file which goes as deep as `maxZoom`. +// +// Only those the file can bear: lines 40 feet apart drawn from terrain too coarse for them are +// drawn where no line is. A map zoomed in past the file's depth keeps the file's finest interval. +export function contourThresholds(imperial, maxZoom) { + const all = imperial ? CONTOUR_FEET : CONTOUR_METERS; + const deepest = Number.isFinite(maxZoom) ? maxZoom : DEFAULT_TERRAIN_MAX_ZOOM; + const lowest = Math.min(...Object.keys(all).map(Number)); + const thresholds = {}; + for (const [zoom, intervals] of Object.entries(all)) { + // A file shallower than every interval still has contours: the coarsest. + if (Number(zoom) <= deepest || Number(zoom) === lowest) thresholds[zoom] = intervals; + } + return thresholds; +} + +// How far apart the contour lines are on a map drawn at `zoom` from a terrain file which goes as +// deep as `maxZoom`: [minor, major], or null when no line is drawn at that zoom. +// +// The lines of a map are made a tile at a time: for tiles of the map's zoom, or of the file's +// deepest when the map is zoomed in past it, with the interval of the nearest zoom below. +export function contourInterval(imperial, maxZoom, zoom) { + const thresholds = contourThresholds(imperial, maxZoom); + const deepest = Number.isFinite(maxZoom) ? maxZoom : DEFAULT_TERRAIN_MAX_ZOOM; + const tileZoom = Math.min(Math.floor(zoom), deepest); + const zooms = Object.keys(thresholds).map(Number).filter(i => i <= tileZoom); + return zooms.length ? thresholds[Math.max(...zooms)] : null; +} diff --git a/app/src/map-shared/terrain.test.js b/app/src/map-shared/terrain.test.js new file mode 100644 index 00000000..fdb23502 --- /dev/null +++ b/app/src/map-shared/terrain.test.js @@ -0,0 +1,96 @@ +import {contourInterval, contourThresholds, DEFAULT_TERRAIN_MAX_ZOOM, terrainMaxZoom} from './terrain.js'; + +describe('how deep a terrain file is read', () => { + test('as deep as the file goes', () => { + expect(terrainMaxZoom({max_zoom: 8})).toBe(8); + expect(terrainMaxZoom({max_zoom: 12})).toBe(12); + expect(terrainMaxZoom({max_zoom: 5})).toBe(5); + }); + + test('as the terrain WROLPi offers, when the file does not say', () => { + expect(DEFAULT_TERRAIN_MAX_ZOOM).toBe(8); + const unsaid = [undefined, null, {}, {max_zoom: null}, {max_zoom: 'deep'}, {max_zoom: 0}, {max_zoom: 9.5}]; + for (const file of unsaid) { + expect(terrainMaxZoom(file)).toBe(8); + } + }); + + test('and no deeper than a map goes', () => { + expect(terrainMaxZoom({max_zoom: 22})).toBe(15); + }); +}); + +describe('how far apart the contour lines are', () => { + test('are as they have always been for the terrain WROLPi offers', () => { + expect(contourThresholds(true, 8)).toEqual({ + 4: [1000, 5000], 5: [500, 2500], 6: [200, 1000], 7: [200, 1000], 8: [100, 500], + }); + expect(contourThresholds(false, 8)).toEqual({ + 4: [500, 2500], 5: [200, 1000], 6: [100, 500], 7: [100, 500], 8: [50, 200], + }); + // And when it is not said how deep the file is. + expect(contourThresholds(true)).toEqual(contourThresholds(true, 8)); + expect(contourThresholds(false, undefined)).toEqual(contourThresholds(false, 8)); + }); + + test('are finer for a file which goes deeper: 40 feet, or 20 meters, as a 1:24,000 sheet has', () => { + const feet = contourThresholds(true, 12); + expect(feet[12]).toEqual([40, 200]); + expect(feet[11]).toEqual([40, 200]); + expect(feet[10]).toEqual([100, 500]); + expect(contourThresholds(false, 12)[12]).toEqual([20, 100]); + // What was there for a shallower file is unchanged. + expect(feet).toMatchObject(contourThresholds(true, 8)); + }); + + test('are no finer than the file can bear', () => { + expect(Object.keys(contourThresholds(true, 10)).map(Number)).toEqual([4, 5, 6, 7, 8, 9, 10]); + // A file deeper than any interval keeps the finest. + expect(contourThresholds(true, 15)).toEqual(contourThresholds(true, 12)); + // A file shallower than every interval still has contours. + expect(contourThresholds(true, 2)).toEqual({4: [1000, 5000]}); + expect(contourThresholds(false, 4)).toEqual({4: [500, 2500]}); + }); + + test('never have a minor line which is not a part of a major one', () => { + for (const imperial of [true, false]) { + for (const [minor, major] of Object.values(contourThresholds(imperial, 15))) { + expect(major % minor).toBe(0); + expect(major).toBeGreaterThan(minor); + } + } + }); +}); + +describe('how far apart the contour lines of a map at one zoom are', () => { + test('is the interval of the tiles the lines are made for', () => { + // A sheet is drawn at about zoom 13, from a file which goes to 12: tiles of zoom 12. + expect(contourInterval(true, 12, 13.2)).toEqual([40, 200]); + expect(contourInterval(false, 12, 13.2)).toEqual([20, 100]); + // The file which WROLPi offers goes to zoom 8, whatever the map is zoomed to. + expect(contourInterval(true, 8, 13.2)).toEqual([100, 500]); + expect(contourInterval(false, DEFAULT_TERRAIN_MAX_ZOOM, 14.9)).toEqual([50, 200]); + // A file deeper than the finest interval has the finest. + expect(contourInterval(true, 15, 14.2)).toEqual([40, 200]); + // A map zoomed out has the interval of its zoom. + expect(contourInterval(true, 12, 6.9)).toEqual([200, 1000]); + expect(contourInterval(true, 12, 10.99)).toEqual([100, 500]); + expect(contourInterval(true, 12, 11)).toEqual([40, 200]); + }); + + test('is the same as the lines which are drawn: the interval of the nearest zoom below', () => { + for (const [maxZoom, zoom] of [[8, 13.2], [12, 13.2], [12, 9.5], [3, 13], [undefined, 13]]) { + const thresholds = contourThresholds(true, maxZoom); + const tile = Math.min(Math.floor(zoom), maxZoom ?? DEFAULT_TERRAIN_MAX_ZOOM); + const below = Math.max(...Object.keys(thresholds).map(Number).filter(i => i <= tile)); + expect(contourInterval(true, maxZoom, zoom)).toEqual(thresholds[below] ?? null); + } + }); + + test('is nothing where no line is drawn', () => { + expect(contourInterval(true, 12, 3.9)).toBeNull(); + expect(contourInterval(false, 8, 0)).toBeNull(); + // A file shallower than every interval has lines only from the zoom of the coarsest. + expect(contourInterval(true, 3, 13)).toBeNull(); + }); +}); diff --git a/docker/help/wrolpi-help b/docker/help/wrolpi-help index deda0b7c..349a8018 160000 --- a/docker/help/wrolpi-help +++ b/docker/help/wrolpi-help @@ -1 +1 @@ -Subproject commit deda0b7ce7640835016b73512ee0c88e9f7f2059 +Subproject commit 349a8018130aaa743ebcd7447ac6fb961226f11a diff --git a/modules/map/api.py b/modules/map/api.py index 44a549ca..8db720d0 100644 --- a/modules/map/api.py +++ b/modules/map/api.py @@ -1,11 +1,13 @@ +import asyncio from http import HTTPStatus from sanic import Request, response, Blueprint from sanic_ext import validate from sanic_ext.extensions.openapi import openapi -from modules.map import lib, schema, search +from modules.map import export, export_job, lib, quads, schema, search from modules.map.pins import get_map_pins_config +from modules.map.sheet import legend_as_sent from wrolpi.api_utils import json_response from wrolpi.common import wrol_mode_check from wrolpi.events import Events @@ -175,3 +177,144 @@ async def rebuild_single_search_index(_: Request, filename: str): if started: return json_response({'message': f'Search index rebuild started for {filename}'}, HTTPStatus.ACCEPTED) return json_response({'error': 'File not found'}, HTTPStatus.NOT_FOUND) + + +@map_bp.get('/quad') +@openapi.description('The name of the USGS quadrangle of an area of the map') +async def get_quad(request: Request): + """What the USGS calls the quadrangle between `west`, `south`, `east` and `north` (degrees): `quad` is its + `name`, its `state`, and whether it is `exact`ly that area (and not a larger quadrangle which has the middle + of it); or null where there is no name, which is most of the world.""" + try: + west, south, east, north = (float(request.args.get(i)) for i in ('west', 'south', 'east', 'north')) + except (TypeError, ValueError): + return response.json({'error': 'The edges of the area are four numbers'}, HTTPStatus.BAD_REQUEST) + if not (-180 <= west < east <= 180 and -90 <= south < north <= 90): + # Not so of a number which is not one, either. + return response.json({'error': 'The edges are not those of an area of the map'}, HTTPStatus.BAD_REQUEST) + # The index is read from its file the first time, which is not for the event loop. + name = await asyncio.to_thread(quads.quad_name, west, south, east, north) + return json_response({'quad': name.__json__() if name else None}) + + +# How much may be written on the sheet of an exported map. +SHEET_TEXT_LENGTH = 300 +SHEET_CREDITS = 40 + + +def _export_text(value) -> str: + """What was sent as text of an exported map (its title, the name of a layer), as it can be written in a PDF: + no longer than a line of a sheet, and with nothing in it which is not a character.""" + text = str(value or '').replace('\x00', '') + return text.encode('utf-8', 'replace').decode('utf-8')[:SHEET_TEXT_LENGTH] + + +def _sheet_contours(contours) -> dict: + """How far apart the contour lines of a map are, as the browser says it, for `export.Sheet`. A map with no + contour lines says nothing; what is said is written on the sheet only when it is an interval (see + `modules.map.sheet`).""" + if not isinstance(contours, dict): + return {} + interval = contours.get('interval') + if isinstance(interval, bool) or not isinstance(interval, (int, float)): + return {} + return dict(contour_interval=float(interval), contour_unit=str(contours.get('unit') or '')[:SHEET_TEXT_LENGTH]) + + +def _export_error(e: Exception): + """The response for an export which could not go on.""" + if isinstance(e, export_job.ExportNotFound): + return response.json({'error': str(e)}, HTTPStatus.NOT_FOUND) + if isinstance(e, export_job.ExportNotReady): + return response.json({'error': str(e)}, HTTPStatus.CONFLICT) + if isinstance(e, export_job.ExportStorageError): + return response.json({'error': str(e)}, HTTPStatus.INTERNAL_SERVER_ERROR) + return response.json({'error': str(e)}, HTTPStatus.BAD_REQUEST) + + +EXPORT_ERRORS = (export.InvalidExport, export_job.ExportNotFound, export_job.ExportNotReady, + export_job.ExportStorageError) + + +@map_bp.post('/export') +@openapi.description('Begin the export of a map as a PDF') +async def post_export(request: Request): + """The browser draws the map, one image for each layer; the API puts them in a PDF, each in a layer of its own. + That takes a minute or two on a Raspberry Pi, so it is a Job: + + 1. This request describes the map, and is answered with an `export_id`. + 2. `POST /api/map/export//layer/` sends the image of each layer. + 3. `POST /api/map/export//start` is answered with a `job_id`, to watch at `/api/jobs/`. + 4. `GET /api/map/export//pdf` is the PDF, once the Job is complete. + + `DELETE /api/map/export/` stops an export at any of those steps, and removes what was sent. + + The JSON body: `width` and `height` in pixels, `dpi`, `title`, `layers`: the name of each image from the bottom + up (images of one name are one layer of the PDF), `bounds`: the west, south, east and north edges of the images in degrees, with which the PDF says where it + is, and `sheet`: with which the map is put on a sheet with a margin and a grid; `name`, `credits` and `date` + are written on it, `contours` (`{"interval": 40, "unit": "feet"}`, or "meters") when the map has contour + lines, and `legend`: the lines of the map as they are drawn (see `modules.map.sheet.Sheet`).""" + try: + meta = request.json + width, height, dpi = int(meta['width']), int(meta['height']), float(meta['dpi']) + names = [_export_text(i) for i in meta['layers']] + title = _export_text(meta.get('title')) or None + bounds = meta.get('bounds') + sheet = meta.get('sheet') + if sheet is not None: + sheet = export.Sheet( + name=_export_text(sheet.get('name')) or None, + credits=[_export_text(i) for i in (sheet.get('credits') or [])[:SHEET_CREDITS]], + date=_export_text(sheet.get('date')) or None, + **_sheet_contours(sheet.get('contours')), + legend=legend_as_sent(sheet.get('legend')), + ) + except Exception: # noqa Whatever is made of a body which is not the description of a map. + return response.json({'error': 'The description of the map is not valid'}, HTTPStatus.BAD_REQUEST) + + try: + # Old exports are removed from the disk here, which is not for the event loop. + export_id = await asyncio.to_thread(export_job.create_export, names, width, height, dpi, title, bounds, sheet) + except EXPORT_ERRORS as e: + return _export_error(e) + return json_response({'export_id': export_id}, HTTPStatus.CREATED) + + +@map_bp.post('/export//layer/') +@openapi.description('Send the image (PNG or JPEG) of one layer of a map which is being exported') +async def post_export_layer(request: Request, export_id: str, index: int): + try: + await asyncio.to_thread(export_job.save_layer, export_id, index, request.body) + except EXPORT_ERRORS as e: + return _export_error(e) + return response.empty() + + +@map_bp.post('/export//start') +@openapi.description('Queue the Job which makes the PDF of a map, all of whose layers have been sent') +async def post_export_start(_: Request, export_id: str): + try: + job_id = await asyncio.to_thread(export_job.start_export, export_id) + except EXPORT_ERRORS as e: + return _export_error(e) + return json_response({'job_id': job_id}, HTTPStatus.ACCEPTED) + + +@map_bp.delete('/export/') +@openapi.description('Stop the export of a map: cancel its Job, if it has one, and remove what was sent') +async def delete_export(_: Request, export_id: str): + try: + await asyncio.to_thread(export_job.remove_export, export_id) + except EXPORT_ERRORS as e: + return _export_error(e) + return response.empty() + + +@map_bp.get('/export//pdf') +@openapi.description('The PDF of an exported map, once the Job which makes it is complete') +async def get_export_pdf(_: Request, export_id: str): + try: + pdf = await asyncio.to_thread(export_job.get_export_pdf, export_id) + except EXPORT_ERRORS as e: + return _export_error(e) + return await response.file(pdf, mime_type='application/pdf', filename='map.pdf') diff --git a/modules/map/conftest.py b/modules/map/conftest.py index 58546d05..10d0b806 100644 --- a/modules/map/conftest.py +++ b/modules/map/conftest.py @@ -49,3 +49,12 @@ def make_pmtiles(test_directory) -> Callable[..., Path]: return path return _ + + +@pytest.fixture(autouse=True) +def map_export_root(tmp_path, monkeypatch) -> Path: + """Exports of the map are kept in a directory of the test, not of the machine.""" + from modules.map import export_job + root = tmp_path / 'map-export' + monkeypatch.setattr(export_job, 'EXPORT_ROOT', root) + return root diff --git a/modules/map/export.py b/modules/map/export.py new file mode 100644 index 00000000..b17a793d --- /dev/null +++ b/modules/map/export.py @@ -0,0 +1,295 @@ +"""Build the PDF of an exported map. + +The map is drawn by the browser, which is the only thing that draws it as the user sees it: one image for each +layer the user has turned on, all of the same area and size. Here they become one page, each image in a PDF +layer (an "optional content group") of its own, so a reader can show and hide them as the map can. + +The page is also told where on the Earth it is (a "geospatial PDF", ISO 32000-2 section 12.10), so a reader which +knows how can show coordinates, measure, and put a GPS position on the map. + +The map can be put on a sheet (see `modules.map.sheet`): a margin around it with what a printed map has there, and +a grid over it. +""" +import io +import math +import pathlib +import zlib +from dataclasses import dataclass +from typing import Callable, List, Optional, Sequence + +from PIL import Image + +from modules.map.sheet import Sheet, draw_sheet, plan_sheet +from wrolpi.common import logger + +logger = logger.getChild(__name__) + +__all__ = ['ExportLayer', 'InvalidExport', 'Sheet', 'build_layered_pdf', 'check_export', 'geospatial_viewport', + 'MAX_LAYERS', 'MAX_SIDE', 'MAX_PIXELS', 'MAX_TOTAL_PIXELS', 'MIN_DPI', 'MAX_DPI'] + +# What the browser may ask for. Every image is decoded, so what an export costs is its pixels, whatever the size +# of the upload (an image of one color is a few kilobytes however large it is). +MAX_LAYERS = 64 +MAX_SIDE = 16384 +# The pixels of one layer, which are in memory together (a few bytes each) while it is put in the PDF. A 1:24,000 +# quadrangle at 300 DPI is 23 to 47 megapixels, more the nearer it is to the equator; at 400 DPI, 40 to 83. The +# browser draws a map less sharp than it was asked to rather than send more than this. +MAX_PIXELS = 64_000_000 +# The pixels of every layer of a map together, which is the work an export is. A quadrangle of 40 megapixels with +# 24 layers on is about 960 million. +MAX_TOTAL_PIXELS = 1_000_000_000 +# How hard an image is compressed in the PDF (zlib, 1 to 9). Less is a few seconds faster and a much larger file. +COMPRESSION_LEVEL = 6 +MIN_DPI = 36 +MAX_DPI = 1200 +IMAGE_FORMATS = ('PNG', 'JPEG') + +POINTS_PER_INCH = 72 + + +# The map is drawn in Web Mercator, in which the area between two meridians and two parallels is a rectangle: the +# page. Its four corners, in latitude and longitude, are all a reader needs to know of where it is. +# +# What a reader is told of the projection is not Web Mercator, which Adobe Acrobat does not know (it says every +# place is at 0, 0), but Mercator on the WGS 84 ellipsoid, which every reader knows. Web Mercator is Mercator on +# a sphere: across a page of a map the two differ by a stretch from north to south, which the corners say, and +# what is left is under three centimeters on the ground across a quadrangle, at any latitude. It grows with the +# square of how tall the page is (a third of a meter for half a degree, more than a meter for a degree), so a +# map much taller than a quadrangle wants more than its corners said. (To say only that the page is in +# latitude and longitude would be read too, and be up to 7 meters out at 61 degrees on a quadrangle: a degree +# of latitude is not as tall at the top of a Mercator page as at the bottom.) +# +# The words are Esri's, as GDAL writes them in a PDF: Acrobat reads those. +PAGE_PROJECTION_EPSG = 3395 +PAGE_PROJECTION_WKT = ( + 'PROJCS["WGS_1984_World_Mercator",' + 'GEOGCS["GCS_WGS_1984",DATUM["D_WGS_1984",SPHEROID["WGS_1984",6378137.0,298.257223563]],' + 'PRIMEM["Greenwich",0.0],UNIT["Degree",0.0174532925199433]],' + 'PROJECTION["Mercator"],' + 'PARAMETER["False_Easting",0.0],PARAMETER["False_Northing",0.0],' + 'PARAMETER["Central_Meridian",0.0],PARAMETER["Standard_Parallel_1",0.0],' + 'UNIT["Meter",1.0]]' +) +# Web Mercator has no poles: this is as far north or south as it goes. +MAX_LATITUDE = 85.06 +# The browser's arithmetic can put the edge of the world a hair past where it is (180.00000000000125 degrees). An +# edge within this of 180 degrees is at 180 degrees; one further past it is of a map which crosses the antimeridian. +LONGITUDE_SLIVER = 1e-8 + + +class InvalidExport(ValueError): + """The layers sent can not be made into a map.""" + + +@dataclass +class ExportLayer: + # What the layer is called in the reader's list of layers. + name: str + # A PNG or JPEG image, or the file it is in. The images of a map are a hundred megabytes together, so those + # in files are read one at a time, when each is needed. + image: Optional[bytes] = None + path: Optional[pathlib.Path] = None + + def read(self) -> bytes: + return self.image if self.image is not None else pathlib.Path(self.path).read_bytes() + + +def _is_blank(image: Image.Image) -> bool: + """True when nothing was drawn: every pixel of the image is transparent.""" + if image.mode in ('RGBA', 'LA'): + return image.getchannel('A').getextrema()[1] == 0 + if image.mode == 'P' and 'transparency' in image.info: + return image.convert('RGBA').getchannel('A').getextrema()[1] == 0 + return False + + +def _check_layer(layer: ExportLayer, width: int, height: int) -> bool: + """Raises InvalidExport when the layer is not an image of the map. Returns whether there is anything in it.""" + try: + image = Image.open(io.BytesIO(layer.read())) + if image.format not in IMAGE_FORMATS: + raise InvalidExport(f'The layer {layer.name!r} is not a PNG or JPEG image') + if image.size != (width, height): + raise InvalidExport(f'The layer {layer.name!r} is {image.size[0]}x{image.size[1]},' + f' but the map is {width}x{height}') + return not _is_blank(image) + except InvalidExport: + raise + except Exception as e: + # Whatever Pillow makes of something which is not an image. + raise InvalidExport(f'The layer {layer.name!r} is not a readable image') from e + + +def _edge_longitude(longitude: float) -> float: + """A longitude which is a rounding error past the edge of the world, put on it. It is not wrapped: the east + edge of the last map before the antimeridian is at 180 degrees, not at -180.""" + if 180 < abs(longitude) < 180 + LONGITUDE_SLIVER: + return math.copysign(180.0, longitude) + return longitude + + +def _check_bounds(bounds: Sequence[float]) -> List[float]: + """The west, south, east and north edges of a map, in degrees. Raises InvalidExport when they are not.""" + try: + west, south, east, north = (float(i) for i in bounds) + except (TypeError, ValueError) as e: + raise InvalidExport('The edges of the map are not four numbers') from e + west, east = _edge_longitude(west), _edge_longitude(east) + edges = [west, south, east, north] + if not all(math.isfinite(i) for i in edges) or not (-180 <= west < east <= 180) \ + or not (-MAX_LATITUDE <= south < north <= MAX_LATITUDE): + raise InvalidExport(f'A map with the edges {edges} can not be exported') + return edges + + +def _pdf_string(text: str) -> str: + """A string as it is written in a PDF: as it is when it is ASCII, else in UTF-16.""" + if text.isascii(): + return '(' + text.replace('\\', '\\\\').replace('(', '\\(').replace(')', '\\)') + ')' + return '<' + (b'\xfe\xff' + text.encode('utf-16-be')).hex().upper() + '>' + + +def geospatial_viewport(width: float, height: float, bounds: Sequence[float], name: str = None, + origin: Sequence[float] = (0, 0)) -> str: + """The value of a page's `/VP`: a viewport which covers the map (`width` by `height` points, its lower left + corner at `origin`: so far right of, and up from, the page's), and says it is the map between `bounds` (west, + south, east, north; degrees of WGS 84), in the projection a reader is told of (see PAGE_PROJECTION_WKT). + + A point of the map is given as a part of the way across and up it (0 to 1, from the lower left), and the + corners are listed as GDAL and the readers which follow it expect: upper left, lower left, lower right, + upper right. The coordinates of each are its latitude, then its longitude. + """ + west, south, east, north = _check_bounds(bounds) + corners = '0 1 0 0 1 0 1 1' + points = ' '.join(f'{lat:.9f} {lon:.9f}' for lat, lon in ((north, west), (south, west), (south, east), + (north, east))) + name = f' /Name {_pdf_string(name)}' if name else '' + return ( + f'[<< /Type /Viewport{name}' + f' /BBox [{origin[0]:.3f} {origin[1]:.3f} {origin[0] + width:.3f} {origin[1] + height:.3f}]' + f' /Measure << /Type /Measure /Subtype /GEO' + f' /Bounds [{corners}] /GPTS [{points}] /LPTS [{corners}]' + f' /GCS << /Type /PROJCS /EPSG {PAGE_PROJECTION_EPSG} /WKT {_pdf_string(PAGE_PROJECTION_WKT)} >>' + f' /PDU [/M /SQM /DEG] >> >>]' + ) + + +def _compress_stream(doc, xref: int): + """Compress the stream of an object of the PDF, when it is not already.""" + if doc.xref_get_key(xref, 'Filter')[0] != 'null': + return + doc.update_stream(xref, zlib.compress(doc.xref_stream_raw(xref), COMPRESSION_LEVEL), compress=False) + doc.xref_set_key(xref, 'Filter', '/FlateDecode') + + +def _insert_layer(doc, page, rect, layer: ExportLayer, groups: dict): + """Put the image of a layer in a rectangle of the page, in the PDF layer of its name: its own, unless an + image before it had the name. (`groups` is the PDF layer of each name so far.) A layer of the map may be + several images, with other layers drawn between them. + + PyMuPDF keeps the pixels of an image uncompressed until the PDF is written: about 90 MB for each layer of a + quadrangle, all of them at once. They are compressed here instead, so only one layer's are ever in memory.""" + if layer.name not in groups: + groups[layer.name] = doc.add_ocg(layer.name, on=True) + xref = page.insert_image(rect, stream=layer.read(), oc=groups[layer.name]) + _compress_stream(doc, xref) + # The transparency of a PNG is an image of its own. + kind, mask = doc.xref_get_key(xref, 'SMask') + if kind == 'xref': + _compress_stream(doc, int(mask.split()[0])) + + +def check_export(layer_count: int, width: int, height: int, dpi: float, bounds: Optional[Sequence[float]] = None, + sheet: Optional[Sheet] = None) -> Optional[List[float]]: + """Raises InvalidExport when a map of `layer_count` images of `width` by `height` pixels can not be made into a + PDF. No image is read: this is what can be said of a map before its images are sent. Returns the `bounds` + as they are used.""" + if layer_count < 1: + raise InvalidExport('There are no layers to export') + if layer_count > MAX_LAYERS: + raise InvalidExport(f'A map of more than {MAX_LAYERS} layers can not be exported') + if not (0 < width <= MAX_SIDE and 0 < height <= MAX_SIDE) or width * height > MAX_PIXELS: + raise InvalidExport(f'A map of {width}x{height} pixels can not be exported') + if layer_count * width * height > MAX_TOTAL_PIXELS: + raise InvalidExport(f'A map of {layer_count} layers of {width}x{height} pixels is too large to export;' + f' turn some layers off') + if not MIN_DPI <= dpi <= MAX_DPI: + raise InvalidExport(f'A map can not be exported at {dpi} DPI') + if bounds is not None: + return _check_bounds(bounds) + if sheet is not None: + raise InvalidExport('The edges of the map are needed to put it on a sheet') + return None + + +def build_layered_pdf(layers: List[ExportLayer], width: int, height: int, dpi: float, title: str = None, + bounds: Optional[Sequence[float]] = None, sheet: Optional[Sheet] = None, + progress: Optional[Callable[[int, int], None]] = None) -> bytes: + """A one page PDF of the layers, the first at the bottom, each in a PDF layer of its own. + + A layer in which nothing was drawn is left out. + + @param layers: The images of the map, all `width` by `height` pixels. + @param dpi: How many of those pixels are an inch of the page. + @param bounds: The west, south, east and north edges of the images, in degrees. With them the PDF says where + it is on the Earth; the images must be Web Mercator, and all of the map between those edges. + @param sheet: With this the map is on a sheet, which says this of it. The sheet needs `bounds`. + @param progress: Called with how many steps are done, and how many there are, before each step. A PDF takes + a minute or two on a Raspberry Pi, which is long to wait with nothing said; and it may raise to stop the + work. + @raise InvalidExport: When the layers are not of one map. + """ + # Before any image is decoded. + bounds = check_export(len(layers), width, height, dpi, bounds, sheet) + + # Each layer is looked at, and then each which has anything in it is put in the PDF: two steps a layer. + steps = 2 * len(layers) + + def step(done: int): + if progress: + progress(done, steps) + + drawn = [] + for index, layer in enumerate(layers): + step(index) + if _check_layer(layer, width, height): + drawn.append(layer) + if not drawn: + raise InvalidExport('Nothing is drawn in any layer of the map') + + # Not imported at module level: pymupdf also imports onnxruntime (~2s on a Pi 4), which the API must not pay + # for at startup. + import pymupdf + + doc = pymupdf.open() + try: + map_width, map_height = width * POINTS_PER_INCH / dpi, height * POINTS_PER_INCH / dpi + if sheet is not None: + plan = plan_sheet(map_width, map_height, bounds, sheet) + page = doc.new_page(width=plan.width, height=plan.height) + rect = pymupdf.Rect(plan.map_rect) + else: + plan = None + page = doc.new_page(width=map_width, height=map_height) + rect = page.rect + groups = {} + for index, layer in enumerate(drawn): + # A layer which was left out is a step done. + step(len(layers) + (len(layers) - len(drawn)) + index) + _insert_layer(doc, page, rect, layer, groups) + step(steps) + if plan is not None: + draw_sheet(doc, page, plan) + # Every step is done; what is told may still stop the work, here and before the PDF is written. + step(steps) + if bounds is not None: + # A PDF measures up from the bottom of the page. + origin = (rect.x0, page.rect.height - rect.y1) + doc.xref_set_key(page.xref, 'VP', geospatial_viewport(rect.width, rect.height, bounds, title, origin)) + doc.set_metadata(dict(title=title or 'Map', creator='WROLPi', producer='WROLPi')) + step(steps) + pdf = doc.tobytes(garbage=3) + step(steps) + return pdf + finally: + doc.close() diff --git a/modules/map/export_job.py b/modules/map/export_job.py new file mode 100644 index 00000000..4b272b1c --- /dev/null +++ b/modules/map/export_job.py @@ -0,0 +1,321 @@ +"""Making the PDF of an exported map as a Job. + +A PDF of a map is a minute or two of work on a Raspberry Pi: too long for a request to wait on. So the browser +describes the map and is given the id of an export; it sends the image of each layer, one a request (together they +are a hundred megabytes, more than one request may be); then it asks for the PDF to be made, and is given the id of +a Job (see `wrolpi.jobs`). It watches the Job, and when the Job is done it fetches the PDF. + +An export is a directory, which holds what was said of the map, the images until the PDF is made of them, and then +the PDF. It is on a disk, not in memory. It is removed when the person exporting stops it, when its Job is +cancelled, or when it is old; never while its Job is waiting or running. +""" +import asyncio +import json +import os +import pathlib +import re +import shutil +import stat +import threading +import time +import uuid +from typing import List, Optional + +from modules.map import export +from wrolpi.common import logger +from wrolpi.errors import UnknownJob +from wrolpi.jobs import (CANCELLED, COMPLETE, PENDING, RUNNING, cancel_job, get_current_job, get_job, + register_job) + +logger = logger.getChild(__name__) + +__all__ = ['ExportNotFound', 'ExportNotReady', 'ExportStorageError', 'create_export', 'save_layer', 'start_export', + 'get_export_pdf', 'remove_export', 'remove_old_exports', 'map_export_pdf_job', 'EXPORT_ROOT', 'EXPORT_KEEP_SECONDS', 'MAX_LAYER_BYTES'] + +# Where exports are kept. Not /tmp, which is memory on a Raspberry Pi. /var/tmp is a directory anyone on the +# machine may make things in, so this one is only used when it is a real directory of this user's (see `_root`). +EXPORT_ROOT = pathlib.Path('/var/tmp/wrolpi-map-export') +# An export which is this old is removed: its PDF was fetched long ago, or never will be. +EXPORT_KEEP_SECONDS = 60 * 60 +# The most one image of a layer may be. A layer of a quadrangle at 400 DPI is 20 to 30 MB as a PNG. +MAX_LAYER_BYTES = 64 * 1024 * 1024 +JOB_NAME = 'map_export_pdf' +META_FILE = 'meta.json' +PDF_FILE = 'map.pdf' +EXPORT_ID = re.compile(r'^[0-9a-f]{32}$') +PNG_MAGIC, JPEG_MAGIC = b'\x89PNG\r\n\x1a\n', b'\xff\xd8\xff' + + +class ExportNotFound(Exception): + """There is no such export: it was never made, or it was old and has been removed.""" + + +class ExportNotReady(Exception): + """The export is not as far along as it was asked to be.""" + + +class ExportStorageError(Exception): + """Where exports are kept can not be used.""" + + +class ExportCancelled(Exception): + """The Job which was making the PDF was cancelled.""" + + +def _is_own_directory(path: pathlib.Path) -> bool: + """Whether a path is a directory itself (not a link to one) which this user owns.""" + try: + status = os.lstat(path) + except OSError: + return False + return stat.S_ISDIR(status.st_mode) and status.st_uid == os.getuid() + + +def _root(create: bool = False) -> Optional[pathlib.Path]: + """Where exports are kept, or None when there is no such directory (and it is not to be made). + + It is made for this user alone: the images of a map are whatever the user has on their map. + + @raise ExportStorageError: When what is there is not a directory of this user's: a link there, which another + user of the machine may have made, would have exports written (and old ones removed) wherever it leads.""" + if create: + try: + os.mkdir(EXPORT_ROOT, 0o700) + except FileExistsError: + pass + except OSError as e: + raise ExportStorageError(f'The directory of map exports can not be made: {EXPORT_ROOT}') from e + if not os.path.lexists(EXPORT_ROOT): + return None + if not _is_own_directory(EXPORT_ROOT): + raise ExportStorageError(f'The directory of map exports is not a directory of this user: {EXPORT_ROOT}') + if create and stat.S_IMODE(os.lstat(EXPORT_ROOT).st_mode) != 0o700: + # One which was made before it was made for this user alone. + os.chmod(EXPORT_ROOT, 0o700) + return EXPORT_ROOT + + +def _directory(export_id: str) -> pathlib.Path: + """Where an export is. The id is what `create_export` gave, and nothing else: it becomes part of a path.""" + if not EXPORT_ID.match(str(export_id)): + raise ExportNotFound(f'There is no export {export_id!r}') + root = _root() + directory = root / export_id if root else None + if directory is None or not _is_own_directory(directory) or not (directory / META_FILE).is_file(): + raise ExportNotFound(f'There is no export {export_id!r}') + return directory + + +def _read_meta(directory: pathlib.Path) -> dict: + return json.loads((directory / META_FILE).read_text()) + + +def _write_whole(path: pathlib.Path, contents: bytes): + """Write a file so that whoever reads it reads all of it, or what was there before: never a part.""" + partial = path.with_name(f'{path.name}.{uuid.uuid4().hex}.part') + try: + partial.write_bytes(contents) + os.replace(partial, path) + finally: + partial.unlink(missing_ok=True) + + +def _write_meta(directory: pathlib.Path, meta: dict): + _write_whole(directory / META_FILE, json.dumps(meta).encode()) + + +def _layer_file(directory: pathlib.Path, index: int) -> pathlib.Path: + return directory / f'layer-{index:03d}' + + +def _job_status(meta: dict) -> Optional[str]: + """The status of the Job of an export, or None when it has none: it was not started, or the API has + restarted since and has forgotten the Job.""" + if not meta.get('job_id'): + return None + try: + return get_job(meta['job_id'])['status'] + except UnknownJob: + return None + + +def remove_old_exports(now: float = None): + """Remove the exports which are done with. An export is a hundred megabytes until its PDF is made, and tens + after. + + An export whose Job is waiting or running is kept however old it is: its images are what the Job is to work + from, and it may wait behind another Job for longer than an export is kept. One whose Job was cancelled is + removed at once. Any other is removed when it is old. Only what is an export is touched.""" + now = time.time() if now is None else now + root = _root() + if root is None: + return + for directory in root.iterdir(): + try: + if not EXPORT_ID.match(directory.name) or not _is_own_directory(directory): + continue + try: + status = _job_status(_read_meta(directory)) + except (OSError, ValueError): + # No description which can be read: not an export any Job can use. + status = None + if status in (PENDING, RUNNING): + continue + if status == CANCELLED or now - directory.stat().st_mtime > EXPORT_KEEP_SECONDS: + shutil.rmtree(directory, ignore_errors=True) + except OSError as e: + logger.warning(f'Could not remove the old map export {directory}', exc_info=e) + + +def remove_export(export_id: str): + """Stop an export, and remove it: the person exporting does not want it. + + Its Job is cancelled when it is waiting or running. A running Job stops between two layers and removes the + images itself; until then they are in use, so what is left of the export is removed later, with the old ones.""" + directory = _directory(export_id) + meta = _read_meta(directory) + status = _job_status(meta) + if status in (PENDING, RUNNING): + cancel_job(meta['job_id']) + if status != RUNNING: + shutil.rmtree(directory, ignore_errors=True) + + +def create_export(layers: List[str], width: int, height: int, dpi: float, title: Optional[str] = None, + bounds=None, sheet: Optional[export.Sheet] = None) -> str: + """Begin an export of a map of these layers (their names, from the bottom up). Returns its id. + + @raise InvalidExport: When such a map can not be exported; no image has been sent yet.""" + bounds = export.check_export(len(layers), width, height, dpi, bounds, sheet) + root = _root(create=True) + remove_old_exports() + export_id = uuid.uuid4().hex + directory = root / export_id + os.mkdir(directory, 0o700) + _write_meta(directory, dict( + layers=[str(i) for i in layers], width=width, height=height, dpi=dpi, title=title, bounds=bounds, + sheet=dict(name=sheet.name, credits=list(sheet.credits), date=sheet.date, + contour_interval=sheet.contour_interval, contour_unit=sheet.contour_unit, + legend=sheet.legend) if sheet else None, + job_id=None, + )) + return export_id + + +def save_layer(export_id: str, index: int, image: bytes): + """Keep the image of one layer of an export. + + @raise InvalidExport: When it is not an image of a layer of that export.""" + directory = _directory(export_id) + meta = _read_meta(directory) + if meta['job_id']: + raise export.InvalidExport('The PDF of this map is already being made') + if not 0 <= index < len(meta['layers']): + raise export.InvalidExport(f'The map has {len(meta["layers"])} layers; there is no layer {index}') + if not image or len(image) > MAX_LAYER_BYTES: + raise export.InvalidExport(f'The image of the layer {meta["layers"][index]!r} is empty, or is too large') + if not image.startswith((PNG_MAGIC, JPEG_MAGIC)): + raise export.InvalidExport(f'The layer {meta["layers"][index]!r} is not a PNG or JPEG image') + _write_whole(_layer_file(directory, index), image) + if not (directory / META_FILE).is_file(): + # The export was removed while this image was on its way: the image is not left behind it. + shutil.rmtree(directory, ignore_errors=True) + raise ExportNotFound(f'There is no export {export_id!r}') + + +def start_export(export_id: str) -> str: + """Queue the Job which makes the PDF of an export, all of whose images have been sent. Returns the Job's id; + asked again, the same Job's.""" + directory = _directory(export_id) + meta = _read_meta(directory) + if meta['job_id']: + return meta['job_id'] + missing = [name for index, name in enumerate(meta['layers']) if not _layer_file(directory, index).is_file()] + if missing: + raise ExportNotReady(f'The images of {len(missing)} layers have not been sent: {", ".join(missing[:5])}') + job_id = map_export_pdf_job.enqueue(description=f'Map PDF: {meta["title"] or "a map"}', export_id=export_id) + meta['job_id'] = job_id + _write_meta(directory, meta) + return job_id + + +def get_export_pdf(export_id: str) -> pathlib.Path: + """The PDF of an export. + + @raise ExportNotReady: When it has not been made (yet, or because the Job failed or was cancelled).""" + directory = _directory(export_id) + pdf = directory / PDF_FILE + if not pdf.is_file(): + job_id = _read_meta(directory).get('job_id') + status = get_job(job_id)['status'] if job_id else 'not started' + raise ExportNotReady(f'The PDF has not been made (the job is {status})' if status != COMPLETE + else 'The PDF is gone') + return pdf + + +def _make_pdf(directory: pathlib.Path, job, stop: threading.Event) -> dict: + """Make the PDF of an export from its images, which are removed whether or not it could be made. + + The work stops between two layers when the Job is cancelled, and when `stop` is set: the Job was ended by + something other than its being cancelled (the API is stopping), which the Job itself does not say.""" + meta = _read_meta(directory) + layers = [export.ExportLayer(name=name, path=_layer_file(directory, index)) + for index, name in enumerate(meta['layers'])] + sheet = export.Sheet(**meta['sheet']) if meta['sheet'] else None + + def stopped() -> bool: + return stop.is_set() or job.cancel_requested() + + def progress(done: int, steps: int): + # Between two layers is where the work can be stopped. + if stopped(): + raise ExportCancelled() + job.set_progress(100 * done / steps) + + try: + pdf = export.build_layered_pdf(layers, meta['width'], meta['height'], meta['dpi'], meta['title'], + meta['bounds'], sheet, progress=progress) + # Under another name until all of it is written: a PDF which is there is a whole one. + partial = directory / f'{PDF_FILE}.part' + partial.write_bytes(pdf) + if stopped(): + partial.unlink(missing_ok=True) + raise ExportCancelled() + partial.rename(directory / PDF_FILE) + return dict(export_id=directory.name, size=len(pdf)) + finally: + for layer in layers: + layer.path.unlink(missing_ok=True) + + +@register_job(JOB_NAME) +async def map_export_pdf_job(export_id: str): + """Make the PDF of an export. The work is in a thread: this process has other things to keep doing. + + A Job which is cancelled is not over until that thread has stopped: Jobs are run one at a time so that two of + them do not work a Raspberry Pi at once, and the next is not to start beside the work of this one.""" + directory = _directory(export_id) + job = get_current_job() + job.log(f'Making the PDF of the map export {export_id}') + # Old exports are removed here too: an export may be the last for a long while. + await asyncio.to_thread(remove_old_exports) + stop = threading.Event() + work = asyncio.ensure_future(asyncio.to_thread(_make_pdf, directory, job, stop)) + try: + # Shielded: cancelling this Job must not let go of the thread, which can not be stopped from here. + result = await asyncio.shield(work) + except asyncio.CancelledError: + # The thread is told to stop, which it does between two layers. Wait for it to: an API which is stopping + # waits for its threads, and is not to wait for all of a PDF. + stop.set() + await asyncio.wait({work}) + if not work.cancelled(): + work.exception() + raise + except ExportCancelled: + # The work saw that the Job was cancelled before the Job's runner did. The runner is who ends a cancelled + # Job (it looks every second), so wait for it to. + await asyncio.Event().wait() + raise + job.log(f'The PDF is {result["size"]} bytes') + return result diff --git a/modules/map/magnetic.py b/modules/map/magnetic.py new file mode 100644 index 00000000..4a00fc17 --- /dev/null +++ b/modules/map/magnetic.py @@ -0,0 +1,121 @@ +"""Where a compass points: the World Magnetic Model. + +A compass does not point at the north a map is drawn to, and how far off it is depends on where it is and when. +The model is the Earth's magnetic field as a sum of spherical harmonics, each of which changes at a steady rate +for the five years the model is good for. + +`wmm/WMM2025.COF` is the coefficient file of the World Magnetic Model 2025, as it is published by the NOAA +National Centers for Environmental Information and the British Geological Survey +(https://www.ncei.noaa.gov/products/world-magnetic-model). It is a work of the U.S. Government, in the public +domain. It is good from 2025.0 until 2030.0, when its successor is published: put that file beside it, and name +it in MODEL_PATH. +""" +import math +import pathlib +from dataclasses import dataclass +from functools import lru_cache +from typing import List, Optional, Tuple + +__all__ = ['MagneticModel', 'load_model', 'declination', 'MODEL_PATH'] + +MODEL_PATH = pathlib.Path(__file__).parent / 'wmm' / 'WMM2025.COF' +# How many years a model is good for, from its epoch. +MODEL_YEARS = 5 + +# The WGS 84 ellipsoid (kilometers), and the radius of the sphere the model is of. +WGS84_A = 6378.137 +WGS84_F = 1 / 298.257223563 +WGS84_E2 = WGS84_F * (2 - WGS84_F) +MODEL_RADIUS = 6371.2 + + +@dataclass +class MagneticModel: + # The decimal year the coefficients are of. + epoch: float + name: str + # (n, m, g, h, the change of g in a year, the change of h in a year): nanoteslas. + coefficients: List[Tuple[int, int, float, float, float, float]] + + @property + def degree(self) -> int: + return max(i[0] for i in self.coefficients) + + def covers(self, year: float) -> bool: + return self.epoch <= year < self.epoch + MODEL_YEARS + + def field(self, latitude: float, longitude: float, year: float, + altitude: float = 0) -> Tuple[float, float, float]: + """The magnetic field (nanoteslas north, east and down) at a place (degrees of WGS 84; `altitude` is + kilometers above the ellipsoid) in a decimal year.""" + phi, lam = math.radians(latitude), math.radians(longitude) + # The place as the sphere has it: how far from the center of the Earth, and at what angle from its axis. + curvature = WGS84_A / math.sqrt(1 - WGS84_E2 * math.sin(phi) ** 2) + p = (curvature + altitude) * math.cos(phi) + z = (curvature * (1 - WGS84_E2) + altitude) * math.sin(phi) + r = math.hypot(p, z) + geocentric = math.asin(z / r) + cos_t, sin_t = math.sin(geocentric), math.cos(geocentric) + + # The Schmidt semi-normalized Legendre functions of the angle from the axis, and their derivatives. + size = self.degree + 1 + legendre = [[0.0] * size for _ in range(size)] + derivative = [[0.0] * size for _ in range(size)] + legendre[0][0] = 1.0 + for n in range(1, size): + for m in range(n + 1): + if n == m: + k = 1.0 if n == 1 else math.sqrt((2 * n - 1) / (2 * n)) + legendre[n][n] = k * sin_t * legendre[n - 1][n - 1] + derivative[n][n] = k * (sin_t * derivative[n - 1][n - 1] + cos_t * legendre[n - 1][n - 1]) + else: + k = math.sqrt(n * n - m * m) + before = math.sqrt((n - 1) ** 2 - m * m) if n > 1 and m <= n - 2 else 0.0 + legendre[n][m] = ((2 * n - 1) * cos_t * legendre[n - 1][m] + - before * (legendre[n - 2][m] if n > 1 else 0.0)) / k + derivative[n][m] = ((2 * n - 1) * (cos_t * derivative[n - 1][m] - sin_t * legendre[n - 1][m]) + - before * (derivative[n - 2][m] if n > 1 else 0.0)) / k + + years = year - self.epoch + north = east = down = 0.0 + for n, m, g, h, g_rate, h_rate in self.coefficients: + g, h = g + years * g_rate, h + years * h_rate + ratio = (MODEL_RADIUS / r) ** (n + 2) + cos_m, sin_m = math.cos(m * lam), math.sin(m * lam) + north += ratio * (g * cos_m + h * sin_m) * derivative[n][m] + east += ratio * m * (g * sin_m - h * cos_m) * legendre[n][m] / sin_t + down -= ratio * (n + 1) * (g * cos_m + h * sin_m) * legendre[n][m] + + # From the sphere's north and down to the ellipsoid's. + turn = geocentric - phi + return (north * math.cos(turn) - down * math.sin(turn), east, + north * math.sin(turn) + down * math.cos(turn)) + + def declination(self, latitude: float, longitude: float, year: float, altitude: float = 0) -> float: + """How far east of true north (degrees) a compass points at a place in a decimal year.""" + north, east, _ = self.field(latitude, longitude, year, altitude) + return math.degrees(math.atan2(east, north)) + + +@lru_cache(maxsize=None) +def load_model(path: pathlib.Path = MODEL_PATH) -> MagneticModel: + """Read a model's coefficient file: a line of its epoch and name, then a line for each harmonic.""" + lines = path.read_text().splitlines() + epoch, name = lines[0].split()[:2] + coefficients = [] + for line in lines[1:]: + parts = line.split() + if len(parts) != 6: + # The lines of nines which end the file. + continue + coefficients.append((int(parts[0]), int(parts[1]), *(float(i) for i in parts[2:]))) + return MagneticModel(epoch=float(epoch), name=name, coefficients=coefficients) + + +def declination(latitude: float, longitude: float, year: float) -> Optional[float]: + """How far east of true north (degrees) a compass points at a place on the ground in a decimal year, or None + in a year the model is not of: it is not known, and a guess is worse than nothing.""" + model = load_model() + if not model.covers(year): + return None + return model.declination(latitude, longitude, year) diff --git a/modules/map/quads.py b/modules/map/quads.py new file mode 100644 index 00000000..b01c15e8 --- /dev/null +++ b/modules/map/quads.py @@ -0,0 +1,117 @@ +"""What a quadrangle of the map is called. + +The U.S. Geological Survey names each of its 7.5 minute quadrangles, after a town or a mountain or a lake in it +("Berthoud", Colorado). `quads/usgs_7_5_minute.tsv.gz` is the index of those names, from the Map Indices of +The National Map (public domain); `wrolpi/scripts/build_map_quad_names.py` makes it. + +Most of those quadrangles are 7.5 minutes each way, with their edges on whole multiples of 7.5 minutes. Not all: +in Alaska a quadrangle is wider the further north it is, and around some islands they are moved to fit the land. +So a place is looked for in the quadrangle which has it, and whether that quadrangle is the one asked about is +said too. +""" +import bisect +import gzip +import pathlib +from dataclasses import dataclass +from functools import lru_cache +from typing import Dict, List, Optional, Tuple + +__all__ = ['QuadName', 'quad_name', 'load_index', 'INDEX_PATH'] + +INDEX_PATH = pathlib.Path(__file__).parent / 'quads' / 'usgs_7_5_minute.tsv.gz' +SECONDS_PER_DEGREE = 3600 +# No quadrangle is taller than this (seconds of arc): how far south of a place its quadrangle may start. +TALLEST = 450 +# Edges this near (seconds of arc) are the same edge. +SAME_EDGE = 1 +# A place this near (seconds of arc) past the outer edge of a quadrangle is on that edge: the edges the map gives +# are a hair from where they are. +OUTER_EDGE = 0.01 +# A place is where it is to the nearest this much (seconds of arc; 3 meters): the edges the map gives are a hair +# from where they are, and the middle of an area is often on the edge two quadrangles share. +NEAREST = 0.1 + + +@dataclass +class QuadName: + name: str + state: str + # Whether the named quadrangle is the area which was asked about, and not a larger or a moved one which has + # the middle of it. + exact: bool + + def __json__(self) -> dict: + return dict(name=self.name, state=self.state, exact=self.exact) + + +# The quadrangles which start at one latitude: their west edges in order, and (west, east, north, name, state) of +# each, in the same order. +Row = Tuple[List[int], List[Tuple[int, int, int, str, str]]] + + +@lru_cache(maxsize=None) +def load_index(path: pathlib.Path = INDEX_PATH) -> Tuple[List[int], Dict[int, str]]: + """The index: the latitudes (seconds of arc) quadrangles start at, in order, and the lines of the quadrangles + which start at each. + + The lines are kept as they are written (3 MB; as numbers and names they are 17 MB in each process of the API), + and are not read until a name is asked for.""" + rows: Dict[int, List[str]] = {} + with gzip.open(path, 'rt', encoding='utf-8') as fh: + for line in fh: + rows.setdefault(int(line[:line.index('\t')]), []).append(line) + return sorted(rows), {south: ''.join(lines) for south, lines in rows.items()} + + +@lru_cache(maxsize=32) +def _row(south: int) -> Row: + """The quadrangles which start at a latitude. Those asked about one after another are near each other, so + the few rows last read are kept.""" + wests, cells = [], [] + for line in load_index()[1][south].splitlines(): + _, west, east, north, name, state = line.split('\t') + # The lines are in order, so these are. + wests.append(int(west)) + cells.append((int(west), int(east), int(north), name, state)) + return wests, cells + + +def _find(x: float, y: float, outer: float = 0) -> Optional[Tuple[int, int, int, int, str, str]]: + """The quadrangle (west, south, east, north, name, state) which has a place (seconds of arc), or None. + + A place on an edge two quadrangles share is in the one east, or north, of it: a quadrangle has its west and + south edges, and not its east and north ones. With `outer` it has those too, and that much (seconds of arc) + past them.""" + souths, _ = load_index() + # The rows which may have the place, from the nearest to start south of it. + last = bisect.bisect_right(souths, y) + for row_south in reversed(souths[max(0, last - 8):last]): + if row_south < y - TALLEST * 2: + break + wests, cells = _row(row_south) + index = bisect.bisect_right(wests, x) - 1 + # Quadrangles moved to fit an island lie over their neighbors a little, so the one before is looked at too. + for cell_west, cell_east, cell_north, name, state in cells[max(0, index - 1):index + 1][::-1]: + if outer: + within = x <= cell_east + outer and y <= cell_north + outer + else: + within = x < cell_east and y < cell_north + if within and cell_west <= x and row_south <= y: + return cell_west, row_south, cell_east, cell_north, name, state + return None + + +def quad_name(west: float, south: float, east: float, north: float) -> Optional[QuadName]: + """What the USGS calls the quadrangle between these edges (degrees), or None where it has none: most of the + world. + + It is the quadrangle which has the middle of the area. Where the middle is on the east or north edge of a + quadrangle with none beyond it (an area half of which is the last quadrangle of the land), it is that one.""" + x = round((west + east) / 2 * SECONDS_PER_DEGREE / NEAREST) * NEAREST + y = round((south + north) / 2 * SECONDS_PER_DEGREE / NEAREST) * NEAREST + found = _find(x, y) or _find(x, y, outer=OUTER_EDGE) + if found is None: + return None + edges = [round(i * SECONDS_PER_DEGREE) for i in (west, south, east, north)] + exact = all(abs(a - b) <= SAME_EDGE for a, b in zip(edges, found[:4])) + return QuadName(name=found[4], state=found[5], exact=exact) diff --git a/modules/map/quads/usgs_7_5_minute.tsv.gz b/modules/map/quads/usgs_7_5_minute.tsv.gz new file mode 100644 index 0000000000000000000000000000000000000000..564e656b6b76396a9417f1eb4d4c3050aecca1be GIT binary patch literal 637589 zcmV)2K+L}%iwFP!00002|CIepm)kh91qzS*{tC^`cL%kWGE)?#p&x0xs{A^(yS)0$ zkPe%0Afo@h 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%0Ae9;t` zOd`Z~p;gH%85Fm{G2c%VnWxJK{1I<*Gi*Vl4K$x7pM)#_is|^aj-Md3ep_S?XQ;V! zOw0_OF5_a$&n(jI0mOU zjcau%lDRTlvEbs#=;b8d!?xk~ytdedw7%pldcZeb1*zG|dln;{-Z~d8CF>C17-b)0SM+tqTCAg+mdinaUbA3RPYTh`mA&h^9q4yrs)bq%@A^j!z&)pNB zui~0%_mSf)TRE1`!`|oIY9RHV6#hgcAnsDAL+{b@8}=lmF4}T+vDPEWRKY-78jwAe zM}@v!`x|+^L_*HA;j&|mSUc#G_G5c`KWP4n#iXdz?kIT%A&uACf0tBjnysW#vuanI z3wsfjIH;n_SK|+^`FKro^euaHU@J;Fny+|G>)pF6v65dUvYRzlD~N6|M{a-AmqX2m z<%Gzi557iT^a>9-ELz04rf2r9TQ8h`aI^ORb|TgyVsTSm&*s4L8SmncgcbYDo6ZKc zq4~=UQeFTTFm=GQYaJ?X=g=S;=ra=ikLc?0Jh?as#~{x)l*6?8SI$2c1~u3qzuNhl zZqEhHtPQ9%+Q5cm`?;O|X_QxrW7h5K0J7tjT5AlwPGl2o*ru>OsruqL6jny0Dnd0x z1pN13$99q1EVPENZCVS|?m)g;Q{v5Og9}Cn@CiH5kDp^lbL|2^Z~SBRTarwfFcyct z?}j_Om#{yXFK9MU4U~sX56@D#+}Py|IE-qs0#@XkBk z9`a4BSr3F_JxprUaEj5jIg8u5X=7H=0Et`3E@{s!EQE6ap$>7-^j}>J4M-V#sayp zxAPQoqIQ&dFxO$1q8>5o9Z;GTHIIUDA}KV*BJYt$`A!U7#VV8E)?AlT^>ZWv5usHe zw!x5n*9~9P=w?)d#ZV3EryA44ngZHH&`;Af0`>J16* z&QDLmNW%`o0~jtcb5}*6o^7A$QIW^ctqt-n{dW~y{~> z87zj4DNE-r_R!Jp-qDko;Quul2xrW*+{{12e1UWVe0}p66dM)+u>kjgCtZjmeGjN zW$Nd3f~zXJD~%6cFx=bQb(^Eif-UZhPW)$T672`Q$HMMxm=TjfwSrt-Te5#EC7cbD z@1_kH;>kk3eOg4rVhVOCdb=FX8}lVk_b1t+#q@66&!h*VQ3Rz{vG=pGhC2BCnw=M6 zYfqNUK@^3UGS+3rJomi+NJL#*Zmc+cv_)SY&Yvs5M)l_r`IBObm-I;OWpApYK!A_# ziun%R1L`6B2n3d&oEJaa*ep>8g~jT$K6C&Zus(~bPYMs5TBwr9-k-}qXTH=ssH9zk z-8jcvm&PjvRG#N9tlXEF=WRvh#C`9}){mWq%Kuxg_?Fw;UA4Lt!E9dRo;(cQWC?h< z{t^OsI3+1t{oF<=&%SWJGWIN42I~$hwO)rs;3RE;-7u!VBLE3OJsuq@TVvjqKR<%H z1OU+-Hm>nmS8UQ=|#T$4cZ*Z&h%=gITYY{GyrQ8AFAZUO2xp=Wd5teBICP zjDY}x@V%OGPu<~H8K(@1c*1L8>19clMi)gQ>7-oxKr#`F>#HfrJGY|3hTaOQO8@go+k3*%+AOX1!VX3Fljaa4W z|2BSgpi@mHG_KEWdpLE205cfACdW7`a#ms7g#8kt&t}v}Q;w&Cw(G{c$siwW#2#G> zDeVuZgZ&Hcd>BO;&Tc~qo2PZH>Z zeZqO|f0XLNVOZSACHy~y@ zU~dS9L?9;RxdcZ%=gxlF@BkXB-1y7DxC!T?Z1QX!f;}$$Ix=%VFVvn!yRx#qTG1huoo0rFRluWBwZ+U~&l?wN%TC<7b7;z^jFEK-@Jyi3!FNl1E0 zol#%qmR7~%t35)#>KB;wDBp$w`+pp#Vu(0JiG!RR-TyjRT>B_jzD@ajHw|;M9gyRE zHUv>3ThN8$i_ZLO-S}E8wpu!ZhHhRnYagodXA)lt96+gey!xDXbwOK&rCv?BG1{yl zP#H+=SO1bsa>aI1{Q1n(%Ncn}(GUm3V6U?>{j4tYXH>R^g`k zUfD%b+y;^9ohE&HB5ra4$HknW;3w za!|4umWK$cStzn;tLE>;%{CJa+)sKZoL`EcL1qS<@&BB|v-4?LCI;Kb9>Dr^aD0$wrA27FyqrE}c%K>0^(uMbVo+|BFL^0%KpLDcI-> zT2>JC^`Cn*N62!cu=n?Oa>!$zBiX)}GwBNroPLN!n8`^zgRtrpv(cjD7M2%ZmXp67 zNo81utkn;-<3iozfhs^-B=8NU!vW0D+!Si4iht~3z1vt!A&ZZ1 z?X*t^WMee`tEFCe<(X!RugbS}izc#N>KuQ^$m=2e_1`mkK?E~kOn3hHx>FyPA5WWX zJd82cB}X7r=-=l0qoQ?X-%&2^T$t~V%mHt*JuJWnYwe-_PBwY~!Z^b4x=gK2*8fTh zQ!t-caACne_Kf$D`n28^!HEx_GWD+@OaDAVRO9Kfq*iHjpQsw^E+%qS(%kUrEe0-t z7~poD;|MoN3WTD)I~H?QqY<0>CzW1v_;isHgz;s~zb~^)H7d0m(H8jNwAJ8@rtWe! zE*aC+^{*1&5lJnUN>Pm$_*%W&_#V^HsO8J*GJ}Uoo_$aXcg#n%f_Yg*wJlDzLSuhA zDAhEGVLialXnpn93n;aDJ#72C>L`xFkF4`0SBm-Q+AO+mR{z5Wm>RWx#`hJ=sAu42 zMi_=j;pX@kiUf@AAtc9yw5*K!YQY)uWwsY#VLmntRKWgwKa(K-;Iv= z!e`5z%Km0@`(?J5ExMT>Vv0jxZ?JPU;?LRAeuQ|jmf0FvTm#WslBtc#N<}v5j+`nZ z=6^{UBItS{*6`l^r1WMXf?54)!WN1ykl+Si1-%q^Lv2ZQ=VI+dIc2WNdK;6khkc@J zFYd8oX66K<&lwmZH&>dYRXS{ZTX;aeq1mxN8Q_MFblg{{8`np^FKm12{?!g|8IbA z{&WkM;QR|d3Hs&gM!16^bJ2zcofUkoO@a^O6mQR5Z$!9AL@V@RoE`^m{QK!T1$2g0 zWc;VxtYJwgO`&=@b2=)-Zr}pLV{16~Lgq0z2{7N!HD&%!yiMh70NAD^Q5@Q~>HP~% z1pN{v;^<1?f|i7}o1d@R>;||52*m$h*O+evEex8za)xl5{EL-zhZ%Ej=KO%2vPgl2 z^i4XY%;^w^MSpnS)Crk#rx9$4E0R6*k}S$5AG0OV4Ix zC?whzdMIsepniT=3I-9oAtvQ#D|czPA>9Ag|1(vkd9THd#c4Hdd%rK}plx#bDM^IJGmV4{zn zojl$^+_@`FEsi&;9BMj`0F;cUfOwZ&#%x{&T=y&2o47^BBcoxN{D+#hpG*+f_sbd? zX`a!?jd3D?0Q~U*Vk$W^=*UsyPGvtp1I$kO{yzZ^Ro!%KS)f$Z+`C%yTnitq^B<4P zqqPZ@u`Y#imuEYjeBmT9ibPoZFE%}nRK7<&AU!a(6Q8n^IVvh8%LwN#3C;fdI}1>D z>iB5V_EYIN-KjONsDcna{FYNB+bnEf4-Hg|h2RD`BNbz{3D|FK40$9)>xT}|jLWcv zy*x*I?$@wE!Sk0gjpO_JC|C(RwY=i2=wz4EAwV~Kyj;;p@s@>7y*vYp2ePo93X%xZ z&{6%Fg=jzmd7<2ckAm>`w4#g0zslcX;t%Fj{5+JbPmnNowYv4hbntAF%z!GWa7FgMp1|%1lnAe}K`96;oiiGxA669lq8x;#wkUS<2Zm)1ry0N1m$uOZD z`jS7#U#9`do_0&)?2RsCm&XJF69`g3LCL59BS?st+MA~pZE}NzLE{TT?#oaXlFbwa zdjou}h3bbKmJPml9(t}#pq{#4)5&y3eUH8n8}!7bbpazzuowuQy}j&UmV8{yxIx}N zc)v2z4q;o2(**OkYB^T?mz!h;=T0l@&HO9;lV8JEY8y8l!T#pY^-6M1GYc88GW#OS zxs6!G1@fM4{q>LvPQ^su0W0Tj88@Obx_djhk0B_t6afIXP$5k>wh30d{wLa_s=-=;WgL`9_jB42{@oZ2p+U z`O_t7g`oj-hj5=Stg`Qbf`s6i56Y}iBnbq=a^mDmC9Pi%0yGFks!lwnEb3s5GzvK3 zD{nSJl|NN2G@@ba^uGe;ojUnw!B`mAJm{IgXy?1^dy>Y{R%qr9E6xbN-VRH4Y8My* zdz+1f>>CDV!CLg3Dtcxp(qJ8KPkordZgwCd5^7x5#&0cgvmD7#yXn-|uwE zhyabCCrjMMD3(%nD1>s|DgsudMt*UI9Kz|nCB>M5VT1^(AvFIBT#UyJVRm3ED7=aI zCSbgY6!>b>a2MM{;=K58vcU|7hdzhny}_4jYOWURIXE~$O|x0bvZ6FXAI5QACtH9T zMT#CkWRnlMzCy6D(z$)HXFw7@g2L+AB5r$8S)$qot3ZXQ0YBXY_e!s<(}ndM2ssV9 zKK#tg)_?y>rjATKCO1C)WMGaQp(^$6mc?BlDu21)0H0v;tZm2;{<|qC*8*-bo7>gV zLl3F{5xu#8q^%qVougDG*eCbX=85~zq{24YH>t~)X)}<*%2F^b2HIjqW;EN@jQ{VB zvROKcM~dBz1AmCMD|#bRX#ISx1Y-Oj>hOTEq~SFnc*@(Cr);fa(-e?iDH+yn4L*(A zyB363of<4^Agl4YQgq(p*fu*NOS3H2Mn27u+pm~>`F4oBnEsX8$O9F`0jM6d&WWS$ zhURHrsUz;?kQD&=QQwW<{I*G?`h?mTQovAJu?yVZ+~RF{;Vgk$OPZ)Vvd&ag^~t%0A8SRMpUMEx$^U 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

%j471e>H^=5+NDy!$Vo@HtNqyF(gzGQJ-MBfmS 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 z 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 z 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 bool: + return (self.bounds[1] + self.bounds[3]) / 2 < 0 + + def point(self, latitude: float, longitude: float) -> Tuple[float, float]: + """Where on the page a place is. The map is Web Mercator.""" + x0, y0, x1, y1 = self.map_rect + west, south, east, north = self.bounds + top, bottom = _mercator_y(north), _mercator_y(south) + return (x0 + (longitude - west) / (east - west) * (x1 - x0), + y0 + (top - _mercator_y(latitude)) / (top - bottom) * (y1 - y0)) + + +def _mercator_y(latitude: float) -> float: + return math.log(math.tan(math.pi / 4 + math.radians(latitude) / 2)) + + +def _middle_latitude(south: float, north: float) -> float: + """The latitude half way up a Web Mercator map.""" + y = (_mercator_y(south) + _mercator_y(north)) / 2 + return math.degrees(2 * math.atan(math.exp(y)) - math.pi / 2) + + +def map_scale(width: float, bounds: Sequence[float]) -> float: + """How many times larger the ground is than a map `width` points wide, at the middle of the map.""" + west, south, east, north = bounds + latitude = math.radians(_middle_latitude(south, north)) + meters_per_degree = math.radians(1) * WGS84_A * math.cos(latitude) \ + / math.sqrt(1 - WGS84_E2 * math.sin(latitude) ** 2) + return meters_per_degree * (east - west) / (width * METERS_PER_POINT) + + +# Universal Transverse Mercator, by the series of Krüger (as Karney gives them), which is good to well under a +# millimeter within a zone. +_N = WGS84_F / (2 - WGS84_F) +_RADIUS = WGS84_A / (1 + _N) * (1 + _N ** 2 / 4 + _N ** 4 / 64) +_ALPHA = (_N / 2 - 2 * _N ** 2 / 3 + 5 * _N ** 3 / 16, 13 * _N ** 2 / 48 - 3 * _N ** 3 / 5, 61 * _N ** 3 / 240) +_BETA = (_N / 2 - 2 * _N ** 2 / 3 + 37 * _N ** 3 / 96, _N ** 2 / 48 + _N ** 3 / 15, 17 * _N ** 3 / 480) +_DELTA = (2 * _N - 2 * _N ** 2 / 3 - 2 * _N ** 3, 7 * _N ** 2 / 3 - 8 * _N ** 3 / 5, 56 * _N ** 3 / 15) + + +def utm_zone(longitude: float) -> int: + """The UTM zone (1 to 60) a longitude is in. The zones are six degrees wide, everywhere: those which are + made wider around Norway and Svalbard are not.""" + return min(60, int((longitude + 180) // 6) + 1) + + +def _central_meridian(zone: int) -> float: + return math.radians(zone * 6 - 183) + + +def to_utm(latitude: float, longitude: float, zone: int, south: bool = False) -> Tuple[float, float]: + """The easting and northing (meters) of a place, in a UTM zone of WGS 84.""" + phi = math.radians(latitude) + lam = math.radians(longitude) - _central_meridian(zone) + c = 2 * math.sqrt(_N) / (1 + _N) + t = math.sinh(math.atanh(math.sin(phi)) - c * math.atanh(c * math.sin(phi))) + xi = math.atan2(t, math.cos(lam)) + eta = math.atanh(math.sin(lam) / math.sqrt(1 + t * t)) + northing = xi + sum(a * math.sin(2 * j * xi) * math.cosh(2 * j * eta) for j, a in enumerate(_ALPHA, 1)) + easting = eta + sum(a * math.cos(2 * j * xi) * math.sinh(2 * j * eta) for j, a in enumerate(_ALPHA, 1)) + return (UTM_FALSE_EASTING + UTM_SCALE * _RADIUS * easting, + (UTM_FALSE_NORTHING_SOUTH if south else 0) + UTM_SCALE * _RADIUS * northing) + + +def from_utm(easting: float, northing: float, zone: int, south: bool = False) -> Tuple[float, float]: + """The latitude and longitude (degrees of WGS 84) of a place in a UTM zone.""" + xi = (northing - (UTM_FALSE_NORTHING_SOUTH if south else 0)) / (UTM_SCALE * _RADIUS) + eta = (easting - UTM_FALSE_EASTING) / (UTM_SCALE * _RADIUS) + xi_ = xi - sum(b * math.sin(2 * j * xi) * math.cosh(2 * j * eta) for j, b in enumerate(_BETA, 1)) + eta_ = eta - sum(b * math.cos(2 * j * xi) * math.sinh(2 * j * eta) for j, b in enumerate(_BETA, 1)) + chi = math.asin(math.sin(xi_) / math.cosh(eta_)) + phi = chi + sum(d * math.sin(2 * j * chi) for j, d in enumerate(_DELTA, 1)) + lam = _central_meridian(zone) + math.atan2(math.sinh(eta_), math.cos(xi_)) + return math.degrees(phi), math.degrees(lam) + + +def format_angle(degrees: float, positive: str = '', negative: str = '', short: bool = False) -> str: + """An angle in degrees, minutes and seconds, as a sheet has it: 61°07'30". The seconds are left out when + there are none. `short` leaves the degrees out too (07'30"), as the ticks between a map's corners do. + + The angle is on the side its seconds are: an edge of a map a hair south of the equator is 0°00', and not + south of anything.""" + seconds = round(abs(degrees) * 3600) + d, m, s = seconds // 3600, seconds // 60 % 60, seconds % 60 + text = f"{m:02d}'" if short else f"{d}°{m:02d}'" + if s: + text += f'{s:02d}"' + return text + (negative if degrees < 0 and seconds else positive if seconds else '') + + +def graticule_interval(span: float) -> float: + """How far apart (degrees) the ticks of latitude and longitude are on a map `span` degrees across: the + largest spacing which divides it in three or more. A 7.5 minute map has a tick every 2.5 minutes.""" + for seconds in GRATICULE_INTERVALS: + if seconds * 3 <= round(span * 3600): + return seconds / 3600 + return GRATICULE_INTERVALS[-1] / 3600 + + +# A tick nearer an edge of the map than this part of the way to the next tick is that edge: the edges of the +# picture the browser draws are a hair outside the map it was asked for (a millionth of a degree). +TICK_CLEARANCE = 0.01 + + +def _multiples(interval: float, low: float, high: float) -> List[float]: + """The multiples of `interval` between `low` and `high`, and not at (or a hair from) either.""" + first = math.floor(low / interval) + values = [] + for i in range(first, first + 100_000): + value = i * interval + if value >= high - interval * TICK_CLEARANCE: + break + if value > low + interval * TICK_CLEARANCE: + values.append(value) + return values + + +def _latin(text: str) -> str: + """Text as the sheet's font can write it.""" + for old, new in (('′', "'"), ('″', '"'), ('’', "'"), ('‘', "'"), ('“', '"'), ('”', '"'), ('–', '-'), + ('—', '-'), (' ', ' ')): + text = text.replace(old, new) + text = ' '.join(text.split()) + return text.encode('latin-1', 'replace').decode('latin-1') + + +def _text_width(text: str, size: float, font: str = FONT) -> float: + # Not imported at module level: see build_layered_pdf. + import pymupdf + return pymupdf.get_text_length(text, fontname=font, fontsize=size) + + +def _wrap(text: str, width: float, size: float) -> List[str]: + """The lines of `text`, none wider than `width`.""" + lines, line = [], '' + for word in text.split(): + longer = f'{line} {word}' if line else word + if line and _text_width(longer, size) > width: + lines.append(line) + line = word + else: + line = longer + return lines + [line] if line else lines + + +def _grid_convergence(latitude: float, longitude: float, zone: int, south: bool) -> float: + """How far east of true north (degrees) the grid's north is at a place.""" + easting, northing = to_utm(latitude, longitude, zone, south) + lat, lon = from_utm(easting, northing + 1000, zone, south) + return math.degrees(math.atan2(math.radians(lon - longitude) * math.cos(math.radians(latitude)), + math.radians(lat - latitude))) + + +def _east_or_west(angle: float) -> str: + """An angle east of north as it is said: 2°34' west. No north is known to better than a minute.""" + return f'{format_angle(_to_the_minute(abs(angle)))} {"west" if angle < 0 else "east"}' + + +def mils(angle: float) -> int: + """An angle (degrees) in the mils a compass may be marked in.""" + return round(abs(angle) * MILS_PER_DEGREE) + + +def _mils(angle: float) -> str: + """An angle in mils, as it is said: "46 mils", and "1 mil".""" + count = mils(angle) + return f'{count} mil' if count == 1 else f'{count} mils' + + +def _north_of_true(angle: float) -> str: + """How far a north is from true north, as it is said: 2°34' west (46 mils).""" + return f'{_east_or_west(angle)} ({_mils(angle)})' + + +def adjoining_quads(bounds: Sequence[float]) -> Optional[List[Optional[str]]]: + """What the USGS calls the quadrangle on each of the eight sides of a map, in the order of ADJOINING. None + when it has a name for none of them: most of the world. + + A quadrangle of the USGS may be larger than the map (in Alaska they are wider), so the area the size of the + map beside it may be more of the quadrangle the map is in. The quadrangle on that side is the next one + which is not: a sheet is never beside itself.""" + west, south, east, north = bounds + width, height = east - west, north - south + own = quads.quad_name(west, south, east, north) + names = [] + for columns, rows in ADJOINING: + name = None + for step in range(1, ADJOINING_STEPS + 1): + name = quads.quad_name(west + step * columns * width, south + step * rows * height, + east + step * columns * width, north + step * rows * height) + if name is None or own is None or (name.name, name.state) != (own.name, own.state): + break + else: + name = None + names.append(_latin(name.name) if name else None) + return names if any(names) else None + + +def _number(value, least: float, most: float) -> Optional[float]: + """A number which was sent, kept between two others; None when it is not a number.""" + if isinstance(value, bool) or not isinstance(value, (int, float)) or not math.isfinite(value): + return None + return min(most, max(least, float(value))) + + +def _color(value) -> Optional[Tuple[float, float, float]]: + """A color which was sent (red, green and blue, each from 0 to 1); None when it is not one.""" + if not isinstance(value, (list, tuple)) or len(value) != 3: + return None + parts = tuple(_number(i, 0, 1) for i in value) + return None if None in parts else parts + + +def legend_lines(legend) -> Tuple[Tuple[float, float, float], List[LegendLine]]: + """The color of the land, and the lines, of the legend which a browser sent (see `Sheet.legend`). What is + not a line (it has no name, no color or no width) is left out, and a line is drawn no wider than a legend + has room for.""" + if not isinstance(legend, dict): + return WHITE, [] + lines = [] + raw = legend.get('lines') + for line in (raw if isinstance(raw, list) else [])[:LEGEND_LINES]: + if not isinstance(line, dict): + continue + label = _latin(str(line.get('label') or '')).strip()[:LEGEND_LABEL] + color, width = _color(line.get('color')), _number(line.get('width'), 0, LEGEND_WIDTHS[1]) + if not label or color is None or width is None or width < LEGEND_WIDTHS[0]: + continue + dash = line.get('dash') + dash = [_number(i, 0.1, LEGEND_SAMPLE) for i in (dash if isinstance(dash, (list, tuple)) else [])[:LEGEND_DASHES]] + opacity = _number(line.get('opacity'), 0.05, 1) + casing_color, casing_width = _color(line.get('casing_color')), _number(line.get('casing_width'), 0, 8) + lines.append(LegendLine( + label=label, color=color, width=width, opacity=1 if opacity is None else opacity, + dash=() if None in dash else tuple(dash), + casing_color=casing_color if casing_width else None, + casing_width=casing_width if casing_color and casing_width else 0)) + return _color(legend.get('ground')) or WHITE, lines + + +def legend_as_sent(legend) -> Optional[dict]: + """The legend which a browser sent with only what `legend_lines` makes of it, as it is sent; None when it + has no lines.""" + ground, lines = legend_lines(legend) + return dict(ground=list(ground), lines=[dataclasses.asdict(line) for line in lines]) if lines else None + + +def _legend_columns(plan: 'SheetPlan') -> int: + """How many lines of the legend go side by side under a map as wide as this one.""" + return max(1, int((plan.map_rect[2] - plan.map_rect[0]) // LEGEND_ITEM_WIDTH)) + + +def _legend_height(plan: 'SheetPlan') -> float: + """The room the legend takes under the map: nothing, when it has no lines.""" + if not plan.legend: + return 0 + rows = math.ceil(len(plan.legend) / _legend_columns(plan)) + return LABEL_SIZE + 8 + rows * LEGEND_ITEM_HEIGHT + 8 + + +def _contours(sheet: 'Sheet') -> Optional[str]: + """How far apart the contour lines are, as it is written: CONTOUR INTERVAL 40 FEET.""" + interval, unit = sheet.contour_interval, CONTOUR_UNITS.get(sheet.contour_unit) + if not unit or not isinstance(interval, (int, float)) or not math.isfinite(interval) or interval <= 0: + return None + return f'CONTOUR INTERVAL {interval:,.10g} {unit}' + + +def _to_the_minute(angle: float) -> float: + return round(angle * 60) / 60 + + +def _decimal_year(date: Optional[str]) -> Optional[float]: + """A day (2026-11-15) as a year and a part of one, or None when it is not a day.""" + try: + day = datetime.date.fromisoformat(str(date).strip()[:10]) + first = datetime.date(day.year, 1, 1) + return day.year + (day - first).days / (datetime.date(day.year + 1, 1, 1) - first).days + except ValueError: + # Not a day, or one with no year after it. + return None + + +def _format_scale(scale: float) -> str: + """1:24,000. A map's scale is not known closer than three figures.""" + digits = max(0, math.floor(math.log10(scale)) - 2) + return f'1:{round(scale / 10 ** digits) * 10 ** digits:,}' + + +def _grid_meters(plan: 'SheetPlan') -> int: + """How far apart the lines of the map's grid are.""" + (low_e, high_e), (low_n, high_n) = _utm_extent(plan) + meters = GRID_METERS + while (high_e - low_e) / meters > GRID_MAX_LINES or (high_n - low_n) / meters > GRID_MAX_LINES: + meters *= 10 + return meters + + +def _utm_extent(plan: 'SheetPlan') -> Tuple[Tuple[float, float], Tuple[float, float]]: + """The least and greatest easting, and northing, on the map.""" + west, south, east, north = plan.bounds + places = [to_utm(lat, lon, plan.zone, plan.south_hemisphere) + for lat in (south, (south + north) / 2, north) for lon in (west, (west + east) / 2, east)] + eastings, northings = [i[0] for i in places], [i[1] for i in places] + return (min(eastings), max(eastings)), (min(northings), max(northings)) + + +def plan_sheet(map_width: float, map_height: float, bounds: Sequence[float], sheet: Sheet) -> SheetPlan: + """Where a map of `map_width` by `map_height` points, between `bounds` (west, south, east, north), goes on a + sheet, and what is written under it.""" + west, south, east, north = bounds + plan = SheetPlan(width=0, height=0, map_rect=(0, 0, 0, 0), bounds=(west, south, east, north), + scale=map_scale(map_width, bounds), name=_latin(sheet.name) if sheet.name else None) + middle = _middle_latitude(south, north), (west + east) / 2 + # By its middle: the edges of a map are a hair outside it, and a map which ends where the zones do has a grid. + if UTM_SOUTH <= middle[0] <= UTM_NORTH: + plan.zone = utm_zone(middle[1]) + + notes = [f'Scale {_format_scale(plan.scale)} at the middle of the map. Projection: Web Mercator.' + f' Datum: WGS 84. True north is up the page.'] + if plan.zone: + plan.grid_north = _grid_convergence(*middle, plan.zone, plan.south_hemisphere) + notes.append( + f'{_grid_meters(plan):,} meter grid: Universal Transverse Mercator, zone {plan.zone}' + f'{"S" if plan.south_hemisphere else "N"}. Grid north is {_north_of_true(plan.grid_north)} of true' + f' north at the middle of the map.') + year = _decimal_year(sheet.date) + plan.magnetic_north = magnetic.declination(*middle, year) if year else None + if plan.magnetic_north is not None: + model = magnetic.load_model() + # The shorter way around: a compass which passes due south goes from 180 west to 180 east. + yearly = (model.declination(*middle, year + 1) - plan.magnetic_north + 180) % 360 - 180 + notes.append( + f'Magnetic north is {_north_of_true(plan.magnetic_north)} of true north at the middle of the map on' + f' {_latin(sheet.date)}, and moves about {_east_or_west(yearly)} each year ({model.name}).') + names = [_latin(str(i)) for i in sheet.credits if str(i).strip()] + if names: + notes.append('Map data: ' + '; '.join(names)) + notes.append(f'Made with WROLPi, {_latin(sheet.date)}.' if sheet.date else 'Made with WROLPi.') + for note in notes: + plan.notes.extend(_wrap(note, map_width, NOTE_SIZE)) + plan.contours = _contours(sheet) + if map_width >= ADJOINING_MIN_WIDTH: + plan.adjoining = adjoining_quads(bounds) + + plan.legend_ground, plan.legend = legend_lines(sheet.legend) + + plan.width = map_width + 2 * MARGIN + plan.map_rect = (MARGIN, TOP_MARGIN, MARGIN + map_width, TOP_MARGIN + map_height) + plan.height = TOP_MARGIN + map_height + BARS_OFFSET + BAR_COUNT * BAR_SPACING \ + + (CONTOUR_LEADING if plan.contours else 0) + (ADJOINING_HEIGHT if plan.adjoining else 0) \ + + _legend_height(plan) + len(plan.notes) * NOTE_LEADING + BOTTOM_PADDING + return plan + + +def _clip(points: Sequence[Tuple[float, float]], rect: Sequence[float]) -> List[List[Tuple[float, float]]]: + """The parts of a line (through `points`) which are in a rectangle.""" + x0, y0, x1, y1 = rect + pieces, piece = [], [] + for (ax, ay), (bx, by) in zip(points, points[1:]): + # Liang-Barsky: the part of the way from a to b which is inside. + start, end = 0.0, 1.0 + dx, dy = bx - ax, by - ay + inside = True + for p, q in ((-dx, ax - x0), (dx, x1 - ax), (-dy, ay - y0), (dy, y1 - ay)): + if p == 0: + inside = inside and q >= 0 + elif p < 0: + start = max(start, q / p) + else: + end = min(end, q / p) + if not inside or start > end: + if piece: + pieces.append(piece) + piece = [] + continue + a, b = (ax + start * dx, ay + start * dy), (ax + end * dx, ay + end * dy) + if not piece or start > 0: + if piece: + pieces.append(piece) + piece = [a] + piece.append(b) + if end < 1: + pieces.append(piece) + piece = [] + if piece: + pieces.append(piece) + return [i for i in pieces if len(i) > 1] + + +class _Pen: + """Draws the lines and text of one PDF layer.""" + + def __init__(self, page, group: int): + self.shape = page.new_shape() + self.group = group + + def line(self, points: Sequence[Tuple[float, float]], width: float = 0.5, color=BLACK, opacity: float = 1, + dash: Sequence[float] = ()): + self.shape.draw_polyline(list(points)) + dashes = f'[{" ".join(f"{i:.2f}" for i in dash)}] 0' if dash else None + self.shape.finish(width=width, color=color, closePath=False, stroke_opacity=opacity, dashes=dashes, + lineCap=0, oc=self.group) + + def box(self, rect: Sequence[float], fill=None, width: float = 0.5, color=BLACK): + self.shape.draw_rect(rect) + self.shape.finish(width=width, color=color, fill=fill, oc=self.group) + + def polygon(self, points: Sequence[Tuple[float, float]], fill=BLACK): + self.shape.draw_polyline(list(points)) + self.shape.finish(width=0.3, color=BLACK, fill=fill, closePath=True, oc=self.group) + + def text(self, x: float, y: float, text: str, size: float = LABEL_SIZE, align: str = 'left', font: str = FONT, + color=BLACK): + """Write `text` with its baseline at `y`: starting at, ending at, or centered on `x`.""" + if align != 'left': + width = _text_width(text, size, font) + x -= width if align == 'right' else width / 2 + self.shape.insert_text((x, y), text, fontsize=size, fontname=font, color=color, oc=self.group) + + def commit(self): + self.shape.commit() + + +def _draw_graticule(pen: _Pen, plan: SheetPlan): + """The edge of the map, the coordinates of its corners, and ticks of latitude and longitude between them.""" + x0, y0, x1, y1 = plan.map_rect + west, south, east, north = plan.bounds + pen.box(plan.map_rect, width=0.75) + + above, below, beside = y0 - 4, y1 + LABEL_SIZE + 3, LABEL_SIZE * 0.35 + # The corners. + for longitude, x, align in ((west, x0, 'left'), (east, x1, 'right')): + label = format_angle(longitude, 'E', 'W') + pen.text(x, above, label, align=align) + pen.text(x, below, label, align=align) + for latitude, y in ((north, y0), (south, y1)): + label = format_angle(latitude, 'N', 'S') + pen.text(x0 - 3, y + beside, label, align='right') + pen.text(x1 + 3, y + beside, label) + + longitudes = _multiples(graticule_interval(east - west), west, east) + latitudes = _multiples(graticule_interval(north - south), south, north) + for longitude in longitudes: + x = plan.point(north, longitude)[0] + pen.line([(x, y0), (x, y0 + TICK_LENGTH)]) + pen.line([(x, y1), (x, y1 - TICK_LENGTH)]) + label = format_angle(longitude, short=True) + pen.text(x, above, label, align='center') + pen.text(x, below, label, align='center') + for latitude in latitudes: + y = plan.point(latitude, west)[1] + pen.line([(x0, y), (x0 + TICK_LENGTH, y)]) + pen.line([(x1, y), (x1 - TICK_LENGTH, y)]) + label = format_angle(latitude, short=True) + pen.text(x0 - 3, y + beside, label, align='right') + pen.text(x1 + 3, y + beside, label) + # A cross where a tick of latitude meets one of longitude. + for latitude in latitudes: + for longitude in longitudes: + x, y = plan.point(latitude, longitude) + pen.line([(x - CROSS_LENGTH, y), (x + CROSS_LENGTH, y)]) + pen.line([(x, y - CROSS_LENGTH), (x, y + CROSS_LENGTH)]) + + +def _graticule_labels(plan: SheetPlan) -> Tuple[List[Tuple[float, float]], List[Tuple[float, float]]]: + """Where along the top and bottom (x), and the sides (y), the margin is taken by a coordinate: each a + (low, high) the grid's labels keep out of.""" + x0, y0, x1, y1 = plan.map_rect + west, south, east, north = plan.bounds + corner = _text_width(format_angle(-179.875, 'E', 'W'), LABEL_SIZE) + 4 + tick = _text_width(format_angle(0.125, short=True), LABEL_SIZE) / 2 + 3 + across = [(x0 - 1, x0 + corner), (x1 - corner, x1 + 1)] + for longitude in _multiples(graticule_interval(east - west), west, east): + x = plan.point(north, longitude)[0] + across.append((x - tick, x + tick)) + up = [(y0 - LABEL_SIZE, y0 + LABEL_SIZE), (y1 - LABEL_SIZE, y1 + LABEL_SIZE)] + for latitude in _multiples(graticule_interval(north - south), south, north): + y = plan.point(latitude, west)[1] + up.append((y - LABEL_SIZE, y + LABEL_SIZE)) + return across, up + + +def _draw_grid(pen: _Pen, plan: SheetPlan): + """The UTM grid over the map, and what each of its lines is in the margin.""" + x0, y0, x1, y1 = plan.map_rect + zone, south = plan.zone, plan.south_hemisphere + meters = _grid_meters(plan) + (low_e, high_e), (low_n, high_n) = _utm_extent(plan) + taken_across, taken_up = _graticule_labels(plan) + beside = LABEL_SIZE * 0.35 + # A line of the grid is not quite straight on the map, so it is drawn through this many places. + steps = 24 + + def free(position: float, half: float, taken: List[Tuple[float, float]]) -> bool: + return all(position + half < low or position - half > high for low, high in taken) + + # On each edge of the map the first line which is named is named in full (339000mE), and the others by their + # kilometers (340). + named = set() + + def label(value: int, edge: str, letter: str) -> str: + return f'{value // 1000}' if edge in named else f'{value}m{letter}' + + for easting in range(math.ceil(low_e / meters) * meters, math.floor(high_e / meters) * meters + 1, meters): + northings = [low_n - meters + i * (high_n - low_n + 2 * meters) / steps for i in range(steps + 1)] + points = [plan.point(*from_utm(easting, northing, zone, south)) for northing in northings] + for piece in _clip(points, plan.map_rect): + pen.line(piece, width=0.4, color=GRID_COLOR, opacity=0.7) + for x, y in (piece[0], piece[-1]): + if abs(y - y0) > 0.01 and abs(y - y1) > 0.01: + continue + edge = 'top' if abs(y - y0) <= 0.01 else 'bottom' + text = label(easting, edge, 'E') + if not free(x, _text_width(text, LABEL_SIZE) / 2 + 2, taken_across): + continue + pen.text(x, y0 - 4 if edge == 'top' else y1 + LABEL_SIZE + 3, text, align='center', + color=GRID_COLOR) + named.add(edge) + + for northing in range(math.ceil(low_n / meters) * meters, math.floor(high_n / meters) * meters + 1, meters): + eastings = [low_e - meters + i * (high_e - low_e + 2 * meters) / steps for i in range(steps + 1)] + points = [plan.point(*from_utm(easting, northing, zone, south)) for easting in eastings] + for piece in _clip(points, plan.map_rect): + pen.line(piece, width=0.4, color=GRID_COLOR, opacity=0.7) + for x, y in (piece[0], piece[-1]): + if abs(x - x0) > 0.01 and abs(x - x1) > 0.01 or not free(y, LABEL_SIZE / 2, taken_up): + continue + edge = 'left' if abs(x - x0) <= 0.01 else 'right' + text = label(northing, edge, 'N') + if edge == 'left': + pen.text(x0 - 3, y + beside, text, align='right', color=GRID_COLOR) + else: + pen.text(x1 + 3, y + beside, text, color=GRID_COLOR) + named.add(edge) + + +def _draw_scale_bar(pen: _Pen, center: float, y: float, unit: float, name: str, most: int, parts: int, + available: float, number=str) -> float: + """A bar which is `unit` points for each unit of distance, with its top at `y`. It has one unit left of its + zero, divided in `parts`, and as many to the right as there is room for, up to `most`. Returns how long the + bar is: nothing, when there is no room for it.""" + count = min(most, int(available // unit) - 1) + if count < 1: + return 0 + left = center - (count + 1) * unit / 2 + zero = left + unit + for i in range(parts): + fill = BLACK if i % 2 == 0 else None + pen.box((left + i * unit / parts, y, left + (i + 1) * unit / parts, y + BAR_HEIGHT), fill=fill, width=0.4) + for i in range(count): + fill = BLACK if i % 2 == 0 else None + pen.box((zero + i * unit, y, zero + (i + 1) * unit, y + BAR_HEIGHT), fill=fill, width=0.4) + pen.text(left, y - 2.5, number(1), align='center') + for i in range(count + 1): + pen.text(zero + i * unit, y - 2.5, number(i), align='center') + pen.text(zero + count * unit + 12, y + BAR_HEIGHT, name) + return (count + 1) * unit + + +# The diagram of the norths: how long the line to each is (points), and the least and the most it is drawn from +# straight up (degrees). The diagram shows which side each north is on, not how far: the angles are written. +NORTH_LENGTHS = dict(true=62, magnetic=50, grid=38) +NORTH_LEAST, NORTH_MOST = 7, 30 +# How wide the diagram is, with what is written beside its lines. +NORTHS_WIDTH = 100 + + +def _north_tip(x: float, y: float, angle: float, length: float) -> Tuple[float, float]: + """Where the line to a north ends: drawn to its side of straight up, but never so near it, or so far from it, + that it can not be told apart.""" + shown = math.radians(math.copysign(min(NORTH_MOST, max(NORTH_LEAST, abs(angle))), angle)) + return x + length * math.sin(shown), y - length * math.cos(shown) + + +def _draw_norths(pen: _Pen, plan: SheetPlan, x: float, y: float): + """Which way true north, the grid's north and a compass's north are from each other, from a point at + (`x`, `y`), with how far each is from true north written under it.""" + top = y - NORTH_LENGTHS['true'] + pen.line([(x, y), (x, top)], width=0.6) + # True north is at a star. + star = [(x + r * math.sin(math.radians(36 * i)), top - 5 - r * math.cos(math.radians(36 * i))) + for i, r in zip(range(10), (5, 2) * 5)] + pen.polygon(star) + below = y + LABEL_SIZE + 4 + for name, angle, length in (('MN', plan.magnetic_north, NORTH_LENGTHS['magnetic']), + ('GN', plan.grid_north, NORTH_LENGTHS['grid'])): + if angle is None: + continue + tip_x, tip_y = _north_tip(x, y, angle, length) + pen.line([(x, y), (tip_x, tip_y)], width=0.6) + east = angle >= 0 + pen.text(tip_x + (3 if east else -3), tip_y + 2, name, align='left' if east else 'right') + pen.text(x, below, f'{name} {format_angle(_to_the_minute(abs(angle)))} {"E" if east else "W"}' + f' {_mils(angle).upper()}', align='center') + below += LABEL_SIZE + 2 + + +def _draw_adjoining(pen: _Pen, plan: SheetPlan, x: float, y: float): + """The quadrangles around the map: nine squares with the map the middle one, each of the others with a + number, and beside them what each number is called. Its top left is at (`x`, `y`).""" + pen.text(x, y + LABEL_SIZE, 'ADJOINING QUADRANGLES') + top = y + LABEL_SIZE + 5 + side = ADJOINING_SQUARE + pen.box((x + side, top + side, x + 2 * side, top + 2 * side), fill=ADJOINING_GRAY, width=0.4) + for i in range(4): + pen.line([(x + i * side, top), (x + i * side, top + 3 * side)], width=0.4) + pen.line([(x, top + i * side), (x + 3 * side, top + i * side)], width=0.4) + # The names are in two columns: as wide as a long name, or as the room beside the squares allows. + left = x + 3 * side + 12 + column = min(ADJOINING_COLUMN, (plan.map_rect[2] - left) / 2) + listed = 0 + for number, ((columns, rows), name) in enumerate(zip(ADJOINING, plan.adjoining), start=1): + if not name: + continue + pen.text(x + (columns + 1.5) * side, top + (1.5 - rows) * side + LABEL_SIZE / 3, str(number), align='center') + while _text_width(f'{number} {name}', LABEL_SIZE) > column - 6 and len(name) > 1: + name = name[:-1] + pen.text(left + (listed // 4) * column, top + LABEL_SIZE + (listed % 4) * (LABEL_SIZE + 2.5), + f'{number} {name}') + listed += 1 + + +def _draw_legend(pen: _Pen, plan: SheetPlan, x: float, y: float): + """What the lines of the map are: a piece of each as the map draws it, on the color of the map's land, with + what it is called beside it. Its top left is at (`x`, `y`).""" + pen.text(x, y + LABEL_SIZE, 'LEGEND') + top = y + LABEL_SIZE + 8 + columns = _legend_columns(plan) + for index, line in enumerate(plan.legend): + left = x + (index % columns) * LEGEND_ITEM_WIDTH + row = top + (index // columns) * LEGEND_ITEM_HEIGHT + box = (left, row, left + LEGEND_SAMPLE, row + LEGEND_ITEM_HEIGHT - 3) + pen.box(box, fill=plan.legend_ground, width=0.3, color=GRAY) + middle = (box[1] + box[3]) / 2 + ends = [(left + 1, middle), (left + LEGEND_SAMPLE - 1, middle)] + if line.casing_color and line.casing_width > line.width: + pen.line(ends, width=line.casing_width, color=line.casing_color) + pen.line(ends, width=line.width, color=line.color, opacity=line.opacity, dash=line.dash) + # A name longer than the room beside its line is cut to it. + label = line.label + while _text_width(label, LABEL_SIZE) > LEGEND_ITEM_WIDTH - LEGEND_SAMPLE - 10 and len(label) > 1: + label = label[:-1] + pen.text(left + LEGEND_SAMPLE + 5, middle + LABEL_SIZE / 3, label) + + +def _draw_margin(pen: _Pen, plan: SheetPlan): + """The title above the map, and the scale and the notes below it.""" + x0, y0, x1, y1 = plan.map_rect + scale = _format_scale(plan.scale) + title_y = y0 - 24 + if not plan.name: + pen.text(x1, title_y, scale, size=TITLE_SIZE, font=BOLD, align='right') + elif _text_width(plan.name, TITLE_SIZE, BOLD) + _text_width(scale, TITLE_SIZE, BOLD) + TITLE_GAP <= x1 - x0: + pen.text(x0, title_y, plan.name, size=TITLE_SIZE, font=BOLD) + pen.text(x1, title_y, scale, size=TITLE_SIZE, font=BOLD, align='right') + else: + # A map too narrow for both (a quadrangle near a pole is two inches wide) has the scale under the name. + pen.text(x0, title_y - TITLE_LEADING, plan.name, size=TITLE_SIZE, font=BOLD) + pen.text(x0, title_y, scale, size=TITLE_SIZE, font=BOLD) + + center = (x0 + x1) / 2 + y = y1 + BARS_OFFSET + pen.text(center, y - 16, f'SCALE {scale}', size=NOTE_SIZE + 1, align='center') + # The room a bar has: the map's width, less the name of its unit on each side (so it stays centered). + available = (x1 - x0) - 2 * (_text_width('KILOMETERS', LABEL_SIZE) + 14) + meter = 1 / (plan.scale * METERS_PER_POINT) + bars = [ + _draw_scale_bar(pen, center, y, 1000 * meter, 'KILOMETERS', 2, 10, available), + _draw_scale_bar(pen, center, y + BAR_SPACING, 1000 * meter, 'METERS', 2, 2, available, + number=lambda i: str(i * 1000)), + _draw_scale_bar(pen, center, y + 2 * BAR_SPACING, METERS_PER_MILE * meter, 'MILES', 1, 4, available), + _draw_scale_bar(pen, center, y + 3 * BAR_SPACING, 1000 * METERS_PER_FOOT * meter, 'FEET', 7, 2, available, + number=lambda i: str(i * 1000)), + ] + # The norths are left of the bars, where there is room for them. + if (plan.grid_north is not None or plan.magnetic_north is not None) \ + and center - max(bars) / 2 - x0 >= NORTHS_WIDTH + 10: + _draw_norths(pen, plan, x0 + NORTHS_WIDTH / 2, y + (BAR_COUNT - 1) * BAR_SPACING - 12) + + y += BAR_COUNT * BAR_SPACING + if plan.contours: + pen.text(center, y - 4, plan.contours, size=NOTE_SIZE + 1, align='center') + y += CONTOUR_LEADING + if plan.adjoining: + _draw_adjoining(pen, plan, x0, y - NOTE_LEADING) + y += ADJOINING_HEIGHT + if plan.legend: + _draw_legend(pen, plan, x0, y - NOTE_LEADING) + y += _legend_height(plan) + for index, note in enumerate(plan.notes): + pen.text(x0, y + index * NOTE_LEADING, note, size=NOTE_SIZE) + + +def draw_sheet(doc, page, plan: SheetPlan): + """Draw the sheet on the page of a map: the grid over the map, and everything around it.""" + if plan.zone: + grid = _Pen(page, doc.add_ocg(GRID_LAYER, on=True)) + _draw_grid(grid, plan) + grid.commit() + pen = _Pen(page, doc.add_ocg(SHEET_LAYER, on=True)) + _draw_graticule(pen, plan) + _draw_margin(pen, plan) + pen.commit() diff --git a/modules/map/static/index.html b/modules/map/static/index.html index e9125804..e0a5a098 100644 --- a/modules/map/static/index.html +++ b/modules/map/static/index.html @@ -294,6 +294,26 @@ style: function(file) { return dataPath(file.style_map_path); }, }; + // How a terrain file is read (js/terrain.js, shared with the app's map viewer). Until it is + // loaded, and if it can not be, a terrain file is read as the one WROLPi offers is. + var Terrain = { + terrainMaxZoom: function() { return 8; }, + contourThresholds: function(imperial) { + return imperial + ? {4: [1000, 5000], 5: [500, 2500], 6: [200, 1000], 7: [200, 1000], 8: [100, 500]} + : {4: [500, 2500], 5: [200, 1000], 6: [100, 500], 7: [100, 500], 8: [50, 200]}; + }, + }; + var terrainFile = null; + var terrainZoom = 8; + + function loadTerrain() { + if (!hasTerrain) return Promise.resolve(); + return import("/js/terrain.js") + .then(function(module) { Terrain = module; }) + .catch(function(err) { console.error("Deeper terrain is not available:", err); }); + } + function loadOverlays(files) { if (!files.length) return Promise.resolve(); return Promise.all([import("/js/overlays.js"), import("/js/overlayStyle.js")]) @@ -409,6 +429,11 @@ } } + // The labels of every basemap file are over the ground of every file (as labelsOverGround in + // js/overlays.js, which may not have been loaded yet). + allLayers = allLayers.filter(function(l) { return l.type !== "symbol"; }) + .concat(allLayers.filter(function(l) { return l.type === "symbol"; })); + // Terrain (hillshade + contours). if (hasTerrain && demSource) { var savedVis = getSavedVisibility(); @@ -444,13 +469,10 @@ elevationKey: "ele", levelKey: "level", multiplier: isImperial ? 3.28084 : 1, - thresholds: isImperial ? { - 4: [1000, 5000], 5: [500, 2500], 6: [200, 1000], 7: [200, 1000], 8: [100, 500], - } : { - 4: [500, 2500], 5: [200, 1000], 6: [100, 500], 7: [100, 500], 8: [50, 200], - }, + // As fine as the terrain file can bear (js/terrain.js). + thresholds: Terrain.contourThresholds(isImperial, terrainZoom), }); - sources["contours"] = { type: "vector", tiles: [contourUrl], maxzoom: 8 }; + sources["contours"] = { type: "vector", tiles: [contourUrl], maxzoom: terrainZoom }; var textColor = flavor === "dark" ? "rgba(210,180,140,0.9)" : "rgba(150,100,50,0.8)"; var haloColor = flavor === "dark" ? "rgba(0,0,0,0.8)" : "rgba(255,255,255,0.8)"; @@ -954,6 +976,7 @@ : (f.name.startsWith(TERRAIN_PREFIX) && f.name.endsWith('.pmtiles')); if (isTerrain) { terrainFileName = f.mapPath; + terrainFile = f; hasTerrain = true; } else if (f.kind === "overlay") { // Not the basemap schema: offered in the layer panel, drawn as itself. @@ -986,16 +1009,18 @@ .then(function(r) { hasPlanetOverview = r.ok; }) .catch(function() { hasPlanetOverview = false; }) .then(function() { return loadOverlays(overlayCandidates); }) + .then(function() { return loadTerrain(); }) .then(function() { return pmtilesFiles; }); }) .then(function(pmtilesFiles) { // Initialize contour source if terrain available. if (hasTerrain && !demSource) { + terrainZoom = Terrain.terrainMaxZoom(terrainFile); demSource = new mlcontour.DemSource({ url: "pmtiles://" + window.location.origin + dataPath(terrainFileName), encoding: "terrarium", - maxzoom: 8, + maxzoom: terrainZoom, worker: true, }); demSource.setupMaplibre(maplibregl); diff --git a/modules/map/static/js/overlays.js b/modules/map/static/js/overlays.js index 05b47006..640a740d 100644 --- a/modules/map/static/js/overlays.js +++ b/modules/map/static/js/overlays.js @@ -252,10 +252,17 @@ export function buildOverlayLayers(file, state) { return styleLayers; } -// The style layers of every overlay, in the order they are drawn. A raster overlay goes under the -// basemap's labels (`rasters`) so the map stays readable; vector overlays go on top (`vectors`): an -// overlay with its own style in that style's order, then the generic ones, fills under lines under -// points. +// Whether a layer of an overlay is of its labels: its text, its icons, and the points it marks. The +// rest of an overlay is its ground: areas, lines, pictures. +export function isOverlayLabelLayer(layer) { + return layer?.type === "symbol" || layer?.type === "circle"; +} + +// The style layers of every overlay, in the order they are drawn. Labels are always on top: the +// ground of every overlay goes under the basemap's labels (`under`), so an area an overlay fills +// does not cover the name of what is in it, and the labels of every overlay go over them (`over`). +// In each, a raster is lowest, then an overlay with its own style in that style's order, then the +// generic ones, fills under lines under points. export function orderOverlayLayers(overlays, state) { const rasters = []; const styled = []; @@ -271,7 +278,49 @@ export function orderOverlayLayers(overlays, state) { else generic[layer.type].push(layer); } } - return {rasters, vectors: [...styled, ...generic.fill, ...generic.line, ...generic.circle]}; + const vectors = [...styled, ...generic.fill, ...generic.line, ...generic.circle]; + return { + under: [...rasters, ...vectors.filter(layer => !isOverlayLabelLayer(layer))], + over: vectors.filter(isOverlayLabelLayer), + }; +} + +// The layers of a basemap with every label over all of its ground: the ground in the order it was +// in, then the labels in the order they were in. +// +// A map of several basemap files is their layers one file after another, so the labels of each file +// but the last are under the land, the water and the roads of the files after it, and under +// anything which is put under "the labels". Labels are always on top. +export function labelsOverGround(layers) { + layers = layers || []; + return [...layers.filter(l => l.type !== "symbol"), ...layers.filter(l => l.type === "symbol")]; +} + +// The source of the contour lines both viewers draw from the terrain. They are added to a style +// after the basemap's labels, lines and labels both, and are not of the basemap. +const CONTOUR_SOURCE = "contours"; + +// Where the basemap's labels begin: the index of the first of the labels which are over all of the +// basemap's ground. Where no label is over its ground, the index after the last of its ground. +// +// Not the map's first label: a map of several basemap files has the labels of the first file under +// the ground of the next, and an overlay put there would be under the land and the water of every +// file after the first. Nor before the last layer which is not a label: the contour lines are +// drawn after the basemap's labels, and an overlay put under them would be over every label. +export function basemapLabelsStart(layers) { + layers = layers || []; + const ofBasemap = layer => !isOverlayLayerId(layer.id) && layer.source !== CONTOUR_SOURCE; + let lastGround = -1; + for (let i = layers.length - 1; i >= 0; i--) { + if (ofBasemap(layers[i]) && layers[i].type !== "symbol") { + lastGround = i; + break; + } + } + for (let i = lastGround + 1; i < layers.length; i++) { + if (ofBasemap(layers[i]) && layers[i].type === "symbol") return i; + } + return lastGround + 1; } // Add the overlays to a style's sources and layers (the basemap's are already there). @@ -279,10 +328,9 @@ export function addOverlaysToStyle(styleSources, allLayers, overlays, state, url for (const file of overlays || []) { styleSources[overlaySourceId(file)] = buildOverlaySource(file, urls); } - const {rasters, vectors} = orderOverlayLayers(overlays, state); - const firstLabel = allLayers.findIndex(l => l.type === "symbol"); - allLayers.splice(firstLabel === -1 ? allLayers.length : firstLabel, 0, ...rasters); - allLayers.push(...vectors); + const {under, over} = orderOverlayLayers(overlays, state); + allLayers.splice(basemapLabelsStart(allLayers), 0, ...under); + allLayers.push(...over); } // Add the overlays to a map whose style has loaded, a layer at a time. For a viewer which cannot @@ -295,8 +343,9 @@ export function addOverlaysToMap(map, overlays, state, urls) { const id = overlaySourceId(file); if (!map.getSource(id)) map.addSource(id, buildOverlaySource(file, urls)); } - const firstLabel = (map.getStyle()?.layers || []).find(l => l.type === "symbol"); - const {rasters, vectors} = orderOverlayLayers(overlays, state); + const mapLayers = map.getStyle()?.layers || []; + const firstLabel = mapLayers[basemapLabelsStart(mapLayers)]; + const {under, over} = orderOverlayLayers(overlays, state); const add = (layer, before) => { if (map.getLayer(layer.id)) return; try { @@ -307,8 +356,8 @@ export function addOverlaysToMap(map, overlays, state, urls) { refused[mapPath] = (refused[mapPath] || 0) + 1; } }; - for (const layer of rasters) add(layer, firstLabel?.id); - for (const layer of vectors) add(layer, undefined); + for (const layer of under) add(layer, firstLabel?.id); + for (const layer of over) add(layer, undefined); return refused; } diff --git a/modules/map/static/js/terrain.js b/modules/map/static/js/terrain.js new file mode 100644 index 00000000..8cdc3715 --- /dev/null +++ b/modules/map/static/js/terrain.js @@ -0,0 +1,59 @@ +// How the map reads a terrain (elevation) file: how deep into it to look, and how far apart the +// contour lines are. Shared by the app's map viewer and the standalone viewer, which loads a copy +// of this file as it is: no imports from the app, no dependencies. + +// How deep the terrain file which WROLPi offers goes, and what a file is taken to be when it does +// not say. +export const DEFAULT_TERRAIN_MAX_ZOOM = 8; +// No terrain file is read deeper than this. +const DEEPEST_TERRAIN_ZOOM = 15; + +// How far apart the contour lines are at each zoom of the map: [minor, major], in the unit the map +// measures in. A zoom between two of these uses the one below it. +// +// A 1:24,000 sheet has a line every 40 feet (or 20 meters), which is what the deepest have: finer +// lines than that are more than the terrain says, and more than a hillside has room for. +const CONTOUR_FEET = { + 4: [1000, 5000], 5: [500, 2500], 6: [200, 1000], 7: [200, 1000], 8: [100, 500], + 9: [100, 500], 10: [100, 500], 11: [40, 200], 12: [40, 200], +}; +const CONTOUR_METERS = { + 4: [500, 2500], 5: [200, 1000], 6: [100, 500], 7: [100, 500], 8: [50, 200], + 9: [50, 200], 10: [50, 200], 11: [20, 100], 12: [20, 100], +}; + +// How deep a terrain file goes: the deepest zoom it has tiles of. `file` is as the API lists it. +export function terrainMaxZoom(file) { + const zoom = Number(file && file.max_zoom); + if (!Number.isInteger(zoom) || zoom < 1) return DEFAULT_TERRAIN_MAX_ZOOM; + return Math.min(zoom, DEEPEST_TERRAIN_ZOOM); +} + +// The contour intervals for a terrain file which goes as deep as `maxZoom`. +// +// Only those the file can bear: lines 40 feet apart drawn from terrain too coarse for them are +// drawn where no line is. A map zoomed in past the file's depth keeps the file's finest interval. +export function contourThresholds(imperial, maxZoom) { + const all = imperial ? CONTOUR_FEET : CONTOUR_METERS; + const deepest = Number.isFinite(maxZoom) ? maxZoom : DEFAULT_TERRAIN_MAX_ZOOM; + const lowest = Math.min(...Object.keys(all).map(Number)); + const thresholds = {}; + for (const [zoom, intervals] of Object.entries(all)) { + // A file shallower than every interval still has contours: the coarsest. + if (Number(zoom) <= deepest || Number(zoom) === lowest) thresholds[zoom] = intervals; + } + return thresholds; +} + +// How far apart the contour lines are on a map drawn at `zoom` from a terrain file which goes as +// deep as `maxZoom`: [minor, major], or null when no line is drawn at that zoom. +// +// The lines of a map are made a tile at a time: for tiles of the map's zoom, or of the file's +// deepest when the map is zoomed in past it, with the interval of the nearest zoom below. +export function contourInterval(imperial, maxZoom, zoom) { + const thresholds = contourThresholds(imperial, maxZoom); + const deepest = Number.isFinite(maxZoom) ? maxZoom : DEFAULT_TERRAIN_MAX_ZOOM; + const tileZoom = Math.min(Math.floor(zoom), deepest); + const zooms = Object.keys(thresholds).map(Number).filter(i => i <= tileZoom); + return zooms.length ? thresholds[Math.max(...zooms)] : null; +} diff --git a/modules/map/test/test_export.py b/modules/map/test/test_export.py new file mode 100644 index 00000000..a0e7ce3f --- /dev/null +++ b/modules/map/test/test_export.py @@ -0,0 +1,581 @@ +import io +import json +import math +import re +import subprocess +import sys +from http import HTTPStatus +from unittest import mock + +import pymupdf +import pytest +from PIL import Image + +from modules.map import export +from modules.map.export import ExportLayer, InvalidExport, build_layered_pdf +from wrolpi.jobs import wait_for_job + +WIDTH, HEIGHT = 60, 90 + + +def make_image(color=(200, 80, 20, 255), size=(WIDTH, HEIGHT), image_format='PNG', box=None) -> bytes: + """An image of a layer: transparent, with `color` in `box` (all of it by default).""" + image = Image.new('RGBA', size, (0, 0, 0, 0)) + image.paste(color, box or (0, 0, *size)) + if image_format == 'JPEG': + image = image.convert('RGB') + data = io.BytesIO() + image.save(data, image_format) + return data.getvalue() + + +BLANK = make_image(color=(0, 0, 0, 0)) + + +def layer_names(pdf: bytes) -> list: + doc = pymupdf.open(stream=pdf, filetype='pdf') + return [i['name'] for _, i in sorted(doc.get_ocgs().items())] + + +def test_layers_are_pdf_layers(): + """Each image of the map is in a PDF layer of its own, named and in the order given, on one page the size + the map is at its DPI.""" + pdf = build_layered_pdf([ + ExportLayer('Background', make_image((240, 240, 230, 255))), + ExportLayer('Water', make_image((60, 120, 220, 255), box=(0, 0, 30, 90))), + ExportLayer('Satellite', make_image(image_format='JPEG')), + ], WIDTH, HEIGHT, dpi=300, title='40°15′N 105°07′30″W') + + doc = pymupdf.open(stream=pdf, filetype='pdf') + assert doc.page_count == 1 + page = doc[0] + # 60x90 pixels at 300 DPI is 0.2x0.3 inches: 14.4x21.6 points. + assert (round(page.rect.width, 3), round(page.rect.height, 3)) == (14.4, 21.6) + assert layer_names(pdf) == ['Background', 'Water', 'Satellite'] + assert all(i['on'] for i in doc.get_ocgs().values()) + assert doc.metadata['title'] == '40°15′N 105°07′30″W' + + # Every image fills the page, and is the picture it was given. + images = page.get_image_info(xrefs=True) + assert len(images) == 3 + for image in images: + assert (image['width'], image['height']) == (WIDTH, HEIGHT) + assert pymupdf.Rect(image['bbox']) == page.rect + + # The page looks like the layers stacked: water over the background on the left... but the satellite image + # is on top of both, and is all one color. + pixmap = page.get_pixmap(dpi=300) + assert pixmap.pixel(5, 5)[:3] == pixmap.pixel(55, 85)[:3] + + +def test_layers_are_stacked_in_order(): + """The first layer is at the bottom: what is above it covers it, and shows it where it is transparent.""" + pdf = build_layered_pdf([ + ExportLayer('Background', make_image((255, 255, 255, 255))), + ExportLayer('Water', make_image((0, 0, 255, 255), box=(0, 0, 30, 90))), + ], WIDTH, HEIGHT, dpi=72) + pixmap = pymupdf.open(stream=pdf, filetype='pdf')[0].get_pixmap(dpi=72) + assert pixmap.pixel(10, 45) == (0, 0, 255) + assert pixmap.pixel(50, 45) == (255, 255, 255) + + +def test_hidden_layer_is_not_drawn(): + """A layer of the PDF can be turned off, which is the point of there being layers.""" + pdf = build_layered_pdf([ + ExportLayer('Background', make_image((255, 255, 255, 255))), + ExportLayer('Water', make_image((0, 0, 255, 255))), + ], WIDTH, HEIGHT, dpi=72) + doc = pymupdf.open(stream=pdf, filetype='pdf') + assert doc[0].get_pixmap(dpi=72).pixel(10, 45) == (0, 0, 255) + + # As a reader does it: clear the layer's box in the list of layers. + water, = [i['number'] for i in doc.layer_ui_configs() if i['text'] == 'Water'] + doc.set_layer_ui_config(water, action=2) + assert doc[0].get_pixmap(dpi=72).pixel(10, 45) == (255, 255, 255) + + +def test_blank_layer_is_left_out(): + """A layer in which nothing was drawn (no tunnels in this quadrangle) is not a layer of the PDF.""" + pdf = build_layered_pdf([ + ExportLayer('Background', make_image()), + ExportLayer('Roads - Tunnels', BLANK), + ExportLayer('Labels', make_image(box=(1, 1, 2, 2))), + ], WIDTH, HEIGHT, dpi=300) + assert layer_names(pdf) == ['Background', 'Labels'] + + with pytest.raises(InvalidExport, match='Nothing is drawn'): + build_layered_pdf([ExportLayer('Roads - Tunnels', BLANK)], WIDTH, HEIGHT, dpi=300) + + +@pytest.mark.parametrize('layers,width,height,dpi,error', [ + ([], WIDTH, HEIGHT, 300, 'no layers'), + ([ExportLayer('A', make_image())] * (export.MAX_LAYERS + 1), WIDTH, HEIGHT, 300, 'more than'), + # Not the size the map is said to be. + ([ExportLayer('A', make_image(size=(61, 90)))], WIDTH, HEIGHT, 300, '61x90'), + # Not an image, and not a kind of image the map is drawn as. + ([ExportLayer('A', b'not an image')], WIDTH, HEIGHT, 300, 'not a readable image'), + ([ExportLayer('A', make_image(image_format='GIF'))], WIDTH, HEIGHT, 300, 'not a PNG or JPEG'), + # Sizes no map is. + ([ExportLayer('A', make_image())], 0, HEIGHT, 300, '0x90'), + ([ExportLayer('A', make_image())], export.MAX_SIDE + 1, 10, 300, 'can not be exported'), + ([ExportLayer('A', make_image())], 10000, 10000, 300, 'can not be exported'), + # Each layer is a size a map is, but all of them together are more than there is memory for. + ([ExportLayer('A', b'never decoded')] * 30, 6000, 8000, 300, 'too large to export'), + ([ExportLayer('A', make_image())], WIDTH, HEIGHT, 0, 'DPI'), + ([ExportLayer('A', make_image())], WIDTH, HEIGHT, 5000, 'DPI'), +]) +def test_invalid_export(layers, width, height, dpi, error): + with pytest.raises(InvalidExport, match=error): + build_layered_pdf(layers, width, height, dpi) + + +async def api_export(async_client, images, **meta): + """Export a map through the API, as the browser does: describe it, send the image of each layer, have the PDF + made, and fetch it. Returns the response which ended it (the PDF's, or the first to refuse) and the Job's + record (None when it did not get as far as a Job).""" + meta = dict(dict(width=WIDTH, height=HEIGHT, dpi=300, layers=[name for name, _ in images]), **meta) + request, response = await async_client.post('/api/map/export', json=meta) + if response.status_code != HTTPStatus.CREATED: + return response, None + export_id = response.json['export_id'] + for index, (_, image) in enumerate(images): + request, response = await async_client.post(f'/api/map/export/{export_id}/layer/{index}', content=image) + if response.status_code != HTTPStatus.NO_CONTENT: + return response, None + request, response = await async_client.post(f'/api/map/export/{export_id}/start') + if response.status_code != HTTPStatus.ACCEPTED: + return response, None + job = await wait_for_job(response.json['job_id'], timeout=60) + request, response = await async_client.get(f'/api/map/export/{export_id}/pdf') + return response, job + + +@pytest.mark.asyncio +async def test_api_export_pdf(async_client): + """The images of a map's layers are sent, a Job makes the PDF of them, and the PDF is fetched.""" + response, job = await api_export(async_client, [ + ('Background', make_image((240, 240, 230, 255))), + ('Roads - Tunnels', BLANK), + ('Water', make_image((60, 120, 220, 255), box=(0, 0, 30, 90))), + ], title='A quadrangle') + assert job['status'] == 'complete', job + assert job['progress'] == 100 + assert job['description'] == 'Map PDF: A quadrangle' + assert response.status_code == HTTPStatus.OK, response.text + assert response.headers['content-type'] == 'application/pdf' + assert response.content.startswith(b'%PDF-') + assert layer_names(response.content) == ['Background', 'Water'] + assert pymupdf.open(stream=response.content, filetype='pdf').metadata['title'] == 'A quadrangle' + + +@pytest.mark.asyncio +async def test_api_export_pdf_invalid(async_client): + """What is not a map is refused before any image is sent, and why is said.""" + # No description of the map. + request, response = await async_client.post('/api/map/export', content=b'not json') + assert response.status_code == HTTPStatus.BAD_REQUEST + assert 'description of the map' in response.json['error'] + request, response = await async_client.post('/api/map/export', json=['a', 'list']) + assert response.status_code == HTTPStatus.BAD_REQUEST + + # A description which is not of a map. + response, _ = await api_export(async_client, [('A', make_image())], width='wide') + assert response.status_code == HTTPStatus.BAD_REQUEST + + # More than a PDF is made of: said at once, with nothing sent. + response, _ = await api_export(async_client, [('A', make_image())], width=10000, height=10000) + assert response.status_code == HTTPStatus.BAD_REQUEST + assert '10000x10000' in response.json['error'] + response, _ = await api_export(async_client, [], layers=[]) + assert response.status_code == HTTPStatus.BAD_REQUEST + assert 'no layers' in response.json['error'] + + +@pytest.mark.asyncio +async def test_api_export_layers(async_client): + """Only the images of the map's own layers are taken, and the PDF is not made until all of them are sent.""" + meta = dict(width=WIDTH, height=HEIGHT, dpi=300, layers=['A', 'B']) + request, response = await async_client.post('/api/map/export', json=meta) + export_id = response.json['export_id'] + layer, start = f'/api/map/export/{export_id}/layer', f'/api/map/export/{export_id}/start' + + for index, content, error in ( + (2, make_image(), 'no layer 2'), + (0, b'', 'empty'), + (0, b'not an image', 'not a PNG or JPEG'), + (0, make_image(image_format='GIF'), 'not a PNG or JPEG'), + ): + request, response = await async_client.post(f'{layer}/{index}', content=content) + assert response.status_code == HTTPStatus.BAD_REQUEST, error + assert error in response.json['error'] + + # One of two layers. + request, response = await async_client.post(f'{layer}/0', content=make_image()) + assert response.status_code == HTTPStatus.NO_CONTENT + request, response = await async_client.post(start) + assert response.status_code == HTTPStatus.CONFLICT + assert '1 layers have not been sent: B' in response.json['error'] + request, response = await async_client.get(f'/api/map/export/{export_id}/pdf') + assert response.status_code == HTTPStatus.CONFLICT + assert 'not started' in response.json['error'] + + request, response = await async_client.post(f'{layer}/1', content=make_image(image_format='JPEG')) + assert response.status_code == HTTPStatus.NO_CONTENT + request, response = await async_client.post(start) + assert response.status_code == HTTPStatus.ACCEPTED + job_id = response.json['job_id'] + # Asked again, it is the same Job; and no more images are taken. + request, response = await async_client.post(start) + assert response.json['job_id'] == job_id + request, response = await async_client.post(f'{layer}/0', content=make_image()) + assert response.status_code == HTTPStatus.BAD_REQUEST + assert 'already being made' in response.json['error'] + + # Until the Job is done there is no PDF. + request, response = await async_client.get(f'/api/map/export/{export_id}/pdf') + assert response.status_code == HTTPStatus.CONFLICT + assert (await wait_for_job(job_id, timeout=60))['status'] == 'complete' + request, response = await async_client.get(f'/api/map/export/{export_id}/pdf') + assert response.status_code == HTTPStatus.OK + assert layer_names(response.content) == ['A', 'B'] + + +@pytest.mark.asyncio +async def test_api_export_unknown(async_client): + """An export which there is not, and an id which is not one.""" + for export_id in ('0' * 32, 'nothing', '..%2F..%2Fetc'): + for method, url in (('post', f'/api/map/export/{export_id}/layer/0'), + ('post', f'/api/map/export/{export_id}/start'), + ('get', f'/api/map/export/{export_id}/pdf')): + request, response = await getattr(async_client, method)(url) + assert response.status_code == HTTPStatus.NOT_FOUND, url + + +@pytest.mark.asyncio +async def test_api_export_job_fails(async_client): + """An image which is not of the map fails the Job, which says why; there is no PDF.""" + response, job = await api_export(async_client, [('A', make_image()), ('B', make_image(size=(10, 10)))]) + assert job['status'] == 'failed' + assert '10x10' in job['error'] + assert response.status_code == HTTPStatus.CONFLICT + assert 'failed' in response.json['error'] + + +def test_total_pixels_are_limited_before_decoding(): + """The memory an export needs is the pixels of all its layers, which a small upload can be a great many of: + it is refused without any image being opened.""" + with mock.patch('modules.map.export.Image.open') as image_open: + with pytest.raises(InvalidExport, match='too large to export'): + build_layered_pdf([ExportLayer(str(i), BLANK) for i in range(export.MAX_LAYERS)], + export.MAX_SIDE // 4, export.MAX_SIDE // 4, dpi=300) + image_open.assert_not_called() + + # A quadrangle at 300 DPI near the equator, with every layer of a full layer control on, is within it. + assert 24 * 5300 * 6900 <= export.MAX_TOTAL_PIXELS + + +def test_pymupdf_is_not_imported_with_the_module(): + """pymupdf is slow to import, and the API imports this module when it starts.""" + code = 'import sys, modules.map.api; print("pymupdf" in sys.modules)' + result = subprocess.run([sys.executable, '-c', code], capture_output=True, text=True, timeout=120) + assert result.returncode == 0, result.stderr + assert result.stdout.strip().splitlines()[-1] == 'False' + + +def test_images_are_compressed_as_they_are_added(): + """The pixels of a layer are compressed in the PDF when the layer is added, not kept until it is written: + kept, the layers of a quadrangle are more memory than a Raspberry Pi has to spare.""" + doc = pymupdf.open() + page = doc.new_page(width=WIDTH, height=HEIGHT) + export._insert_layer(doc, page, page.rect, ExportLayer('Satellite', make_image(image_format='JPEG')), {}) + export._insert_layer(doc, page, page.rect, ExportLayer('Water', make_image((0, 0, 255, 200), box=(0, 0, 30, 90))), {}) + + streams = [xref for xref in range(1, doc.xref_length()) if doc.xref_is_stream(xref)] + images = [xref for xref in streams if doc.xref_get_key(xref, 'Subtype')[1] == '/Image'] + # The picture and its transparency, and the photograph. + assert len(images) == 3 + assert sorted(doc.xref_get_key(xref, 'Filter')[1] for xref in images) \ + == ['/DCTDecode', '/FlateDecode', '/FlateDecode'] + + # And it is still the picture: blue, mostly opaque, over the left of the photograph. + pixmap = page.get_pixmap(dpi=72, alpha=False) + assert pixmap.pixel(50, 45) != pixmap.pixel(10, 45) + + +# A quadrangle at Anchorage: west, south, east, north. +ANCHORAGE = [-150.0, 61.125, -149.875, 61.25] + + +def read_viewport(pdf: bytes) -> dict: + """What the first page of a PDF says of where it is: its /VP, as the text of each part.""" + doc = pymupdf.open(stream=pdf, filetype='pdf') + page = doc[0] + kind, viewports = doc.xref_get_key(page.xref, 'VP') + assert kind == 'array', f'The page has no /VP: {kind} {viewports}' + + def numbers(key): + return [float(i) for i in re.search(rf'/{key}\s*\[([^]]*)]', viewports).group(1).split()] + + return dict( + text=viewports, + bbox=numbers('BBox'), bounds=numbers('Bounds'), gpts=numbers('GPTS'), lpts=numbers('LPTS'), + page=(page.rect.width, page.rect.height), + ) + + +def test_pdf_says_where_it_is(): + """With the edges of the map, the page has a geospatial viewport: all of the page, with the latitude and + longitude of each of its corners, in a projection every reader knows.""" + pdf = build_layered_pdf([ExportLayer('Background', make_image())], WIDTH, HEIGHT, dpi=72, + title='1:24,000 61°07′30″N 150°00′W', bounds=ANCHORAGE) + viewport = read_viewport(pdf) + + # All of the page. + assert viewport['bbox'] == [0, 0, WIDTH, HEIGHT] + # The corners, from the lower left of the page: upper left, lower left, lower right, upper right... + assert viewport['lpts'] == viewport['bounds'] == [0, 1, 0, 0, 1, 0, 1, 1] + # ...and where each is: latitude, then longitude. + assert viewport['gpts'] == [61.25, -150, 61.125, -150, 61.125, -149.875, 61.25, -149.875] + + text = viewport['text'] + assert '/Type/Viewport' in text.replace(' ', '') and '/Subtype/GEO' in text.replace(' ', '') + # Mercator on the ellipsoid, in Esri's words: Adobe Acrobat puts every place of a page said to be in Web + # Mercator at 0, 0. + assert '/Type/PROJCS' in text.replace(' ', '') and '/EPSG 3395' in text + assert 'PROJCS["WGS_1984_World_Mercator"' in text and 'PROJECTION["Mercator"]' in text + assert '3857' not in text and 'Auxiliary_Sphere' not in text and 'Mercator_1SP' not in text + + # It is still the PDF it was. + assert layer_names(pdf) == ['Background'] + assert pymupdf.open(stream=pdf, filetype='pdf')[0].get_pixmap(dpi=72).pixel(5, 5) == (200, 80, 20) + + +def test_corner_of_page_is_corner_of_map(): + """A reader finds where a point of the page is from the corners: here, as a reader does it, in the + projection the page says it is in.""" + pdf = build_layered_pdf([ExportLayer('Background', make_image())], WIDTH, HEIGHT, dpi=72, bounds=ANCHORAGE) + viewport = read_viewport(pdf) + + def mercator(latitude, longitude): + return (math.radians(longitude) * 6378137, + math.log(math.tan(math.pi / 4 + math.radians(latitude) / 2)) * 6378137) + + def unmercator(x, y): + return math.degrees(2 * math.atan(math.exp(y / 6378137)) - math.pi / 2), math.degrees(x / 6378137) + + lpts, gpts = viewport['lpts'], viewport['gpts'] + corners = {(lpts[i], lpts[i + 1]): mercator(gpts[i], gpts[i + 1]) for i in range(0, 8, 2)} + + def where(across, up): + """The latitude and longitude of a point of the page (0 to 1 from its lower left).""" + (x0, y0), (x1, y1) = corners[(0, 0)], corners[(1, 1)] + return unmercator(x0 + across * (x1 - x0), y0 + up * (y1 - y0)) + + assert where(0, 0) == pytest.approx((61.125, -150)) + assert where(1, 1) == pytest.approx((61.25, -149.875)) + # The middle of the page is the middle of the map in longitude, and north of its middle in latitude: the + # further north, the more of the page a degree is. + latitude, longitude = where(0.5, 0.5) + assert longitude == pytest.approx(-149.9375) + assert 61.1875 < latitude < 61.1877 + # The other two corners are the corners of the same rectangle. + assert corners[(0, 1)] == pytest.approx((corners[(0, 0)][0], corners[(1, 1)][1])) + assert corners[(1, 0)] == pytest.approx((corners[(1, 1)][0], corners[(0, 0)][1])) + + +def test_pdf_without_edges_says_nothing_of_where_it_is(): + pdf = build_layered_pdf([ExportLayer('Background', make_image())], WIDTH, HEIGHT, dpi=72) + doc = pymupdf.open(stream=pdf, filetype='pdf') + assert doc.xref_get_key(doc[0].xref, 'VP')[0] == 'null' + + +def test_viewport_name(): + """The viewport is named as the map is; a name which is not ASCII is written so a PDF can hold it.""" + viewport = export.geospatial_viewport(10, 10, ANCHORAGE, 'A quadrangle (of a map)') + assert '/Name (A quadrangle \\(of a map\\))' in viewport + assert '/Name' not in export.geospatial_viewport(10, 10, ANCHORAGE) + + pdf = build_layered_pdf([ExportLayer('Background', make_image())], WIDTH, HEIGHT, dpi=72, + title='61°07′30″N', bounds=ANCHORAGE) + name = re.search(r'/Name\s*<([0-9A-Fa-f]+)>', read_viewport(pdf)['text']).group(1) + assert bytes.fromhex(name).decode('utf-16') == '61°07′30″N' + + +@pytest.mark.parametrize('bounds', [ + [-150, 61.125, -149.875], # Three edges. + 'here', + [-150, 61.125, -149.875, 'north'], + [-149.875, 61.125, -150, 61.25], # East of its east. + [-150, 61.25, -149.875, 61.125], # North of its north. + [-150, 61.125, -150, 61.25], # No width. + [-190, 61.125, -149.875, 61.25], # Off the world. + [179.875, 0, 180.00001, 0.125], # Across the antimeridian, if not by much. + [179.9, 0, 180.1, 0.125], + [-180.00001, 0, -179.875, 0.125], + [-150, 61.125, -149.875, 89], # Further north than the map goes. + [-150, float('nan'), -149.875, 61.25], +]) +def test_invalid_bounds(bounds): + with pytest.raises(InvalidExport, match='edges'): + build_layered_pdf([ExportLayer('Background', make_image())], WIDTH, HEIGHT, dpi=72, bounds=bounds) + + +@pytest.mark.parametrize('bounds,expected', [ + # The map's own arithmetic puts the edge of the world a hair past where it is. + ([179.875, 0, 180.00000000000125, 0.125], [179.875, 0, 180, 0.125]), + ([-180.00000000000125, 0, -179.875, 0.125], [-180, 0, -179.875, 0.125]), + ([-180, 0, -179.875, 0.125], [-180, 0, -179.875, 0.125]), +]) +def test_bounds_at_the_antimeridian(bounds, expected): + """A map whose edge is the antimeridian is exported, with that edge at 180 degrees and not at -180.""" + pdf = build_layered_pdf([ExportLayer('Background', make_image())], WIDTH, HEIGHT, dpi=72, bounds=bounds) + west, south, east, north = expected + assert read_viewport(pdf)['gpts'] == [north, west, south, west, south, east, north, east] + + +@pytest.mark.asyncio +async def test_api_export_pdf_georeferenced(async_client): + """The edges of the map are sent with its description, and the PDF says where it is.""" + images = [('Background', make_image())] + response, job = await api_export(async_client, images, bounds=ANCHORAGE) + assert response.status_code == HTTPStatus.OK, response.text + assert read_viewport(response.content)['gpts'] == [61.25, -150, 61.125, -150, 61.125, -149.875, 61.25, -149.875] + + # Without them it is a PDF all the same. + response, job = await api_export(async_client, images) + assert response.status_code == HTTPStatus.OK + + # Edges which are not those of a map are refused. + response, job = await api_export(async_client, images, bounds=[0, 0, 0, 0]) + assert response.status_code == HTTPStatus.BAD_REQUEST + assert 'edges' in response.json['error'] + + +@pytest.mark.asyncio +async def test_api_export_text_which_is_not_text(async_client): + """What is sent as the title of a map, or the name of a layer, may have in it what is no character (half of + a pair, a NUL). It is taken out when the export begins: the Job, after every image is sent, is too late to + find that a PDF can not have it.""" + body = json.dumps(dict(width=WIDTH, height=HEIGHT, dpi=300, title='A \ud800 map\x00', layers=['Ro\x00ads \ud800'])) + request, response = await async_client.post('/api/map/export', content=body) + assert response.status_code == HTTPStatus.CREATED, response.json + export_id = response.json['export_id'] + request, response = await async_client.post(f'/api/map/export/{export_id}/layer/0', content=make_image()) + assert response.status_code == HTTPStatus.NO_CONTENT + request, response = await async_client.post(f'/api/map/export/{export_id}/start') + job = await wait_for_job(response.json['job_id'], timeout=60) + assert job['status'] == 'complete', job + request, response = await async_client.get(f'/api/map/export/{export_id}/pdf') + assert layer_names(response.content) == ['Roads ?'] + assert pymupdf.open(stream=response.content).metadata['title'] == 'A ? map' + + +def test_images_of_one_name_are_one_pdf_layer(): + """A layer of the map may be several images, with other layers drawn between them (the parks of the land + are under the water, and its piers are over it). They are one layer of the PDF, and each is drawn where it + was given: turning the layer off hides them all.""" + pdf = build_layered_pdf([ + ExportLayer('Land Cover', make_image((0, 200, 0, 255))), + ExportLayer('Water', make_image((0, 0, 255, 255), box=(0, 0, 30, 90))), + ExportLayer('Land Cover', make_image((90, 90, 90, 255), box=(0, 0, 10, 90))), + ], WIDTH, HEIGHT, dpi=300) + assert layer_names(pdf) == ['Land Cover', 'Water'] + doc = pymupdf.open(stream=pdf, filetype='pdf') + page = doc[0] + assert len(page.get_images()) == 3 + + def color(x): + pixmap = page.get_pixmap(dpi=300) + return pixmap.pixel(x, 45) + + # From the left: the pier over the water, the water over the park, the park. + assert [color(x) for x in (5, 20, 50)] == [(90, 90, 90), (0, 0, 255), (0, 200, 0)] + + +def _wkt_parameter(wkt: str, name: str) -> float: + return float(re.search(rf'PARAMETER\["{name}",([-0-9.]+)]', wkt).group(1)) + + +def _read_as_a_reader_does(viewport: dict, wkt: str, latitude: float, longitude: float): + """Where on the page (across and up, 0 to 1) a reader of the PDF puts a place: it projects the corners it + is given (/GPTS) in the projection it is told of (the WKT: Mercator on its spheroid), and the place, and puts + the place between the corners as they are on the page (/LPTS).""" + assert 'PROJECTION["Mercator"]' in wkt + a, inverse_flattening = [float(i) for i in re.search(r'SPHEROID\["[^"]*",([0-9.]+),([0-9.]+)]', wkt).groups()] + f = 1 / inverse_flattening + e = math.sqrt(f * (2 - f)) + meridian = _wkt_parameter(wkt, 'Central_Meridian') + # Mercator of one standard parallel: the scale is that of the parallel. + parallel = math.radians(_wkt_parameter(wkt, 'Standard_Parallel_1')) + k = math.cos(parallel) / math.sqrt(1 - (e * math.sin(parallel)) ** 2) + + def project(lat, lon): + phi = math.radians(lat) + y = math.log(math.tan(math.pi / 4 + phi / 2) * ((1 - e * math.sin(phi)) / (1 + e * math.sin(phi))) ** (e / 2)) + return (a * k * math.radians(lon - meridian) + _wkt_parameter(wkt, 'False_Easting'), + a * k * y + _wkt_parameter(wkt, 'False_Northing')) + + gpts, lpts = viewport['gpts'], viewport['lpts'] + corners = [(project(gpts[i], gpts[i + 1]), (lpts[i], lpts[i + 1])) for i in range(0, 8, 2)] + # The page is a rectangle of the projection, so three corners say where the rest of it is. + (upper_left, page_ul), (lower_left, page_ll), (lower_right, page_lr), _ = corners + x, y = project(latitude, longitude) + across = (x - lower_left[0]) / (lower_right[0] - lower_left[0]) + up = (y - lower_left[1]) / (upper_left[1] - lower_left[1]) + return (page_ll[0] + across * (page_lr[0] - page_ll[0]), page_ll[1] + up * (page_ul[1] - page_ll[1])) + + +def _drawn(bounds, latitude: float, longitude: float): + """Where on the page (across and up, 0 to 1) the map has a place: it is drawn in Web Mercator.""" + west, south, east, north = bounds + + def y(lat): + return math.log(math.tan(math.pi / 4 + math.radians(lat) / 2)) + + return (longitude - west) / (east - west), (y(latitude) - y(south)) / (y(north) - y(south)) + + +@pytest.mark.parametrize('west,south', [(-78.5, 0), (-100, 20), (-105.125, 40.25), (-149.625, 61.25), (-156.75, 71.25), + (151.125, -33.875), (10, 84.875), (-0.0625, -0.0625)]) +def test_page_is_where_the_projection_it_is_said_to_be_in_puts_it(west, south): + """The page is drawn in Web Mercator (a sphere), and a reader is told it is Mercator on the ellipsoid, with + the latitude and longitude of its corners. A reader puts a place on the page by where that projection has + it between the corners: that is within 5 centimeters on the ground of where the map drew it, anywhere on a + quadrangle, at any latitude. What the reader is told is what the PDF says: its corners and its WKT.""" + bounds = [west, south, west + 0.125, south + 0.125] + pdf = build_layered_pdf([ExportLayer('Background', make_image())], WIDTH, HEIGHT, dpi=72, bounds=bounds) + viewport = read_viewport(pdf) + wkt = re.search(r'/WKT\s*\((.*)\)\s*>>', viewport['text'], re.S).group(1) + + # The page is this wide and this tall on the ground. + height = 6378137 * math.radians(0.125) + width = height * math.cos(math.radians(south + 0.0625)) + worst = 0 + for i in range(21): + for j in range(21): + lat, lon = south + 0.125 * i / 20, west + 0.125 * j / 20 + read = _read_as_a_reader_does(viewport, wkt, lat, lon) + drawn = _drawn(bounds, lat, lon) + worst = max(worst, math.hypot((read[0] - drawn[0]) * width, (read[1] - drawn[1]) * height)) + assert worst < 0.05 + + # The same sum finds a page whose corners are not where they are said to be: here, a second of arc south. + moved = dict(viewport, gpts=[v - 1 / 3600 if index % 2 == 0 else v for index, v in enumerate(viewport['gpts'])]) + middle = (south + 0.0625, west + 0.0625) + off = _read_as_a_reader_does(moved, wkt, *middle)[1] - _drawn(bounds, *middle)[1] + assert abs(off) * height == pytest.approx(31, abs=1) + + +def test_page_taller_than_a_quadrangle_is_less_well_said(): + """What is left between the two projections grows with the square of how tall the page is: centimeters on a + quadrangle, more than a meter on a page a degree tall. (A page that tall is not exported yet.)""" + def worst(tall): + bounds = [-150, 61, -149, 61 + tall] + viewport = dict(gpts=[bounds[3], bounds[0], bounds[1], bounds[0], bounds[1], bounds[2], bounds[3], bounds[2]], + lpts=[0, 1, 0, 0, 1, 0, 1, 1]) + height = 6378137 * math.radians(tall) + return max(abs(_read_as_a_reader_does(viewport, export.PAGE_PROJECTION_WKT, 61 + tall * i / 40, -149.5)[1] + - _drawn(bounds, 61 + tall * i / 40, -149.5)[1]) * height for i in range(41)) + + assert worst(0.125) < 0.05 + assert 1 < worst(1) < 2 diff --git a/modules/map/test/test_export_job.py b/modules/map/test/test_export_job.py new file mode 100644 index 00000000..42641309 --- /dev/null +++ b/modules/map/test/test_export_job.py @@ -0,0 +1,422 @@ +import asyncio +import json +import os +import stat +import threading +import time +from http import HTTPStatus + +import pytest + +from modules.map import export, export_job +from modules.map.test.test_export import make_image +from wrolpi import jobs + +WIDTH, HEIGHT = 60, 90 + + +def new_export(*names, **kwargs) -> str: + return export_job.create_export(list(names), WIDTH, HEIGHT, 300, **kwargs) + + +def test_create_export(map_export_root): + """An export is a directory which holds what was said of the map.""" + export_id = new_export('Background', 'Water', title='A quadrangle', bounds=[-150, 61.125, -149.875, 61.25], + sheet=export.Sheet(name='A quadrangle', credits=['Somebody'], date='2026-11-15')) + assert export_job.EXPORT_ID.match(export_id) + meta = json.loads((map_export_root / export_id / 'meta.json').read_text()) + assert meta['layers'] == ['Background', 'Water'] + assert meta['sheet'] == dict(name='A quadrangle', credits=['Somebody'], date='2026-11-15', + contour_interval=None, contour_unit=None, legend=None) + assert meta['job_id'] is None + + # A map which can not be exported is not begun. + with pytest.raises(export.InvalidExport, match='no layers'): + new_export() + with pytest.raises(export.InvalidExport, match='edges of the map are needed'): + new_export('A', sheet=export.Sheet()) + assert len(list(map_export_root.iterdir())) == 1 + + +@pytest.mark.parametrize('export_id', ['0' * 32, '', 'nothing', '../' + '0' * 29, '0' * 31 + '/', None]) +def test_unknown_export(export_id, map_export_root): + """An id which was not given by an export is of no export, whatever it would be as a path.""" + map_export_root.mkdir() + (map_export_root.parent / 'meta.json').write_text('{}') + with pytest.raises(export_job.ExportNotFound): + export_job.save_layer(export_id, 0, make_image()) + with pytest.raises(export_job.ExportNotFound): + export_job.get_export_pdf(export_id) + + +def age(directory, seconds=export_job.EXPORT_KEEP_SECONDS + 60): + """Make an export look as old as that.""" + then = time.time() - seconds + os.utime(directory, (then, then)) + + +def test_remove_old_exports(map_export_root, monkeypatch): + """An export is removed when it is old; a new export is when that is looked for.""" + old, new = new_export('A'), new_export('A') + export_job.save_layer(old, 0, make_image()) + age(map_export_root / old) + (map_export_root / 'a file which is not an export').write_text('left alone') + + newest = new_export('A') + assert sorted(i.name for i in map_export_root.iterdir() if i.is_dir()) == sorted([new, newest]) + assert (map_export_root / 'a file which is not an export').is_file() + with pytest.raises(export_job.ExportNotFound): + export_job.start_export(old) + + # Nothing to remove, and nowhere to look, are not errors; and looking does not make the directory. + export_job.remove_old_exports() + monkeypatch.setattr(export_job, 'EXPORT_ROOT', map_export_root / 'not made yet') + export_job.remove_old_exports() + assert not (map_export_root / 'not made yet').exists() + + +def test_only_exports_are_removed(map_export_root, tmp_path): + """What is old in the directory of exports, and is not an export, is left: a directory by another name, and a + link by an export's name to a directory somewhere else.""" + new_export('A') + other = map_export_root / 'someone-elses-directory' + other.mkdir() + (other / 'file').write_text('kept') + elsewhere = tmp_path / 'elsewhere' + elsewhere.mkdir() + (elsewhere / 'precious').write_text('kept') + link = map_export_root / ('f' * 32) + link.symlink_to(elsewhere, target_is_directory=True) + for path in (other, elsewhere): + age(path) + + export_job.remove_old_exports() + assert (other / 'file').read_text() == 'kept' + assert (elsewhere / 'precious').read_text() == 'kept' + # And a link is not an export. + with pytest.raises(export_job.ExportNotFound): + export_job.save_layer('f' * 32, 0, make_image()) + + +def test_export_directory_is_this_users(map_export_root, tmp_path, monkeypatch): + """Exports are kept in a directory made for this user alone, and never through a link: anyone may make things + in /var/tmp, and a link there would have exports written, and old ones removed, wherever it leads.""" + export_id = new_export('A') + assert stat.S_IMODE(map_export_root.stat().st_mode) == 0o700 + assert stat.S_IMODE((map_export_root / export_id).stat().st_mode) == 0o700 + + # One which others could read is closed to them when it is next used. + os.chmod(map_export_root, 0o755) + new_export('A') + assert stat.S_IMODE(map_export_root.stat().st_mode) == 0o700 + + # A link where the directory should be. + elsewhere = tmp_path / 'elsewhere' + (elsewhere / ('a' * 32)).mkdir(parents=True) + age(elsewhere / ('a' * 32)) + linked = tmp_path / 'linked-root' + linked.symlink_to(elsewhere, target_is_directory=True) + monkeypatch.setattr(export_job, 'EXPORT_ROOT', linked) + with pytest.raises(export_job.ExportStorageError): + new_export('A') + with pytest.raises(export_job.ExportStorageError): + export_job.remove_old_exports() + with pytest.raises(export_job.ExportStorageError): + export_job.save_layer('a' * 32, 0, make_image()) + # Nothing was made, or removed, where the link leads. + assert [i.name for i in elsewhere.iterdir()] == ['a' * 32] + + # A file where the directory should be. + not_a_directory = tmp_path / 'a-file' + not_a_directory.write_text('') + monkeypatch.setattr(export_job, 'EXPORT_ROOT', not_a_directory) + with pytest.raises(export_job.ExportStorageError): + new_export('A') + + +@pytest.mark.asyncio +async def test_exports_of_waiting_jobs_are_kept(async_client, map_export_root): + """An export whose Job is waiting is kept however old it is: it may wait behind another Job for longer than an + export is kept, and its images are what the Job is to work from. One whose Job was cancelled is removed at + once.""" + waiting, cancelled, finished = new_export('A'), new_export('A'), new_export('A') + for export_id in (waiting, cancelled, finished): + export_job.save_layer(export_id, 0, make_image()) + await jobs.wait_for_job(export_job.start_export(finished), timeout=60) + # Queued, and not run: nothing takes Jobs from the queue in a test until one is waited for. + waiting_job = export_job.start_export(waiting) + jobs.cancel_job(export_job.start_export(cancelled)) + for export_id in (waiting, finished): + age(map_export_root / export_id) + + export_job.remove_old_exports() + assert sorted(i.name for i in map_export_root.iterdir()) == [waiting] + assert (map_export_root / waiting / 'layer-000').is_file() + + # It is still there for its Job, which makes the PDF. + assert (await jobs.wait_for_job(waiting_job, timeout=60))['status'] == 'complete' + assert export_job.get_export_pdf(waiting).is_file() + + +@pytest.mark.asyncio +async def test_remove_export(async_client, map_export_root): + """An export which is stopped is removed, with the images which were sent, whatever step it was at.""" + # Before its PDF was asked for. + export_id = new_export('A', 'B') + export_job.save_layer(export_id, 0, make_image()) + request, response = await async_client.delete(f'/api/map/export/{export_id}') + assert response.status_code == HTTPStatus.NO_CONTENT + assert not (map_export_root / export_id).exists() + request, response = await async_client.delete(f'/api/map/export/{export_id}') + assert response.status_code == HTTPStatus.NOT_FOUND + + # While its Job waited: the Job is cancelled, and never runs. + export_id = new_export('A') + export_job.save_layer(export_id, 0, make_image()) + job_id = export_job.start_export(export_id) + export_job.remove_export(export_id) + assert not (map_export_root / export_id).exists() + assert (await jobs.wait_for_job(job_id, timeout=60))['status'] == 'cancelled' + + # After its PDF was made. + export_id = new_export('A') + export_job.save_layer(export_id, 0, make_image()) + await jobs.wait_for_job(export_job.start_export(export_id), timeout=60) + export_job.remove_export(export_id) + assert not (map_export_root / export_id).exists() + + with pytest.raises(export_job.ExportNotFound): + export_job.remove_export('0' * 32) + + +@pytest.mark.asyncio +async def test_job_makes_the_pdf(async_client, map_export_root): + """The Job makes the PDF from the images, says how far along it is, and removes the images.""" + export_id = new_export('Background', 'Water', title='A quadrangle') + export_job.save_layer(export_id, 0, make_image()) + export_job.save_layer(export_id, 1, make_image((0, 0, 255, 255), image_format='JPEG')) + directory = map_export_root / export_id + assert sorted(i.name for i in directory.iterdir()) == ['layer-000', 'layer-001', 'meta.json'] + + job_id = export_job.start_export(export_id) + assert job_id.startswith('map_export_pdf-') + job = await jobs.wait_for_job(job_id, timeout=60) + assert job['status'] == 'complete', job + assert job['progress'] == 100 + assert job['result']['export_id'] == export_id + + pdf = export_job.get_export_pdf(export_id) + assert pdf.read_bytes().startswith(b'%PDF-') + assert job['result']['size'] == pdf.stat().st_size + # Only what was said of the map, and the PDF, are kept. + assert sorted(i.name for i in directory.iterdir()) == ['map.pdf', 'meta.json'] + + +@pytest.mark.asyncio +async def test_job_progress(async_client, map_export_root, monkeypatch): + """The Job says how far along it is as each layer is looked at and then put in the PDF.""" + seen = [] + real_set_progress = jobs.JobContext.set_progress + + def set_progress(self, percent): + seen.append(percent) + real_set_progress(self, percent) + + monkeypatch.setattr(jobs.JobContext, 'set_progress', set_progress) + export_id = new_export('A', 'B') + for index in range(2): + export_job.save_layer(export_id, index, make_image()) + await jobs.wait_for_job(export_job.start_export(export_id), timeout=60) + # And, with every step done, before and after the PDF is written: when the work may still be stopped. + assert seen == [0, 25, 50, 75, 100, 100, 100] + + +@pytest.mark.asyncio +async def test_job_fails(async_client, map_export_root): + """A map which can not be made into a PDF fails the Job; its images are removed all the same.""" + export_id = new_export('A', 'B') + export_job.save_layer(export_id, 0, make_image()) + export_job.save_layer(export_id, 1, make_image(size=(10, 10))) + job = await jobs.wait_for_job(export_job.start_export(export_id), timeout=60) + assert job['status'] == 'failed' + assert '10x10' in job['error'] + assert sorted(i.name for i in (map_export_root / export_id).iterdir()) == ['meta.json'] + with pytest.raises(export_job.ExportNotReady, match='failed'): + export_job.get_export_pdf(export_id) + + +@pytest.mark.asyncio +async def test_job_cancelled(async_client, map_export_root, monkeypatch): + """A cancelled Job stops between two layers, makes no PDF, and removes the images. It is not over until the + work has stopped: the next Job is not to start beside it.""" + export_id = new_export('A', 'B', 'C') + for index in range(3): + export_job.save_layer(export_id, index, make_image()) + job_id = export_job.start_export(export_id) + + # The work is held while its first layer is looked at. + real_check = export._check_layer + checked, looking, go_on = [], threading.Event(), threading.Event() + + def check_layer(layer, width, height): + checked.append(layer.name) + looking.set() + assert go_on.wait(30) + return real_check(layer, width, height) + + monkeypatch.setattr(export, '_check_layer', check_layer) + waiting = asyncio.ensure_future(jobs.wait_for_job(job_id, timeout=60)) + for _ in range(200): + if looking.is_set(): + break + await asyncio.sleep(0.02) + assert looking.is_set() + + # Cancelled, as from another process. (Not `cancel_job` here: it logs while it holds the Jobs' lock, and + # this test's log is written to the running Job, which takes that lock.) + jobs._update_job(job_id, cancel_requested=True) + await asyncio.sleep(0.5) + # The work has not stopped, so neither has the Job: its images are still there. + assert jobs.get_job(job_id)['status'] == 'running' + assert not waiting.done() + assert (map_export_root / export_id / 'layer-000').is_file() + + go_on.set() + job = await waiting + assert job['status'] == 'cancelled' + # When the Job is over, so is the work: one layer was looked at, and the images are gone. + assert checked == ['A'] + assert sorted(i.name for i in (map_export_root / export_id).iterdir()) == ['meta.json'] + with pytest.raises(export_job.ExportNotReady, match='cancelled'): + export_job.get_export_pdf(export_id) + + +@pytest.mark.asyncio +async def test_job_cancelled_as_the_pdf_is_written(async_client, map_export_root, monkeypatch): + """A Job cancelled after its last layer, while the sheet is drawn or the PDF written, makes no PDF either.""" + export_id = new_export('A') + export_job.save_layer(export_id, 0, make_image()) + job_id = export_job.start_export(export_id) + real_insert = export._insert_layer + + def insert_layer(*args): + real_insert(*args) + jobs._update_job(job_id, cancel_requested=True) + + monkeypatch.setattr(export, '_insert_layer', insert_layer) + job = await jobs.wait_for_job(job_id, timeout=60) + assert job['status'] == 'cancelled' + assert sorted(i.name for i in (map_export_root / export_id).iterdir()) == ['meta.json'] + + +def test_layers_are_read_one_at_a_time(tmp_path): + """A layer in a file is read when it is needed, not when the map is described.""" + path = tmp_path / 'layer' + layer = export.ExportLayer('A', path=path) + path.write_bytes(make_image()) + assert layer.read() == make_image() + assert export.ExportLayer('A', image=b'given').read() == b'given' + pdf = export.build_layered_pdf([layer], WIDTH, HEIGHT, 300) + assert pdf.startswith(b'%PDF-') + + +def test_progress_may_stop_the_work(): + """What is told how far along the PDF is may stop it.""" + calls = [] + + def progress(done, steps): + calls.append((done, steps)) + if done == 3: + raise RuntimeError('enough') + + layers = [export.ExportLayer(str(i), make_image()) for i in range(3)] + with pytest.raises(RuntimeError, match='enough'): + export.build_layered_pdf(layers, WIDTH, HEIGHT, 300, progress=progress) + assert calls == [(0, 6), (1, 6), (2, 6), (3, 6)] + + +class NeverCancelled: + """A Job which was not cancelled, as one is which ends because the API is stopping.""" + + @staticmethod + def cancel_requested() -> bool: + return False + + @staticmethod + def set_progress(_: float): + pass + + +def test_work_stops_when_it_is_told_to(map_export_root): + """The work of a Job which ended without being cancelled (the API is stopping) stops between two layers when + it is told to: the API waits for it, and is not to wait for all of a PDF.""" + export_id = new_export('A', 'B') + for index in range(2): + export_job.save_layer(export_id, index, make_image()) + directory = map_export_root / export_id + stop = threading.Event() + stop.set() + with pytest.raises(export_job.ExportCancelled): + export_job._make_pdf(directory, NeverCancelled, stop) + assert sorted(i.name for i in directory.iterdir()) == ['meta.json'] + # Not told to, it makes the PDF. + export_id = new_export('A') + export_job.save_layer(export_id, 0, make_image()) + export_job._make_pdf(map_export_root / export_id, NeverCancelled, threading.Event()) + assert sorted(i.name for i in (map_export_root / export_id).iterdir()) == ['map.pdf', 'meta.json'] + + +def test_files_of_an_export_are_written_whole(map_export_root, monkeypatch): + """What is said of an export, and each image, is all there or is what was there before: another request + may read it while it is written. A write which fails leaves nothing behind.""" + export_id = new_export('A') + directory = map_export_root / export_id + before = (directory / 'meta.json').read_text() + + def replace(*_): + raise OSError('The disk is full') + + with monkeypatch.context() as patch: + patch.setattr(export_job.os, 'replace', replace) + with pytest.raises(OSError): + export_job.save_layer(export_id, 0, make_image()) + with pytest.raises(OSError): + export_job._write_meta(directory, {'layers': []}) + assert sorted(i.name for i in directory.iterdir()) == ['meta.json'] + assert (directory / 'meta.json').read_text() == before + export_job.save_layer(export_id, 0, make_image()) + assert sorted(i.name for i in directory.iterdir()) == ['layer-000', 'meta.json'] + + +@pytest.mark.asyncio +async def test_job_removes_old_exports(async_client, map_export_root): + """Old exports are removed when a PDF is made, as well as when an export begins: the last export of a day + is not to keep the one before it.""" + old = new_export('A') + export_id = new_export('A') + age(map_export_root / old) + export_job.save_layer(export_id, 0, make_image()) + job = await jobs.wait_for_job(export_job.start_export(export_id), timeout=60) + assert job['status'] == 'complete' + assert sorted(i.name for i in map_export_root.iterdir()) == [export_id] + + +def test_image_which_arrives_after_its_export_is_removed(map_export_root, monkeypatch): + """An export may be removed while the image of a layer is on its way (the person exporting stopped it, and + the request was already here). The image is not kept: nothing would ever use it, or remove it soon.""" + export_id = new_export('A', 'B') + directory = map_export_root / export_id + real_write = export_job._write_whole + + def write_whole(path, contents): + # Removed, as by another request, between this image being let in and being written. + if path.name.startswith('layer-'): + export_job.remove_export(export_id) + path.parent.mkdir() + real_write(path, contents) + + monkeypatch.setattr(export_job, '_write_whole', write_whole) + with pytest.raises(export_job.ExportNotFound): + export_job.save_layer(export_id, 0, make_image()) + assert not directory.exists() + assert list(map_export_root.iterdir()) == [] diff --git a/modules/map/test/test_magnetic.py b/modules/map/test/test_magnetic.py new file mode 100644 index 00000000..11e0d7d6 --- /dev/null +++ b/modules/map/test/test_magnetic.py @@ -0,0 +1,50 @@ +import pytest + +from modules.map import magnetic + +# From the test values published with the model: year, altitude (km), latitude, longitude, declination, and the +# field north, east and down (nT). +TEST_VALUES = [ + (2025.0, 28, 89, -121, -99.77, -255.388723, -1482.460628, 56194.288771), + (2025.0, 48, 80, -96, -29.91, 1875.982280, -1079.269389, 55623.044051), + (2025.0, 54, 82, 87, 54.89, 1324.336929, 1883.428620, 56740.772059), + (2025.0, 65, 43, 93, 0.50, 24299.852822, 210.517066, 50037.923998), + (2025.0, 51, -33, 109, -5.49, 21737.778822, -2090.274098, -52710.003920), + (2025.0, 39, -59, -8, -15.75, 14358.095523, -4049.107540, -24389.086374), + (2025.0, 3, -50, -103, 27.96, 19526.532799, 10362.990980, -31437.562789), + (2025.0, 94, -29, -110, 15.74, 23275.471080, 6559.046509, -19063.605287), + (2025.0, 66, 14, 143, -0.19, 35003.441364, -116.624818, 7966.315182), + (2025.0, 18, 0, 21, 1.29, 29274.811882, 659.800118, -14316.722540), + (2025.5, 6, -36, -137, 20.28, 23781.930678, 8786.698927, -32577.518648), + (2025.5, 63, 26, 81, 0.51, 34802.613433, 308.431881, 30332.056989), +] + + +def test_load_model(): + model = magnetic.load_model() + assert (model.epoch, model.name, model.degree) == (2025.0, 'WMM-2025', 12) + # Every harmonic of degrees 1 to 12. + assert len(model.coefficients) == sum(n + 1 for n in range(1, 13)) + assert model.coefficients[0] == (1, 0, -29351.8, 0.0, 12.0, 0.0) + assert model.coefficients[-1] == (12, 12, -0.7, 0.2, -0.1, -0.1) + + +@pytest.mark.parametrize('year,altitude,latitude,longitude,declination,north,east,down', TEST_VALUES) +def test_field(year, altitude, latitude, longitude, declination, north, east, down): + """The field is what the model's own test values say it is.""" + model = magnetic.load_model() + assert model.field(latitude, longitude, year, altitude) == pytest.approx((north, east, down), abs=0.01) + assert model.declination(latitude, longitude, year, altitude) == pytest.approx(declination, abs=0.006) + + +def test_declination(): + """A compass in Anchorage points well east of north; in Maine, west.""" + assert 13 < magnetic.declination(61.19, -149.94, 2026.87) < 16 + assert -17 < magnetic.declination(45.0, -69.0, 2026.87) < -13 + + +def test_declination_is_not_guessed(): + """There is no declination in a year the model is not of.""" + assert magnetic.declination(61.19, -149.94, 2024.99) is None + assert magnetic.declination(61.19, -149.94, 2030.0) is None + assert magnetic.declination(61.19, -149.94, 2029.99) is not None diff --git a/modules/map/test/test_quads.py b/modules/map/test/test_quads.py new file mode 100644 index 00000000..6dc232c9 --- /dev/null +++ b/modules/map/test/test_quads.py @@ -0,0 +1,112 @@ +from http import HTTPStatus + +import pytest + +from modules.map import quads + + +def test_load_index(): + souths, rows = quads.load_index() + assert souths == sorted(souths) == sorted(rows) + count = 0 + for south in souths: + wests, cells = quads._row(south) + assert wests == sorted(wests) == [i[0] for i in cells] + count += len(cells) + assert count > 65_000 + + +@pytest.mark.parametrize('west,south,name,state', [ + (-105.125, 40.25, 'Berthoud', 'Colorado'), + (-108.5, 37.75, 'South Mountain', 'Colorado'), + (-76.375, 36.375, 'South Mills', 'North Carolina'), + (-95.25, 37.375, 'South Mound', 'Kansas'), +]) +def test_quad_name(west, south, name, state): + """A quadrangle of the grid has the name the USGS gives it.""" + assert quads.quad_name(west, south, west + 0.125, south + 0.125) == quads.QuadName(name, state, True) + # Asked with the edges the map has, which are not quite those. + assert quads.quad_name(west + 1e-7, south - 1e-7, west + 0.125, south + 0.125).exact + + +def test_quad_name_in_alaska(): + """A quadrangle in Alaska is wider than 7.5 minutes, so an area 7.5 minutes each way is a part of one.""" + assert quads.quad_name(-150, 61.125, -149.875, 61.25) == quads.QuadName('Anchorage A-8 NW', 'Alaska', False) + # All of it, by its own edges. + assert quads.quad_name(-150, 61.125, -149.8125, 61.25) == quads.QuadName('Anchorage A-8 NW', 'Alaska', True) + # The area east of the first is the rest of that quadrangle, and the start of the next. + assert quads.quad_name(-149.875, 61.125, -149.75, 61.25).name == 'Anchorage A-8 NE' + + +@pytest.mark.parametrize('west,south,name,state', [ + # A quadrangle 11.25 minutes wide, which ends at the middle of this area: there is none east of it. + (-153.25, 59.0, 'Iliamna A-1 SW', 'Alaska'), + (-151.375, 59.0, 'Seldovia A-4 SW', 'Alaska'), + # A quadrangle moved to fit an island, which ends at the middle of this area: there is none north of it. + (145.625, 18.75, 'Agrigan Island', 'Northern Mariana Islands'), +]) +def test_quad_name_at_an_outer_edge(west, south, name, state): + """An area half of which is a quadrangle, and the other half no quadrangle, is a part of that quadrangle: + its middle is on the quadrangle's edge, not outside it.""" + found = quads.quad_name(west, south, west + 0.125, south + 0.125) + assert found is not None + assert (found.name, found.state, found.exact) == (name, state, False) + + +def test_quad_name_at_a_shared_edge(): + """A place on the edge two quadrangles share is in the one east, or north, of that edge.""" + assert quads.quad_name(-105.25, 40.25, -105, 40.375).name == 'Berthoud' + assert quads.quad_name(-105.125, 40.125, -105, 40.375).name == 'Berthoud' + + +def test_quad_name_at_a_shared_edge_the_map_gives(): + """The edges the map gives are a hair from where they are. An area whose middle is that near the edge two + quadrangles share is in the one east, or north, of that edge, whichever side of it the hair is.""" + assert quads.quad_name(-149.875, 61.125, -149.75, 61.25).name == 'Anchorage A-8 NE' + # What the map gave for those edges. + given = (-149.87500000000014, 61.12499878064878, -149.75000000000023, 61.25000121452442) + assert quads.quad_name(*given).name == 'Anchorage A-8 NE' + assert quads.quad_name(-105.25 - 1e-9, 40.25 - 1e-9, -105, 40.375).name == 'Berthoud' + + +@pytest.mark.parametrize('west,south', [ + (0, 0), + (151.125, -33.875), # Sydney. + (-105.125, 30), # Mexico. + (-40, 40), # The Atlantic. + (-180, 84.875), +]) +def test_quad_without_a_name(west, south): + assert quads.quad_name(west, south, west + 0.125, south + 0.125) is None + + +def test_every_quad_is_found(): + """The middle of each quadrangle of the index is in a quadrangle of that name, or (where two lie over each + other) of its neighbor's.""" + souths, rows = quads.load_index() + missed = 0 + for south in souths[::7]: + wests, cells = quads._row(south) + for west, east, north, name, state in cells[::5]: + found = quads.quad_name(west / 3600, south / 3600, east / 3600, north / 3600) + assert found is not None, (name, state) + missed += found.name != name + assert missed <= 2 + + +@pytest.mark.asyncio +async def test_api_quad_name(async_client): + request, response = await async_client.get('/api/map/quad?west=-105.125&south=40.25&east=-105&north=40.375') + assert response.status_code == HTTPStatus.OK + assert response.json == {'quad': {'name': 'Berthoud', 'state': 'Colorado', 'exact': True}} + + # Somewhere the USGS has no name for is not an error. + request, response = await async_client.get('/api/map/quad?west=0&south=0&east=0.125&north=0.125') + assert response.status_code == HTTPStatus.OK + assert response.json == {'quad': None} + + for query in ('', '?west=-105.125&south=40.25&east=-105', '?west=a&south=b&east=c&north=d', + '?west=-105.125&south=40.25&east=-113&north=40.375', '?west=nan&south=0&east=1&north=1', + '?west=-500&south=0&east=1&north=1'): + request, response = await async_client.get(f'/api/map/quad{query}') + assert response.status_code == HTTPStatus.BAD_REQUEST, query diff --git a/modules/map/test/test_sheet.py b/modules/map/test/test_sheet.py new file mode 100644 index 00000000..e7ae3697 --- /dev/null +++ b/modules/map/test/test_sheet.py @@ -0,0 +1,737 @@ +import json +import math +import re +from http import HTTPStatus + +import pymupdf +import pytest + +from modules.map import export, magnetic, quads, sheet +from modules.map.export import ExportLayer, InvalidExport, Sheet, build_layered_pdf +from modules.map.test.test_export import api_export, layer_names, make_image, read_viewport + +# A quadrangle of Anchorage, and the size of its image: 11 by 22.9 inches of paper at 36 DPI. +ANCHORAGE = [-150, 61.125, -149.875, 61.25] +WIDTH, HEIGHT, DPI = 397, 824, 36 +MAP_WIDTH, MAP_HEIGHT = WIDTH * 72 / DPI, HEIGHT * 72 / DPI +SHEET = Sheet(name='61°07′30″N 150°00′W', credits=['© OpenStreetMap contributors', 'Protomaps'], + date='2026-11-15') + + +def build(bounds=None, sheet_=SHEET, **kwargs) -> bytes: + return build_layered_pdf([ExportLayer('Background', make_image(size=(WIDTH, HEIGHT)))], WIDTH, HEIGHT, DPI, + bounds=bounds or ANCHORAGE, sheet=sheet_, **kwargs) + + +def page_text(pdf: bytes) -> str: + return pymupdf.open(stream=pdf, filetype='pdf')[0].get_text() + + +@pytest.mark.parametrize('latitude,longitude,zone,south,easting,northing', [ + # As PROJ has them (gdaltransform, EPSG:326xx and 327xx). + (61.2181, -149.9003, 6, False, 344247.206470396, 6790536.87132859), + (61.125, -150, 6, False, 338419.895396155, 6780416.03492079), + (40.31, -105.0595, 13, False, 494944.139497354, 4462166.80845969), + (-33.87, 151.21, 56, True, 334435.70614183, 6250816.39780466), +]) +def test_utm(latitude, longitude, zone, south, easting, northing): + """A place has the UTM coordinates PROJ gives it, to a millimeter, and they are of that place.""" + assert sheet.utm_zone(longitude) == zone + assert sheet.to_utm(latitude, longitude, zone, south) == pytest.approx((easting, northing), abs=0.001) + assert sheet.from_utm(easting, northing, zone, south) == pytest.approx((latitude, longitude), abs=1e-8) + + +def test_utm_zone(): + assert [sheet.utm_zone(i) for i in (-180, -174.001, -174, 0, 179.999, 180)] == [1, 1, 2, 31, 60, 60] + + +def test_format_angle(): + assert sheet.format_angle(61.125, 'N', 'S') == '61°07\'30"N' + assert sheet.format_angle(-150, 'E', 'W') == "150°00'W" + assert sheet.format_angle(-33.875, 'N', 'S') == '33°52\'30"S' + assert sheet.format_angle(61.125, short=True) == '07\'30"' + assert sheet.format_angle(-149.9166666667, short=True) == "55'" + # Seconds which round up to a minute. + assert sheet.format_angle(2.9999999) == "3°00'" + + +def test_graticule_interval(): + """A 7.5 minute map has a tick every 2.5 minutes; a larger map has them further apart.""" + assert sheet.graticule_interval(0.125) == pytest.approx(2.5 / 60) + assert sheet.graticule_interval(0.25) == pytest.approx(5 / 60) + assert sheet.graticule_interval(1) == pytest.approx(15 / 60) + assert sheet.graticule_interval(1e-9) == pytest.approx(1 / 3600) + + +def test_map_scale(): + """The quadrangle the browser draws for a 1:24,000 sheet is 1:24,000.""" + assert sheet.map_scale(MAP_WIDTH, ANCHORAGE) == pytest.approx(24000, rel=0.005) + assert sheet.map_scale(MAP_WIDTH * 2, ANCHORAGE) == pytest.approx(12000, rel=0.005) + + +def test_plan(): + plan = sheet.plan_sheet(MAP_WIDTH, MAP_HEIGHT, ANCHORAGE, SHEET) + x0, y0, x1, y1 = plan.map_rect + assert (x1 - x0, y1 - y0) == pytest.approx((MAP_WIDTH, MAP_HEIGHT)) + # There is a margin on every side, and the most of it is under the map. + assert x0 > 36 and y0 > 36 and plan.width - x1 > 36 + assert plan.height - y1 > y0 + assert plan.zone == 6 and not plan.south_hemisphere + # The corners of the map are the corners of its rectangle. + assert plan.point(61.25, -150) == pytest.approx((x0, y0)) + assert plan.point(61.125, -149.875) == pytest.approx((x1, y1)) + notes = ' '.join(plan.notes) + assert 'Scale 1:24,000' in notes + assert 'zone 6N' in notes and 'west (46 mils) of true north' in notes + assert 'Map data: © OpenStreetMap contributors; Protomaps' in notes + assert 'Made with WROLPi, 2026-11-15.' in notes + + +def test_plan_notes_fit_the_map(): + """Notes too long for the map are on more lines, and the page is longer for them.""" + short = sheet.plan_sheet(MAP_WIDTH, MAP_HEIGHT, ANCHORAGE, Sheet()) + long = sheet.plan_sheet(MAP_WIDTH, MAP_HEIGHT, ANCHORAGE, Sheet(credits=['Somebody who made a map'] * 20)) + assert len(long.notes) > len(short.notes) + assert long.height > short.height + assert all(pymupdf.get_text_length(i, fontsize=sheet.NOTE_SIZE) <= MAP_WIDTH for i in long.notes) + + +class FakePen: + def __init__(self): + self.lines, self.texts = [], [] + + def line(self, points, **kwargs): + self.lines.append(list(points)) + + def text(self, x, y, text, **kwargs): + self.texts.append((x, y, text, kwargs.get('align', 'left'))) + + def box(self, rect, **kwargs): + pass + + +def place_at(plan, x, y): + """The latitude and longitude of a point of the page.""" + x0, y0, x1, y1 = plan.map_rect + west, south, east, north = plan.bounds + top, bottom = (math.log(math.tan(math.pi / 4 + math.radians(i) / 2)) for i in (north, south)) + mercator = top - (y - y0) / (y1 - y0) * (top - bottom) + return math.degrees(2 * math.atan(math.exp(mercator)) - math.pi / 2), west + (x - x0) / (x1 - x0) * (east - west) + + +@pytest.mark.parametrize('bounds,zone,south', [ + (ANCHORAGE, 6, False), + ([151.125, -33.875, 151.25, -33.75], 56, True), + ([0, 0, 0.125, 0.125], 31, False), +]) +def test_grid_lines_are_where_they_say(bounds, zone, south): + """Every line of the grid is on a whole kilometer of UTM along all of it, and is nowhere off the map.""" + plan = sheet.plan_sheet(MAP_WIDTH, MAP_HEIGHT, bounds, Sheet()) + assert (plan.zone, plan.south_hemisphere) == (zone, south) + pen = FakePen() + sheet._draw_grid(pen, plan) + x0, y0, x1, y1 = plan.map_rect + eastings, northings = set(), set() + for line in pen.lines: + places = [sheet.to_utm(*place_at(plan, x, y), zone, south) for x, y in line] + for x, y in line: + assert x0 - 1e-6 <= x <= x1 + 1e-6 and y0 - 1e-6 <= y <= y1 + 1e-6 + spread_e = max(i[0] for i in places) - min(i[0] for i in places) + value = places[0][0] if spread_e < 1 else places[0][1] + assert value == pytest.approx(round(value / 1000) * 1000, abs=0.5) + for easting, northing in places: + assert (easting if spread_e < 1 else northing) == pytest.approx(value, abs=0.5) + (eastings if spread_e < 1 else northings).add(round(value)) + # A quadrangle is several kilometers each way, and every kilometer has its line. + for values in (eastings, northings): + assert len(values) >= 5 + assert sorted(values) == list(range(min(values), max(values) + 1, 1000)) + + # Each line is named in the margin: the first in full, the others by their kilometers. + labels = [text for _, _, text, _ in pen.texts] + for letter in ('mE', 'mN'): + assert len([i for i in labels if i.endswith(letter)]) == 2, labels + assert len([i for i in labels if i.isdigit()]) >= 12, labels + # And where the line meets the edge of the map. + for x, y, text, align in pen.texts: + if align == 'center': + edge = y0 if y < y0 else y1 + meters = int(text[:-2]) if text.endswith('mE') else int(text) * 1000 + assert sheet.to_utm(*place_at(plan, x, edge), zone, south)[0] == pytest.approx(meters, abs=0.5) + + +def test_grid_labels_keep_clear_of_coordinates(): + """A line of the grid which meets the edge where a coordinate is written is not named there.""" + plan = sheet.plan_sheet(MAP_WIDTH, MAP_HEIGHT, ANCHORAGE, Sheet()) + pen = FakePen() + sheet._draw_grid(pen, plan) + across, up = sheet._graticule_labels(plan) + for x, y, text, align in pen.texts: + if align == 'center': + assert all(not low < x < high for low, high in across), text + else: + assert all(not low < y - sheet.LABEL_SIZE * 0.35 < high for low, high in up), text + + +def test_no_tick_at_a_corner(): + """The edges of the picture the browser draws are a hair outside the quadrangle's. The corner is still the + corner: it is not also a tick, written over the corner's own coordinate.""" + plan = sheet.plan_sheet(MAP_WIDTH, MAP_HEIGHT, [-149.87500012, 61.12499878, -149.74999988, 61.25000121], + Sheet()) + pen = FakePen() + sheet._draw_graticule(pen, plan) + labels = sorted(text for _, _, text, _ in pen.texts) + assert labels == sorted(2 * ["10'", '12\'30"', "50'", '47\'30"', "149°52'30\"W", "149°45'W", "61°15'N", + '61°07\'30"N']) + # Two ticks on each edge, and a cross (two lines) where each tick of latitude meets one of longitude. + assert len(pen.lines) == 4 * 2 + 4 * 2 + + +def test_clip(): + rect = (0, 0, 10, 10) + assert sheet._clip([(-5, 5), (15, 5)], rect) == [[(0, 5), (10, 5)]] + assert sheet._clip([(2, 2), (4, 4), (6, 2)], rect) == [[(2, 2), (4, 4), (6, 2)]] + # Out of the rectangle and in again is two lines. + assert sheet._clip([(2, 5), (5, 15), (8, 5)], rect) == [[(2, 5), (3.5, 10)], [(6.5, 10), (8, 5)]] + assert sheet._clip([(-5, -5), (-1, 20)], rect) == [] + assert sheet._clip([(5, 5)], rect) == [] + + +def test_sheet_pdf(): + """A map on a sheet is in the middle of a larger page, with its grid and its margin in layers of their own.""" + plain = build_layered_pdf([ExportLayer('Background', make_image(size=(WIDTH, HEIGHT)))], WIDTH, HEIGHT, DPI, + bounds=ANCHORAGE) + pdf = build() + assert layer_names(plain) == ['Background'] + assert layer_names(pdf) == ['Background', 'UTM grid', 'Sheet'] + + doc = pymupdf.open(stream=pdf, filetype='pdf') + page = doc[0] + plan = sheet.plan_sheet(MAP_WIDTH, MAP_HEIGHT, ANCHORAGE, SHEET) + assert (page.rect.width, page.rect.height) == pytest.approx((plan.width, plan.height), abs=0.01) + # The map is as large as it is without the sheet. + image = page.get_image_rects(page.get_images()[0][0])[0] + assert tuple(image) == pytest.approx(plan.map_rect, abs=0.01) + + text = page.get_text() + # The name and the scale, the corners, the ticks between them, the grid, the bars and the notes. + for expected in ('61°07\'30"N 150°00\'W', '1:24,000', "150°00'W", '149°52\'30"W', "61°15'N", '61°07\'30"N', + "55'", '57\'30"', "10'", '12\'30"', '6790', '342', 'mE', 'mN', 'SCALE 1:24,000', 'KILOMETERS', + 'METERS', '2000', 'MILES', 'FEET', '7000', 'zone 6N', '© OpenStreetMap contributors; Protomaps', + 'Made with WROLPi, 2026-11-15.'): + assert expected in text, expected + + +def test_sheet_layers_can_be_hidden(): + """The grid and the margin are drawn only in their own layers.""" + doc = pymupdf.open(stream=build(), filetype='pdf') + full = doc[0].get_pixmap(dpi=36) + for config in doc.layer_ui_configs(): + if config['text'] in ('UTM grid', 'Sheet'): + doc.set_layer_ui_config(config['number'], action=2) + hidden = doc[0].get_pixmap(dpi=36) + assert full.samples != hidden.samples + # Only the map is left: the margin is as white as paper. + assert hidden.pixel(5, 5) == (255, 255, 255) + assert hidden.color_count() == 2 + + +def test_sheet_georeference_is_of_the_map(): + """The PDF says where the map is, not where the page is.""" + pdf = build() + viewport = read_viewport(pdf) + plan = sheet.plan_sheet(MAP_WIDTH, MAP_HEIGHT, ANCHORAGE, SHEET) + x0, y0, x1, y1 = plan.map_rect + assert viewport['bbox'] == pytest.approx([x0, plan.height - y1, x1, plan.height - y0], abs=0.01) + assert viewport['lpts'] == [0, 1, 0, 0, 1, 0, 1, 1] + assert viewport['gpts'] == [61.25, -150, 61.125, -150, 61.125, -149.875, 61.25, -149.875] + + +def test_sheet_near_a_pole_has_no_grid(): + """UTM stops at 84 degrees north and 80 south.""" + pdf = build(bounds=[0, 84.5, 0.125, 84.625]) + assert layer_names(pdf) == ['Background', 'Sheet'] + assert 'Universal Transverse Mercator' not in page_text(pdf) + assert 'UTM grid' in layer_names(build(bounds=[0, -80, 0.125, -79.875])) + + +def test_sheet_of_a_narrow_map(): + """A map too narrow for a scale bar goes without it.""" + narrow = build_layered_pdf([ExportLayer('Background', make_image(size=(90, 400)))], 90, 400, DPI, + bounds=[0, 84.5, 0.125, 84.625], sheet=Sheet()) + assert 'MILES' not in page_text(narrow) + + +@pytest.mark.parametrize('bounds,name', [ + # The narrowest quadrangles there are, with the longest names. + ([-179.875, 84.875, -179.75, 85], '84°52′30″N 179°52′30″W'), + ([-179.875, -84.875, -179.75, -84.75], '84°52′30″S 179°52′30″W'), + ([10, 84.875, 10.125, 85], '84°52′30″N 10°00′E'), + (ANCHORAGE, '61°07′30″N 150°00′W'), +]) +def test_sheet_title_of_a_narrow_map(bounds, name): + """The name of a map and its scale are not written over each other, however narrow the map is.""" + # As wide as the paper of a 1:24,000 sheet is. + map_width = sheet.map_scale(1, bounds) / 24000 + width, height = round(map_width * DPI / 72), 400 + pdf = build_layered_pdf([ExportLayer('Background', make_image(size=(width, height)))], width, height, DPI, + bounds=bounds, sheet=Sheet(name=name)) + page = pymupdf.open(stream=pdf, filetype='pdf')[0] + titles = [pymupdf.Rect(span['bbox']) for block in page.get_text('dict')['blocks'] for line in block.get('lines', []) + for span in line['spans'] if span['size'] == pytest.approx(sheet.TITLE_SIZE)] + assert len(titles) == 2, titles + assert not titles[0].intersects(titles[1]), titles + # Both are on the page, above the map and what is written along its top edge. + top = sheet.plan_sheet(map_width, height * 72 / DPI, bounds, Sheet(name=name)).map_rect[1] + for title in titles: + assert title in page.rect + assert title.y1 <= top - sheet.LABEL_SIZE + + +def test_plan_norths(): + """A sheet says how far the grid's north and a compass's north are from true north, at the middle of it.""" + plan = sheet.plan_sheet(MAP_WIDTH, MAP_HEIGHT, ANCHORAGE, SHEET) + # West of the middle of its zone the grid leans west; a compass in Alaska points well east. + assert plan.grid_north == pytest.approx(-2.571, abs=0.001) + assert plan.magnetic_north == pytest.approx(magnetic.declination(61.1875, -149.9375, 2026 + 318 / 365), abs=0.01) + assert 13 < plan.magnetic_north < 15 + notes = ' '.join(plan.notes) + assert "Grid north is 2°34' west (46 mils) of true north" in notes + assert re.search(r"Magnetic north is 13°5\d' east \(24\d mils\) of true north at the middle of the map on 2026-11-15," + r" and moves about 0°1\d' west each year \(WMM-2025\)\.", notes), notes + + +def test_plan_compass_which_passes_south(): + """Near the south magnetic pole a compass points almost due south, and within a year passes from a little + west of south to a little east of it. It has moved a little, not most of the way around.""" + plan = sheet.plan_sheet(MAP_WIDTH, MAP_HEIGHT, [140.5, -74, 140.625, -73.875], Sheet(date='2026-11-15')) + assert plan.magnetic_north == pytest.approx(-179.94, abs=0.01) + assert magnetic.load_model().declination(-73.9375, 140.5625, sheet._decimal_year('2027-11-15')) > 179 + notes = ' '.join(plan.notes) + assert "Magnetic north is 179°56' west (3199 mils) of true north" in notes + assert "moves about 0°21' west each year" in notes + + +@pytest.mark.parametrize('date', [None, 'yesterday', '', '2024-12-31', '2030-01-01', '2026-13-45']) +def test_plan_without_a_compass(date): + """Where a compass points is not said when the day is not known, or is not one the model is of.""" + plan = sheet.plan_sheet(MAP_WIDTH, MAP_HEIGHT, ANCHORAGE, Sheet(date=date)) + assert plan.magnetic_north is None + assert 'Magnetic' not in ' '.join(plan.notes) + assert plan.grid_north is not None + + +def test_decimal_year(): + assert sheet._decimal_year('2026-01-01') == 2026 + assert sheet._decimal_year('2026-07-02') == pytest.approx(2026.4986, abs=0.0001) + assert sheet._decimal_year('2028-12-31T10:00:00') == pytest.approx(2028 + 365 / 366) + + +def test_norths_are_on_their_own_sides(): + """In the diagram a north is drawn on the side of true north it is on, and apart from it however near it + is.""" + assert sheet._north_tip(0, 0, 14, 50)[0] > 0 > sheet._north_tip(0, 0, -2.5, 50)[0] + # A north a tenth of a degree off, and one eighty off, are both drawn where they can be seen. + near, far = sheet._north_tip(0, 0, 0.1, 50), sheet._north_tip(0, 0, -80, 50) + assert near[0] == pytest.approx(50 * math.sin(math.radians(7))) + assert far == pytest.approx((-25, -50 * math.cos(math.radians(30)))) + + +def test_sheet_norths_diagram(): + """The diagram of the norths is beside the scale bars, with each angle written; a sheet too narrow for it, + or with nothing to put in it, goes without.""" + text = page_text(build()) + assert 'MN 13°' in text and 'E\n' in text + assert 'GN 2°34\' W 46 MILS' in text + assert re.search(r"MN 13°5\d' E 24\d MILS", text), text + + # No compass: the grid's north is still drawn. + text = page_text(build(sheet_=Sheet())) + assert 'GN 2°34\' W' in text and 'MN' not in text + + # No grid near a pole, but a compass points somewhere; the quadrangle is too narrow for the diagram. + narrow = build_layered_pdf([ExportLayer('Background', make_image(size=(90, 400)))], 90, 400, DPI, + bounds=[0, 84.5, 0.125, 84.625], sheet=Sheet(date='2026-11-15')) + text = page_text(narrow) + assert 'Magnetic north is' in text + assert 'MN ' not in text and 'GN ' not in text + + +def test_sheet_text_which_the_font_can_not_write(): + pdf = build(sheet_=Sheet(name='Карта “map” – 地図', credits=['© Somebody\n\nelse'])) + text = page_text(pdf) + assert '"map" -' in text + assert '© Somebody else' in text + + +def test_sheet_needs_bounds(): + with pytest.raises(InvalidExport, match='edges of the map are needed'): + build_layered_pdf([ExportLayer('Background', make_image())], 60, 90, 72, sheet=Sheet()) + + +@pytest.mark.asyncio +async def test_api_export_pdf_sheet(async_client): + images = [('Background', make_image(size=(WIDTH, HEIGHT)))] + size = dict(width=WIDTH, height=HEIGHT, dpi=DPI) + response, job = await api_export( + async_client, images, bounds=ANCHORAGE, **size, + sheet=dict(name='A quadrangle', credits=['Somebody', 'x' * 500] + ['More'] * 50, date='2026-11-15')) + assert response.status_code == HTTPStatus.OK, response.text + assert layer_names(response.content) == ['Background', 'UTM grid', 'Sheet'] + text = page_text(response.content) + assert 'A quadrangle' in text and 'Somebody' in text + # What is written on a sheet is limited. + assert len(re.findall('More', text)) == 38 + assert 'x' * 301 not in text.replace('\n', '') + + # An empty sheet is a sheet. + response, job = await api_export(async_client, images, bounds=ANCHORAGE, sheet={}, **size) + assert response.status_code == HTTPStatus.OK, response.text + assert 'Sheet' in layer_names(response.content) + + # A sheet which is not one, and a sheet of a map which is nowhere. + for meta in (dict(bounds=ANCHORAGE, sheet='yes'), dict(sheet={})): + response, job = await api_export(async_client, images, **size, **meta) + assert response.status_code == HTTPStatus.BAD_REQUEST, json.dumps(meta) + + +def test_mils(): + """A compass marked in mils has 6,400 of them around.""" + assert sheet.mils(360) == 6400 + assert sheet.mils(90) == 1600 + assert sheet.mils(-2.57) == 46 + assert sheet.mils(0) == 0 + + +def test_sheet_scale_bars(): + """The bars are of kilometers, meters, miles and feet, from the top down.""" + doc = pymupdf.open(stream=build(), filetype='pdf') + tops = {word[4]: word[1] for word in doc[0].get_text('words') + if word[4] in ('KILOMETERS', 'METERS', 'MILES', 'FEET')} + assert sorted(tops, key=tops.get) == ['KILOMETERS', 'METERS', 'MILES', 'FEET'] + gaps = [tops[b] - tops[a] for a, b in (('KILOMETERS', 'METERS'), ('METERS', 'MILES'), ('MILES', 'FEET'))] + assert gaps == pytest.approx([sheet.BAR_SPACING] * 3, abs=0.01) + + +@pytest.mark.parametrize('interval,unit,expected', [ + (40, 'feet', 'CONTOUR INTERVAL 40 FEET'), + (20.0, 'meters', 'CONTOUR INTERVAL 20 METERS'), + (1000, 'feet', 'CONTOUR INTERVAL 1,000 FEET'), + (2.5, 'meters', 'CONTOUR INTERVAL 2.5 METERS'), +]) +def test_sheet_contour_interval(interval, unit, expected): + """A map with contour lines says how far apart they are, under its scale bars and over its notes.""" + plain = sheet.plan_sheet(MAP_WIDTH, MAP_HEIGHT, ANCHORAGE, SHEET) + with_contours = Sheet(name=SHEET.name, credits=SHEET.credits, date=SHEET.date, + contour_interval=interval, contour_unit=unit) + plan = sheet.plan_sheet(MAP_WIDTH, MAP_HEIGHT, ANCHORAGE, with_contours) + assert plan.contours == expected + assert plain.contours is None + # The page is longer by the room it takes. + assert plan.height == pytest.approx(plain.height + sheet.CONTOUR_LEADING) + + doc = pymupdf.open(stream=build(sheet_=with_contours), filetype='pdf') + lines = {line.strip(): y for _, y, _, _, text, *_ in doc[0].get_text('blocks') for line in text.splitlines()} + assert expected in lines + feet = min(y for line, y in lines.items() if line == 'FEET') + notes = min(y for line, y in lines.items() if line.startswith('Scale 1:24,000')) + assert feet < lines[expected] < notes + assert 'CONTOUR INTERVAL' not in page_text(build()) + + +@pytest.mark.parametrize('interval,unit', [ + (None, 'feet'), (40, None), (40, 'furlongs'), (0, 'feet'), (-40, 'feet'), (math.nan, 'feet'), (math.inf, 'meters'), + ('40', 'feet'), +]) +def test_sheet_contour_interval_which_is_not_one(interval, unit): + """What is not an interval of contour lines is not written.""" + plan = sheet.plan_sheet(MAP_WIDTH, MAP_HEIGHT, ANCHORAGE, Sheet(contour_interval=interval, contour_unit=unit)) + assert plan.contours is None + + +@pytest.mark.asyncio +async def test_api_export_pdf_sheet_contours(async_client): + """The browser says how far apart the contour lines of a map are, and the sheet says it.""" + images = [('Background', make_image(size=(WIDTH, HEIGHT)))] + size = dict(width=WIDTH, height=HEIGHT, dpi=DPI, bounds=ANCHORAGE) + response, job = await api_export(async_client, images, **size, + sheet=dict(contours=dict(interval=40, unit='feet'))) + assert response.status_code == HTTPStatus.OK, response.text + assert 'CONTOUR INTERVAL 40 FEET' in page_text(response.content) + + # What is not an interval is not written, and the map is exported. + for contours in (None, 'yes', {}, dict(interval='40', unit='feet'), dict(interval=True, unit='feet'), + dict(interval=40), dict(interval=40, unit='furlongs'), dict(interval=-1, unit='meters'), + dict(interval=40, unit=['feet'])): + response, job = await api_export(async_client, images, **size, sheet=dict(contours=contours)) + assert response.status_code == HTTPStatus.OK, json.dumps(contours) + assert 'CONTOUR INTERVAL' not in page_text(response.content), json.dumps(contours) + + +BERTHOUD = [-105.125, 40.25, -105.0, 40.375] +BERTHOUD_NEIGHBORS = ['Masonville', 'Loveland', 'Windsor', 'Carter Lake Reservoir', 'Johnstown', 'Hygiene', + 'Longmont', 'Gowanda'] + + +def test_adjoining_quads(): + """The eight quadrangles around a map, from the northwest across and down.""" + assert sheet.adjoining_quads(BERTHOUD) == BERTHOUD_NEIGHBORS + # The edges of what the browser drew are a hair outside the quadrangle. + assert sheet.adjoining_quads([-105.1250004, 40.2499998, -104.9999996, 40.3750002]) == BERTHOUD_NEIGHBORS + # Where the USGS has no quadrangles there is nothing to say. + assert sheet.adjoining_quads([2.25, 48.75, 2.375, 48.875]) is None + # At the edge of the land only some of the eight have a name: those out to sea have none. + coast = sheet.adjoining_quads([-124.25, 40.75, -124.125, 40.875]) + assert coast is not None and None in coast and any(coast) + + +def test_sheet_adjoining_quads(): + """A sheet says what the quadrangles around it are called, in a diagram under its bars.""" + size = (630, 820) + pdf = build_layered_pdf([ExportLayer('Background', make_image(size=size))], *size, DPI, bounds=BERTHOUD, + sheet=SHEET) + plan = sheet.plan_sheet(size[0] * 72 / DPI, size[1] * 72 / DPI, BERTHOUD, SHEET) + assert plan.adjoining == BERTHOUD_NEIGHBORS + doc = pymupdf.open(stream=pdf, filetype='pdf') + assert doc[0].rect.height == pytest.approx(plan.height, abs=0.01) + lines = {line.strip(): y for _, y, _, _, text, *_ in doc[0].get_text('blocks') for line in text.splitlines()} + assert 'ADJOINING QUADRANGLES' in lines + for number, name in enumerate(BERTHOUD_NEIGHBORS, start=1): + assert f'{number} {name}' in lines, name + # Under the bars, and over the notes. + notes = min(y for line, y in lines.items() if line.startswith('Scale 1:')) + assert lines['FEET'] < lines['ADJOINING QUADRANGLES'] < lines['8 Gowanda'] < notes + + # The page is longer by the room the diagram takes. + nowhere = [2.25, 48.75, 2.375, 48.875] + without = sheet.plan_sheet(size[0] * 72 / DPI, size[1] * 72 / DPI, nowhere, Sheet()) + with_ = sheet.plan_sheet(size[0] * 72 / DPI, size[1] * 72 / DPI, BERTHOUD, Sheet()) + assert without.adjoining is None + assert with_.height - with_.map_rect[3] == pytest.approx( + without.height - without.map_rect[3] + sheet.ADJOINING_HEIGHT, abs=0.01) + + +def test_sheet_adjoining_quads_where_there_are_none(): + """A map of where the USGS names nothing, and a map too narrow for the diagram, go without it.""" + assert 'ADJOINING' not in page_text(build(bounds=[2.25, 48.75, 2.375, 48.875])) + narrow = build_layered_pdf([ExportLayer('Background', make_image(size=(90, 400)))], 90, 400, DPI, + bounds=BERTHOUD, sheet=Sheet()) + assert 'ADJOINING' not in page_text(narrow) + + +def test_sheet_adjoining_quads_some_unnamed(): + """A quadrangle with no name has no number in the diagram, and the others keep theirs.""" + plan = sheet.plan_sheet(MAP_WIDTH, MAP_HEIGHT, BERTHOUD, Sheet()) + plan.adjoining = ['Northwest', None, None, None, 'East', None, None, 'A name ' + 'far too long ' * 20] + pen = FakePen() + sheet._draw_adjoining(pen, plan, 54, 100) + written = [text for _, _, text, _ in pen.texts] + assert '1 Northwest' in written and '5 East' in written + assert '1' in written and '5' in written and '8' in written + assert not {'2', '3', '4', '6', '7'} & set(written) + # A name too long for its column is cut to fit it. + long = next(text for text in written if text.startswith('8 A name')) + assert pymupdf.get_text_length(long, fontsize=sheet.LABEL_SIZE) <= sheet.ADJOINING_COLUMN + + +@pytest.mark.parametrize('bounds', [ + [-149.875, 61.125, -149.75, 61.25], + [-147.75, 64.75, -147.625, 64.875], + [-156.875, 71.25, -156.75, 71.375], + ANCHORAGE, +]) +def test_adjoining_quads_are_never_the_map_itself(bounds): + """Where a quadrangle is wider than the map (Alaska), the map beside this one may be more of the same + quadrangle. The quadrangle on that side is the next one.""" + own = quads.quad_name(*bounds) + around = sheet.adjoining_quads(bounds) + assert own.name not in around + + +def test_adjoining_quads_of_the_edges_the_map_gives(): + """The edges of an exported map are a hair from those of its quadrangle. What is around it is the same.""" + around = sheet.adjoining_quads([-149.875, 61.125, -149.75, 61.25]) + given = [-149.87500000000014, 61.12499878064878, -149.75000000000023, 61.25000121452442] + assert sheet.adjoining_quads(given) == around + assert around[3:5] == ['Anchorage A-8 NW', 'Anchorage A-7 NW'] + + +def test_adjoining_quads_step_past_the_map(): + """The east of a map in the west of a wide quadrangle is the quadrangle after it, not the rest of it.""" + bounds = [-149.875, 61.125, -149.75, 61.25] + assert quads.quad_name(*bounds).name == 'Anchorage A-8 NE' + # One map east is still Anchorage A-8 NE. + assert quads.quad_name(-149.75, 61.125, -149.625, 61.25).name == 'Anchorage A-8 NE' + around = sheet.adjoining_quads(bounds) + assert around[3:5] == ['Anchorage A-8 NW', 'Anchorage A-7 NW'] + + +LEGEND = dict(ground=[0.9, 0.88, 0.85], lines=[ + dict(label='Highway', color=[1, 1, 1], width=1.2, opacity=1, casing_color=[0.8, 0.8, 0.8], casing_width=2.4), + dict(label='Railway', color=[0.6, 0.7, 0.7], width=0.5, opacity=0.5, dash=[0.15, 0.4]), + dict(label='Contour', color=[0.6, 0.4, 0.2], width=0.25, opacity=0.3), +]) + + +def test_legend_lines(): + """The lines of a legend are what a browser sent of them, as far as they are lines.""" + ground, lines = sheet.legend_lines(LEGEND) + assert ground == (0.9, 0.88, 0.85) + assert [i.label for i in lines] == ['Highway', 'Railway', 'Contour'] + assert lines[0] == sheet.LegendLine(label='Highway', color=(1, 1, 1), width=1.2, opacity=1, + casing_color=(0.8, 0.8, 0.8), casing_width=2.4) + assert lines[1].dash == (0.15, 0.4) and lines[1].opacity == 0.5 and lines[1].casing_color is None + # As it is sent again (to the Job which makes the PDF), it is the same legend. + assert sheet.legend_lines(sheet.legend_as_sent(LEGEND)) == (ground, lines) + assert json.loads(json.dumps(sheet.legend_as_sent(LEGEND)))['lines'][0]['label'] == 'Highway' + + +@pytest.mark.parametrize('legend', [ + None, 'yes', [], {}, dict(lines='roads'), dict(lines=[]), dict(lines=['Highway', None, 7]), + dict(lines=[dict(label='', color=[1, 1, 1], width=1)]), + dict(lines=[dict(label='No color', width=1)]), + dict(lines=[dict(label='No width', color=[1, 1, 1])]), + dict(lines=[dict(label='Two parts', color=[1, 1], width=1)]), + dict(lines=[dict(label='Not numbers', color=['red', 0, 0], width=1)]), + dict(lines=[dict(label='Not a width', color=[1, 0, 0], width='wide')]), + dict(lines=[dict(label='Not a width', color=[1, 0, 0], width=math.nan)]), + dict(lines=[dict(label='Not a width', color=[1, 0, 0], width=True)]), + # Too thin to be seen on the map. + dict(lines=[dict(label='Path or track', color=[1, 0, 0], width=0.02, dash=[0.06, 0.02])]), + dict(lines=[dict(label='Nothing', color=[1, 0, 0], width=0)]), +]) +def test_legend_lines_which_are_not(legend): + """What is not a legend has no lines, and is on white.""" + assert sheet.legend_lines(legend) == (sheet.WHITE, []) + assert sheet.legend_as_sent(legend) is None + + +def test_legend_lines_are_limited(): + """A legend has only so many lines, each named in only so many letters and drawn only so wide.""" + line = dict(label='x' * 500, color=[2, -1, 0.5], width=900, opacity=7, dash=[0, 900] * 20, + casing_color=[0, 0, 0], casing_width=900) + ground, lines = sheet.legend_lines(dict(ground=[5, 5, 5], lines=[line] * 100)) + assert ground == (1, 1, 1) + assert len(lines) == sheet.LEGEND_LINES + assert lines[0].label == 'x' * sheet.LEGEND_LABEL + assert lines[0].color == (1, 0, 0.5) and lines[0].opacity == 1 + assert lines[0].width == sheet.LEGEND_WIDTHS[1] and lines[0].casing_width == 8 + assert lines[0].dash == (0.1, sheet.LEGEND_SAMPLE) * 3 + # A casing with no color, or no width, is no casing; dashes which are not numbers are no dashes. + ground, lines = sheet.legend_lines(dict(lines=[ + dict(label='A', color=[0, 0, 0], width=1, casing_width=2), + dict(label='B', color=[0, 0, 0], width=1, casing_color=[1, 1, 1]), + dict(label='C', color=[0, 0, 0], width=1, dash=[1, 'long']), + ])) + assert [(i.casing_color, i.casing_width, i.dash) for i in lines] == [(None, 0, ())] * 3 + + +def test_sheet_legend(): + """A sheet with a legend has what each line is called beside a piece of it, under the bars and over the + notes, and is longer for it.""" + with_legend = Sheet(name=SHEET.name, credits=SHEET.credits, date=SHEET.date, legend=LEGEND) + plain = sheet.plan_sheet(MAP_WIDTH, MAP_HEIGHT, ANCHORAGE, SHEET) + plan = sheet.plan_sheet(MAP_WIDTH, MAP_HEIGHT, ANCHORAGE, with_legend) + assert [i.label for i in plan.legend] == ['Highway', 'Railway', 'Contour'] and not plain.legend + assert plan.legend_ground == (0.9, 0.88, 0.85) + # One row of lines: the map is wide enough for the three side by side. + assert plan.height == pytest.approx( + plain.height + sheet.LABEL_SIZE + 8 + sheet.LEGEND_ITEM_HEIGHT + 8) + + doc = pymupdf.open(stream=build(sheet_=with_legend), filetype='pdf') + words = {word[4]: (word[0], word[1]) for word in doc[0].get_text('words')} + assert words['LEGEND'][1] < words['Highway'][1] == words['Railway'][1] == words['Contour'][1] + assert words['FEET'][1] < words['LEGEND'][1] and words['Highway'][1] < words['Scale'][1] + assert words['Railway'][0] - words['Highway'][0] == pytest.approx(sheet.LEGEND_ITEM_WIDTH, abs=0.01) + assert 'LEGEND' not in page_text(build()) + # The lines are drawn in their own colors: the page has the brown of a contour line. + colors = {tuple(round(c, 2) for c in d['color']) for d in doc[0].get_drawings() if d.get('color')} + assert (0.6, 0.4, 0.2) in colors and (0.6, 0.7, 0.7) in colors + + +def test_sheet_legend_of_many_lines_is_in_rows(): + lines = [dict(label=f'Line {i}', color=[0, 0, 0], width=1) for i in range(9)] + plan = sheet.plan_sheet(MAP_WIDTH, MAP_HEIGHT, ANCHORAGE, Sheet(legend=dict(lines=lines))) + columns = int(MAP_WIDTH // sheet.LEGEND_ITEM_WIDTH) + assert 1 < columns < 9 + pen = FakePen() + sheet._draw_legend(pen, plan, 54, 100) + places = {text: (x, y) for x, y, text, _ in pen.texts} + # The line after the last of a row is under the first of it. + assert places[f'Line {columns}'][0] == places['Line 0'][0] + assert places[f'Line {columns}'][1] == pytest.approx(places['Line 0'][1] + sheet.LEGEND_ITEM_HEIGHT) + assert places[f'Line {columns - 1}'][1] == places['Line 0'][1] + + +@pytest.mark.asyncio +async def test_api_export_pdf_sheet_legend(async_client): + """The browser says how the lines of a map are drawn, and the sheet has a legend of them.""" + images = [('Background', make_image(size=(WIDTH, HEIGHT)))] + size = dict(width=WIDTH, height=HEIGHT, dpi=DPI, bounds=ANCHORAGE) + response, job = await api_export(async_client, images, **size, sheet=dict(legend=LEGEND)) + assert response.status_code == HTTPStatus.OK, response.text + text = page_text(response.content) + assert 'LEGEND' in text and 'Highway' in text and 'Railway' in text + + # What is not a legend is not drawn, and the map is exported. + for legend in (None, 'yes', [], {}, dict(lines='roads'), dict(lines=[dict(label='No color', width=1)])): + response, job = await api_export(async_client, images, **size, sheet=dict(legend=legend)) + assert response.status_code == HTTPStatus.OK, json.dumps(legend) + assert 'LEGEND' not in page_text(response.content), json.dumps(legend) + + +def test_sheet_legend_name_too_long_for_its_column(): + """What a line is called is cut to the room beside the line, so it is not under the next line.""" + lines = [dict(label='A name which is far too long for it ' + str(i), color=[0, 0, 0], width=1) for i in range(3)] + plan = sheet.plan_sheet(MAP_WIDTH, MAP_HEIGHT, ANCHORAGE, Sheet(legend=dict(lines=lines))) + pen = FakePen() + sheet._draw_legend(pen, plan, 54, 100) + written = [(x, text) for x, _, text, _ in pen.texts if text.startswith('A name')] + assert len(written) == 3 + for x, text in written: + assert len(text) < len(lines[0]['label']) + left = x - sheet.LEGEND_SAMPLE - 5 + assert x + pymupdf.get_text_length(text, fontsize=sheet.LABEL_SIZE) <= left + sheet.LEGEND_ITEM_WIDTH + + +def test_format_angle_of_no_angle(): + """An edge on the equator, or on the prime meridian, is on neither side of it; nor is one a hair from it.""" + assert sheet.format_angle(0, 'N', 'S') == "0°00'" + assert sheet.format_angle(-1e-7, 'E', 'W') == "0°00'" + assert sheet.format_angle(1e-7, 'N', 'S') == "0°00'" + assert sheet.format_angle(-0.125, 'N', 'S') == "0°07'30\"S" + + +@pytest.mark.parametrize('bounds,zone', [ + # The edges the map gives are a hair outside the quadrangle. + ([10, 83.8749999, 10.125, 84.0000001], 32), + ([10, -80.0000001, 10.125, -79.875], 32), + # Past where the zones end. + ([10, 84, 10.125, 84.125], None), + ([10, -80.125, 10.125, -80], None), +]) +def test_sheet_grid_where_the_zones_end(bounds, zone): + """A map which ends where the UTM zones do (84 north, 80 south) has a grid; one past there has none.""" + plan = sheet.plan_sheet(300, 600, bounds, sheet.Sheet()) + assert plan.zone == zone + + +@pytest.mark.parametrize('date', ['9999-12-31', '0000-01-01', 'yesterday', '', None]) +def test_sheet_of_no_such_day(date): + """A sheet whose day is not one is a sheet which does not say where magnetic north is.""" + plan = sheet.plan_sheet(300, 600, BERTHOUD, sheet.Sheet(date=date)) + assert plan.magnetic_north is None + + +def test_one_mil_is_a_mil(): + """An angle of one mil is "1 mil", in the notes and under the norths; more are "mils".""" + # Grid north at Berthoud is 0°02' west of true north: one mil. + plan = sheet.plan_sheet(300, 600, BERTHOUD, sheet.Sheet(date='2026-11-19')) + assert sheet.mils(plan.grid_north) == 1 + assert '(1 mil) of true north' in ' '.join(plan.notes) + text = page_text(build_layered_pdf( + [ExportLayer('Background', make_image(size=(WIDTH, HEIGHT)))], WIDTH, HEIGHT, DPI, bounds=BERTHOUD, + sheet=sheet.Sheet(date='2026-11-19'))) + assert '1 MIL' in text and '1 MILS' not in text + # Magnetic north there is many. + assert re.search(r'MN .* \d{2,} MILS', text) diff --git a/modules/map/wmm/WMM2025.COF b/modules/map/wmm/WMM2025.COF new file mode 100644 index 00000000..098c579d --- /dev/null +++ b/modules/map/wmm/WMM2025.COF @@ -0,0 +1,93 @@ + 2025.0 WMM-2025 11/13/2024 + 1 0 -29351.8 0.0 12.0 0.0 + 1 1 -1410.8 4545.4 9.7 -21.5 + 2 0 -2556.6 0.0 -11.6 0.0 + 2 1 2951.1 -3133.6 -5.2 -27.7 + 2 2 1649.3 -815.1 -8.0 -12.1 + 3 0 1361.0 0.0 -1.3 0.0 + 3 1 -2404.1 -56.6 -4.2 4.0 + 3 2 1243.8 237.5 0.4 -0.3 + 3 3 453.6 -549.5 -15.6 -4.1 + 4 0 895.0 0.0 -1.6 0.0 + 4 1 799.5 278.6 -2.4 -1.1 + 4 2 55.7 -133.9 -6.0 4.1 + 4 3 -281.1 212.0 5.6 1.6 + 4 4 12.1 -375.6 -7.0 -4.4 + 5 0 -233.2 0.0 0.6 0.0 + 5 1 368.9 45.4 1.4 -0.5 + 5 2 187.2 220.2 0.0 2.2 + 5 3 -138.7 -122.9 0.6 0.4 + 5 4 -142.0 43.0 2.2 1.7 + 5 5 20.9 106.1 0.9 1.9 + 6 0 64.4 0.0 -0.2 0.0 + 6 1 63.8 -18.4 -0.4 0.3 + 6 2 76.9 16.8 0.9 -1.6 + 6 3 -115.7 48.8 1.2 -0.4 + 6 4 -40.9 -59.8 -0.9 0.9 + 6 5 14.9 10.9 0.3 0.7 + 6 6 -60.7 72.7 0.9 0.9 + 7 0 79.5 0.0 -0.0 0.0 + 7 1 -77.0 -48.9 -0.1 0.6 + 7 2 -8.8 -14.4 -0.1 0.5 + 7 3 59.3 -1.0 0.5 -0.8 + 7 4 15.8 23.4 -0.1 0.0 + 7 5 2.5 -7.4 -0.8 -1.0 + 7 6 -11.1 -25.1 -0.8 0.6 + 7 7 14.2 -2.3 0.8 -0.2 + 8 0 23.2 0.0 -0.1 0.0 + 8 1 10.8 7.1 0.2 -0.2 + 8 2 -17.5 -12.6 0.0 0.5 + 8 3 2.0 11.4 0.5 -0.4 + 8 4 -21.7 -9.7 -0.1 0.4 + 8 5 16.9 12.7 0.3 -0.5 + 8 6 15.0 0.7 0.2 -0.6 + 8 7 -16.8 -5.2 -0.0 0.3 + 8 8 0.9 3.9 0.2 0.2 + 9 0 4.6 0.0 -0.0 0.0 + 9 1 7.8 -24.8 -0.1 -0.3 + 9 2 3.0 12.2 0.1 0.3 + 9 3 -0.2 8.3 0.3 -0.3 + 9 4 -2.5 -3.3 -0.3 0.3 + 9 5 -13.1 -5.2 0.0 0.2 + 9 6 2.4 7.2 0.3 -0.1 + 9 7 8.6 -0.6 -0.1 -0.2 + 9 8 -8.7 0.8 0.1 0.4 + 9 9 -12.9 10.0 -0.1 0.1 + 10 0 -1.3 0.0 0.1 0.0 + 10 1 -6.4 3.3 0.0 0.0 + 10 2 0.2 0.0 0.1 -0.0 + 10 3 2.0 2.4 0.1 -0.2 + 10 4 -1.0 5.3 -0.0 0.1 + 10 5 -0.6 -9.1 -0.3 -0.1 + 10 6 -0.9 0.4 0.0 0.1 + 10 7 1.5 -4.2 -0.1 0.0 + 10 8 0.9 -3.8 -0.1 -0.1 + 10 9 -2.7 0.9 -0.0 0.2 + 10 10 -3.9 -9.1 -0.0 -0.0 + 11 0 2.9 0.0 0.0 0.0 + 11 1 -1.5 0.0 -0.0 -0.0 + 11 2 -2.5 2.9 0.0 0.1 + 11 3 2.4 -0.6 0.0 -0.0 + 11 4 -0.6 0.2 0.0 0.1 + 11 5 -0.1 0.5 -0.1 -0.0 + 11 6 -0.6 -0.3 0.0 -0.0 + 11 7 -0.1 -1.2 -0.0 0.1 + 11 8 1.1 -1.7 -0.1 -0.0 + 11 9 -1.0 -2.9 -0.1 0.0 + 11 10 -0.2 -1.8 -0.1 0.0 + 11 11 2.6 -2.3 -0.1 0.0 + 12 0 -2.0 0.0 0.0 0.0 + 12 1 -0.2 -1.3 0.0 -0.0 + 12 2 0.3 0.7 -0.0 0.0 + 12 3 1.2 1.0 -0.0 -0.1 + 12 4 -1.3 -1.4 -0.0 0.1 + 12 5 0.6 -0.0 -0.0 -0.0 + 12 6 0.6 0.6 0.1 -0.0 + 12 7 0.5 -0.1 -0.0 -0.0 + 12 8 -0.1 0.8 0.0 0.0 + 12 9 -0.4 0.1 0.0 -0.0 + 12 10 -0.2 -1.0 -0.1 -0.0 + 12 11 -1.3 0.1 -0.0 0.0 + 12 12 -0.7 0.2 -0.1 -0.1 +999999999999999999999999999999999999999999999999 +999999999999999999999999999999999999999999999999 diff --git a/wrolpi/scripts/build_map_quad_names.py b/wrolpi/scripts/build_map_quad_names.py new file mode 100644 index 00000000..e7c0b819 --- /dev/null +++ b/wrolpi/scripts/build_map_quad_names.py @@ -0,0 +1,70 @@ +#!/usr/bin/env python3 +"""Make the index of the names of the USGS 7.5 minute quadrangles which WROLPi ships +(modules/map/quads/usgs_7_5_minute.tsv.gz). + +The names are from the Map Indices of The National Map (U.S. Geological Survey; public domain): + + https://prd-tnm.s3.amazonaws.com/StagedProducts/MapIndices/National/GDB/MapIndices_National_GDB.zip + +Its cells are read with GDAL, which WROLPi does not need otherwise, so that is done first and by hand: + + ogr2ogr -f CSV cells.csv MapIndices_National_GDB.gdb -dialect SQLite -sql "SELECT CELL_NAME, PRIMARY_STATE, + ST_MinX(SHAPE) AS west, ST_MinY(SHAPE) AS south, ST_MaxX(SHAPE) AS east, ST_MaxY(SHAPE) AS north + FROM CellGrid_7_5Minute" + + python3 wrolpi/scripts/build_map_quad_names.py cells.csv + +The index is a line for each quadrangle: its south, west, east and north edges (whole seconds of arc), its name +and its state, between tabs; the lines are in order. +""" +import argparse +import csv +import gzip +import pathlib +import sys + +OUTPUT = pathlib.Path(__file__).resolve().parents[2] / 'modules/map/quads/usgs_7_5_minute.tsv.gz' + + +def seconds(degrees: str) -> int: + return round(float(degrees) * 3600) + + +def read_cells(path: pathlib.Path) -> list: + cells = [] + with path.open(newline='') as fh: + for row in csv.DictReader(fh): + name, state = row['CELL_NAME'].strip(), row['PRIMARY_STATE'].strip() + if not name or not state or state == 'None': + # A cell which is of no state is of no map. + continue + if '\t' in name or '\t' in state: + raise ValueError(f'A tab in the name of a quadrangle: {name!r} {state!r}') + south, west, east, north = (seconds(row[i]) for i in ('south', 'west', 'east', 'north')) + if not (south < north and west < east): + raise ValueError(f'The quadrangle {name!r} has no size: {row}') + cells.append((south, west, east, north, name, state)) + return sorted(cells) + + +def write_index(cells: list, path: pathlib.Path): + text = ''.join('\t'.join(str(i) for i in cell) + '\n' for cell in cells) + path.parent.mkdir(parents=True, exist_ok=True) + with path.open('wb') as fh: + # No name and no time in the file, so the same cells are the same bytes. + with gzip.GzipFile(filename='', mode='wb', fileobj=fh, mtime=0, compresslevel=9) as gz: + gz.write(text.encode()) + + +def main(): + parser = argparse.ArgumentParser(description=__doc__, formatter_class=argparse.RawDescriptionHelpFormatter) + parser.add_argument('cells', type=pathlib.Path, help='The CSV of the cells, as ogr2ogr writes it') + parser.add_argument('--output', type=pathlib.Path, default=OUTPUT) + args = parser.parse_args() + cells = read_cells(args.cells) + write_index(cells, args.output) + print(f'{len(cells)} quadrangles, {args.output.stat().st_size} bytes: {args.output}', file=sys.stderr) + + +if __name__ == '__main__': + main()