diff --git a/sketch_map_tool/static/assets/images/help/1_1_searched_point_marked_pdf.webp b/sketch_map_tool/static/assets/images/help/1_1_searched_point_marked_pdf.webp
new file mode 100644
index 00000000..c9d0b9b0
Binary files /dev/null and b/sketch_map_tool/static/assets/images/help/1_1_searched_point_marked_pdf.webp differ
diff --git a/sketch_map_tool/static/assets/images/help/1_1_searching_by_coordinates.webp b/sketch_map_tool/static/assets/images/help/1_1_searching_by_coordinates.webp
new file mode 100644
index 00000000..a6cfe23e
Binary files /dev/null and b/sketch_map_tool/static/assets/images/help/1_1_searching_by_coordinates.webp differ
diff --git a/sketch_map_tool/static/assets/images/help/1_3_empty_sketch_map_satellite.webp b/sketch_map_tool/static/assets/images/help/1_3_empty_sketch_map_satellite.webp
new file mode 100644
index 00000000..66a070b0
Binary files /dev/null and b/sketch_map_tool/static/assets/images/help/1_3_empty_sketch_map_satellite.webp differ
diff --git a/sketch_map_tool/static/assets/images/help/2_1_sketch_map_a2_photograph.webp b/sketch_map_tool/static/assets/images/help/2_1_sketch_map_a2_photograph.webp
new file mode 100644
index 00000000..6706be9b
Binary files /dev/null and b/sketch_map_tool/static/assets/images/help/2_1_sketch_map_a2_photograph.webp differ
diff --git a/sketch_map_tool/static/assets/images/help/2_1_sketch_map_how_to_photo.webp b/sketch_map_tool/static/assets/images/help/2_1_sketch_map_how_to_photo.webp
new file mode 100644
index 00000000..94c3783d
Binary files /dev/null and b/sketch_map_tool/static/assets/images/help/2_1_sketch_map_how_to_photo.webp differ
diff --git a/sketch_map_tool/static/assets/images/help/data_storage_and_security_workflow.webp b/sketch_map_tool/static/assets/images/help/data_storage_and_security_workflow.webp
new file mode 100644
index 00000000..1e4aee3a
Binary files /dev/null and b/sketch_map_tool/static/assets/images/help/data_storage_and_security_workflow.webp differ
diff --git a/sketch_map_tool/templates/help.html b/sketch_map_tool/templates/help.html
index 3177173c..44e3c9ed 100644
--- a/sketch_map_tool/templates/help.html
+++ b/sketch_map_tool/templates/help.html
@@ -26,6 +26,12 @@
{{ _('Answers to the Frequently Asked Questions can be found in the FAQ
section below.') }}
+
+ {{ _('Here
+ you can download the most important tips and questions for the mapping on one page.') }}
+
@@ -45,7 +51,7 @@
various stages of the process. We apologize for any inconvenience this may cause.
We are committed to continually enhancing the tool,
so please report any technical problems to the Sketch Map Tool user support') }}
+ target="_blank">Sketch Map Tool user support.') }}
@@ -64,7 +70,8 @@
{{ _('Step-by-Step Instructions') }}
{{ _('Begin by selecting your area of interest, either by zooming into the map preview or using the search
- function in the sidebar.') }}
+ function in the sidebar. You can search for place names and coordinates. If you search for a location with
+ coordinates please be aware of the correct structure, which is explained below.') }}
alt="{{ _('Screenshot of the Sketch Map Tool.') }}">
-
-
{{ _('Recommendations:') }}
+
+
{{ _('Searching by coordinates') }}
+
+ {{ _('Using coordinates to search for an accurate location is particularly useful in rural areas.
+ Ensure that the coordinates are in the coordinate reference system WGS 84, expressed as latitude and longitude (LAT and LON).') }}
+
+
+ {{ _('Example: We have the following coordinates of Nairobi in WGS 84: 1.2921° S (latitude) and 36.8219° E (longitude).
+ In the search field just type LAT, LON like shown below:') }}
+
+
+
+
+
+
+
+
+ {{ _('Be sure to include the hemisphere information (South/North, West/East) to avoid errors.') }}
+
+
+ {{ _('If you need to transform your available coordinates into Lat-Lon coordinates first, we recommend using this tool:
+ Online converter to all coordinate systems') }}
+
+
+ {{ _('The marker of your searched point that appears during the map selection, will not be visible on the printed map.
+ If you need this point as a point of reference on your paper Sketch Maps please mark it after you downloaded the PDF.') }}
+
+
+
+
+
+
+
+
{{ _('Recommendations') }}
{{ _('Tailor the extent of your selected area to suit your use case, keeping the following questions in
mind:') }}
@@ -99,18 +141,19 @@
{{ _('Recommendations:') }}
{{ _('Cover all relevant areas for your use case: for example, if studying flooding, focus on areas
near rivers, creeks, sinkholes, and critical infrastructure that might be affected by the flood
event.') }}
-
{{ _('For urban flooding, it is recommended to generate a map on the neighborhood level with streets
- and buildings. For river flooding, it is recommended to generate a map for a larger extent. ') }}
+
{{ _('Choose a suitable zoom level: For example in case urban flooding it is recommended to generate
+ a map on the neighborhood level with streets and buildings.
+ For river flooding, it is recommended to generate a map for a larger extent.') }}
-
{{ _('Choose a fitting base map for your mapping. The decision between the OSM or satellite image base map
+
{{ _('Choose a suitable base map for your mapping needs. The decision between the OSM or satellite image base map
depends on factors like your selected area, the quality of OSM data, your participants, and what you would
like to map.
Sometimes, especially if the satellite image is very dark (e.g., due to large forest areas on the map), it
can be helpful to create two Sketch Maps with both base map layers: Satellite and OSM.') }}
-
{{ _('Customize map format to fit your purpose:') }}
+
{{ _('Customize the map format to fit your purpose:') }}
{{ _('Group mapping is easier on larger maps (A2 or A1, depending on your group size).') }}
{{ _('For data collection in the field, A4 or A3 are easier to handle. If the area is too big,
@@ -132,12 +175,11 @@
{{ _('Recommendations:') }}
1.2 {{ _('Map Quality Check') }}
- {{ _('You can use OpenStreetMap(OSM) as a base map for the
- generated Sketch Maps. The Map Quality Check assists in evaluating the suitability of the area of interest for
- participatory mapping through a quality analysis of the OSM data with the
- HeiGIT ohsome quality analyst.
- The fitness report can be downloaded as a PDF file by clicking on the blue button. It provides an evaluation of
- the suitability of the local OSM data and recommendations for subsequent field data collection.') }}
+ {{ _('When you choose OpenStreetMap (OSM) as base map layer, you will be
+ provided with a report on the map quality in your Area of Interest (AOI). The Map Quality Check gives an evaluation of
+ the suitability of the local OSM data of your AOI for participatory mapping. The report is computed by the
+ ohsome quality API of HeiGIT.
+ The Map Quality Check can be downloaded as a PDF file by clicking on the blue button.') }}
@@ -146,10 +188,10 @@
{{ _('Recommendations:') }}
-
{{ _('Recommendations:') }}
+
{{ _('Recommendations') }}
- {{ _('Before you use these OSM-based maps for participatory mapping in your area of interest,
+ {{ _('Before you use these OSM-based Sketch Maps for participatory mapping in your area of interest,
review the analysis provided by the Map Quality Check to ensure that participants can orient themselves
properly on the paper maps.') }}
@@ -164,8 +206,9 @@
{{ _('Recommendations:') }}
{{ _('In case the OSM data in your area of interest is not sufficient for participatory mapping, consider
- consulting the Missing Maps project
- to improve the OSM data before using the Sketch Map Tool.') }}
+ the opportunity to improve the OSM data before printing the Sketch Maps, by organizing an OSM Mapathon.
+ For more information and help on how to conduct a Mapathon please take a look at the
+ Missing Maps project') }}.
{{ _('Take a look at the map:') }}
@@ -191,15 +234,15 @@
{{ _('Recommendations:') }}
alt="{{ _('Empty Sketch Map, OSM') }}">
-
-
{{ _('Recommendations:') }}
+
+
+
+
+
+
+
{{ _('Recommendations') }}
-
- {{ _('Name your scans/photos appropriately when saving, and before uploading them to the Sketch Map Tool.
- This helps you recognize and allocate your Sketch Maps in the subsequent uploading and analyzing process.
- If you relate Sketch Maps back to questionnaires, use the same number for the map as you did in the
- questionnaire. ') }}
-
{{ _('Prepare separate maps for each topic or per person/group because it is difficult to read and analyze
too many markings from one map.
@@ -209,12 +252,17 @@
{{ _('Recommendations:') }}
{{ _('We recommend printing the maps on matte, non-reflective paper. ') }}
- {{ _('If you plan on printing our your map in black and white, check the visibility of the background map
+ {{ _('Name your maps appropriately, a name on the downloaded and maybe as well on the printed Sketch Map can help
+ you in organizing your maps.
+ If you relate Sketch Maps back to questionnaires, use the same number for the map as you did in the questionnaire.') }}
+
+
+ {{ _('If you plan on printing out your map in black and white, check the visibility of the background map
and reduce saturation in the printing settings if the background becomes too dark.') }}
- {{ _('In case you use a satellite imagery background, please review the color saturation of your image. If
- the background is too dark, you might consider to choose OSM as base map.') }}
+ {{ _('In case you use a satellite imagery background, please review the color saturation of your image. If the
+ background is too dark, you might consider to choose OSM as base map or reduce saturation in the printing settings.') }}
@@ -227,20 +275,21 @@
{{ _('Recommendations:') }}
- {{ _('The Sketch mapping with pens and the printed map is the key part of the Sketch Map Method. How you mark the
- maps influences your results and what can be detected.
- Here you can find here some recommendations for your data collection.') }}
+ {{ _('Mapping through sketches using a pen on a printed Sketch Maps is a core activity of the Sketch Map Tool process. How you mark the Sketch Maps influences your end results: the detected markings.') }}
- {{ _('Example of marked map:') }}
+ {{ _('This section as well as this PDF discusses what you should keep in mind before and during mapping.') }}
+
+
+ {{ _('Example of marked Sketch Map:') }}
-
-
{{ _('Tips to improve color detection') }}
+
{{ _('Tips to improve marking detection') }}
{{ _('The latest version of the Sketch Map Tool leverages advanced Deep Learning models trained to analyze images of
Sketch Maps and identify marked objects within them.
@@ -250,13 +299,13 @@
{{ _('Recommendations:') }}
generalize their understanding and accurately identify markings in new and unseen Sketch Maps.
The Sketch Map Tool also incorporates conventional Computer Vision techniques to precisely position the Sketch Map
within real-world coordinates.
- Georeferencing images entails detecting and matching specific points, such as the globes one the sketch maps,
+ Georeferencing images entails detecting and matching specific points, such as the globes one the Sketch Maps,
between the reference and current input image,
enabling precise spatial alignment. Our current algorithm detects all markings, whether they are intended as a line,
a point or a polygon as a polygon. ') }}
- {{ _('Please make sure not to accidentally mark the globes on the edge as they are used for georeferencing purposes
+ {{ _('Please make sure to not accidentally mark the globes on the edge as they are used for georeferencing purposes
in order to ensure the automatic map detection.') }}
@@ -269,69 +318,53 @@
{{ _('Recommendations:') }}
This needs to be done manually in the subsequent analysis process in your Geographic Information System software.
The GeoTiff can be used to manually match the geodata layer files to the legend information.') }}
-
-
-
{{ _('The photo of the Sketch Map') }}
-
{{ _('The result of the Color detection (the geojson)') }}
-
-
-
-
- {{ _('Image of a Sketch Map marked with red/blue polygons.') }}
-
-
- {{ _('Closed circles are detected as one polygon
- and the whole area will be detected/filled by the software.') }}
-
-
+
+
+
-
+
+ {{ _('Result: Closed circles are detected as one polygon
+ and the whole area will be detected/filled by the software.') }}
+
-
-
-
-
-
- {{ _('Image of a Sketch Map marked with different shapes.') }}
-
-
+
+
+
+
+
-
+ alt="{{ _('Picture of a Sketch Map.') }}">
+ {{ _('Original Image: marked with different shapes.') }}
-
-
-
- {{ _('The shape of everything you write or draw on the map with a colour that the
- tool recognizes can be detected as a marked area (polygon).
- However, in some cases, they may not be detected at all.') }}
-
-
+
+
+
-
+ alt="{{ _('Result of Marking Detection.') }}">
+
+ {{ _('Result: The shape of everything you write or draw on the map with a color that the
+ tool recognizes can be detected as a marked area (polygon).
+ However, in some cases, they may not be detected at all.') }}
+
-
-
-
-
{{ _('Recommendations:') }}
-
-
-
{{ _('To Do') }}
-
{{ _('Not recommended') }} {{ _('You will likely discover problems in the color- detected results') }}
-
-
-
-
+
+
+
+
{{ _('Recommendations') }}
+
+
{{ _('Line Thickness') }}
+
+
+
{{ _('Recommended') }}
{{ _('Use thick felt-tip pens with intense colors.') }}
@@ -340,19 +373,26 @@
{{ _('Recommendations:') }}
alt="{{ _('Picture of a Sketch Map.') }}">
-
-
+
+
+
{{ _('Not recommended') }}
- {{ _('Thin lines in light colors might not be detected. If you decide to use additional colors,
- test which colors work best with the SMT before the mapping activity.') }}
-
-
-
-
-
-
-
+ {{ _('Thin lines in light colors might not be detected. We generally recommend to test your pens and the
+ detectability of your markings with the Sketch Map Tool before your mapping activity.') }}
+
+
+
+
+
+
+
+
+
+
{{ _('Polygon Outlines') }}
+
+
+
{{ _('Recommended') }}
{{ _('For polygons, draw their outline as a closed, strong, and continues shape.
You do not need to fill the polygons, and the pattern you draw in the middle will not be detected.
@@ -363,8 +403,9 @@
{{ _('Recommendations:') }}
alt="{{ _('Picture of a Sketch Map.') }}">
-
-
+
+
+
{{ _('Not recommended') }}
{{ _('Gaps in the outline could lead to mistakes in the detection.') }}
@@ -383,8 +424,8 @@
{{ _('Recommendations:') }}
{{ _('If you just draw a line, the marked area of the line will be detected.
- Nevertheless, we recommend not using lines so far,
- as this could lead to mistakes in the marking detection.') }}
+ Nevertheless, we do not recommend to use lines, since the model has not been trained to detect lines
+ and doing so could lead to mistakes in detection of marking.') }}
{{ _('Recommendations:') }}
- {{ _('If you want to draw a point, draw a larger circle or other shape,
- such as a cross or square in order to be detected well.
- If you want to draw lines, draw simple, non-dashed, and bright enough lines.') }}
+ {{ _('If you want to draw a point, draw a larger circle to improve the detection.
+ If you want to draw lines, draw strong, non-dashed lines with intense colors.') }}
{{ _('Hint: If you need the marking as a line or a point shape,
you can easily transfer it manually or digitalize it yourself,
for example, in QGIS (see Training Exercise 4 )') }}
+ target="_blank">Training Exercise 4)') }}
-
-
-
-
-
{{ _('Satellite Base maps:') }}
+
+
+
+
+
{{ _('Satellite Base maps') }}
+
+
+
{{ _('Recommended') }}
{{ _('Check the darkness of the Satellite base map, especially before printing it in black-and-white.')
}}
{{ _('Make sure you use bright colors and mark the maps especially clearly. Sometimes
- it might be helpful to use both Sketch maps with satellite images
+ it might be helpful to use both Sketch Maps with satellite imagery
and OSM base maps for the mapping.') }}
-
-
+
+
+
{{ _('Not recommended') }}
{{ _('Small polygons can be especially difficult to detected.') }}
-
-
-
+
+
+
-
{{ _('Tips for better comparability and interpretation of the maps') }}
-
- {{ _('Map Orientation') }}
-
+
{{ _('Tips for better comparability and interpretation of the maps') }}
+
{{ _('Map Orientation') }}
{{ _('Orientating on a map can be challenging, depending on the base map, the background of the participants, and their map literacy.
Mapping in groups can make orientation much easier, as participants can assist each other in reading the map. Before you start with the mapping, we recommend:') }}
-
-
-
- {{ _('Start by identifying a common place or points of reference.') }}
-
-
- {{ _('Try to locate the current position or the place of residence of the participant on the map.') }}
-
-
-
+
+
+ {{ _('Start by identifying a common place or points of reference.') }}
+
+
+ {{ _('Try to locate the current position or the place of residence of the participant on the map.') }}
+
+
{{ _('If you like to learn more about the challenges of map orientation and how to choose a good base map, take a look at
Training Exercise 2. In
Training Exercise 3,you can try mapping in groups in a role play.') }}
+
{{ _('Develop a mapping strategy') }}
- {{ _('Develop a mapping strategy') }}
-
-
- {{ _('Prepare a clear data collection and analysis strategy beforehand. A consistent drawing/marking approach in different groups or
- by different people makes the comparison and analysis process easier since the data was collected in a similar way, and you know what it means.
- For this, you should discuss and agree beforehand:') }}
+ {{ _('Prepare a clear data collection and analysis strategy beforehand. A consistent drawing or marking approach across different
+ groups or individuals simplifies the comparison and analysis process, as the data is collected uniformly and its meaning is clear.
+ For this, you should discuss and agree beforehand on:') }}
@@ -473,9 +511,7 @@
{{ _('Recommendations:') }}
Upload the map and check if the result is satisfactory.You can practice the development of a mapping strategy in
Training Exercise 3.') }}
-
- {{ _('Organize your maps') }}
-
+
{{ _('Organize your maps') }}
{{ _('Put a title on your map and add information about the participants, place and time to analyze the maps afterwards.
@@ -489,9 +525,6 @@
{{ _('Recommendations:') }}
{{ _('If you have many participants or you want participants to provide a lot of different information, it is recommended to use individual Sketch Maps for each purpose/topic or per participant.') }}
-
-
-
@@ -505,74 +538,88 @@
{{ _('Recommendations:') }}
- {{ _('After the field data collection, scan or photograph the marked Sketch Maps.
') }}
-
-
-
-
{{ _('Can be digitized properly') }}
-
-
{{ _('Problem: Missing or cut QR-Code
- Without the whole QR-code the map cannot be recognized by the Sketch Map Tool.') }}
-
-
{{ _('Problem: Missing Globs and missing part of the map
- This could lead to mistakes in the georeferencing and missing information on your map..') }}
-
-
{{ _('Problem: Tilted photos of the map
- Can lead to mistakes in the georeferencing.') }}
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
+ {{ _('After the field data collection, scan or photograph the marked Sketch Maps.') }}
-
{{ _('Recommendations:') }}
+
{{ _('Examples') }}
+
{{ _('No Problem: Can be digitized properly') }}
-
+
+
+ {{ _('Problem: Missing or cut QR-Code
+ Without the whole QR-code the map cannot be recognized by the Sketch Map Tool.') }}
+
+
+
+
+
+
+
+
+
+
+
+ {{ _('Problem: Missing Globs and missing part of the map
+ This could lead to mistakes in the georeferencing and missing information on your map..') }}
+
+
+
+
+
+
+
+ {{ _('Problem: Tilted photos of the map
+ Can lead to mistakes in the georeferencing.') }}
+
+
+
+
+
+
+
{{ _('Recommendations') }}
{{ _('The photos must be taken from directly above, at a 180-degree angle
(parallel to the Sketch Map), for optimal image quality.') }}
+
+
+
+
+
+
+
+
+
+
+
+
+ {{ _('For larger paper formats of a Sketch Map (E.g. A2) it can be more challenging to keep the map smooth and to take a proper photo.
+ Easier than photographing from above by laying the map on a table or ground might be to pin
+ or glue your map to a flip-board or a wall first and then take a photo.') }}
+
+
+
+
+
+
+
- {{ _('Pay attention to the lighting conditions when taking a picture.') }}
+ {{ _('Pay attention to the lighting conditions when taking a picture.
+ If you experience problems with the results, for example the georeferencing failed or the markings where not
+ detected probably, please take additional photos of your Sketch Map and upload them again.
+ Small changes in lighting conditions and angels can make a difference! Additionally, you can consider
+ compressing or resizing the original image to a minimum of 1024x1024 pixels before you upload your image.') }}
{{ _('The image of the Sketch Map needs to be uploaded as JPG or PNG (max. file size is 50 MB).
@@ -581,10 +628,15 @@
{{ _('Recommendations:') }}
600 dpi resolution.') }}
- {{ _('If the color detection does not work satisfactorily, you can improve the color contrast
+ {{ _('If the marking detection does not work satisfactorily, you can improve the color contrast
of the markings (with a pen, a new photo, or with photo editing software such as Paint, GIMP,
or Windows Cut & Resize).') }}
+
+ {{ _('Name your scans/photos appropriately when saving, and before uploading them to the Sketch Map Tool.
+ This helps you recognize and allocate your Sketch Maps in the subsequent uploading and analyzing process.
+ If you relate Sketch Maps back to questionnaires, use the same number for the map as you did in the questionnaire.') }}
+
@@ -599,17 +651,15 @@
{{ _('Recommendations:') }}
{{ _('To upload files, you can click on the upload field or drag and drop your files directly into
the upload field and then click on the Upload button. You can upload one or more marked Sketch Maps
- at once. However, they all must be the same base map (same QR-Code) , and all maps will be
- automatically combined in one Geojson in the download files for each color and Sketch Map.
- The upload works for JPG or PNG files. It is possible to upload more than one Sketch Map at the
- same time, but the upload will take longer. For one Sketch Map, it can take up to 100 seconds
- to produce a result, and for a package of 10 Sketch Maps, it can take up to 16 minutes.') }}
+ at once. However, they all must be the same base map (same QR-Code), and the markings of all maps will be
+ automatically combined in one GeoJSON. The upload works for JPG or PNG files.
+ For one Sketch Map, it can take up to 100 seconds to produce a result, and for a package of 10 Sketch Maps, it can take up to 16 minutes.') }}
-
{{ _('Recommendations:') }}
+
{{ _('Recommendations') }}
- {{ _('If you experience problems during the upload process, please check out
+ {{ _('If you experience problems during the upload process, please check out "2.1 Scan or photograph your marked Sketch Maps" above and
the FAQ section below or contact your Sketch Map Tool focal point in your
organization or the Sketch Map Tool user support') }}
@@ -624,14 +674,10 @@
{{ _('Recommendations:') }}
{{ _('Download the markings of the Sketch Maps in different geodata formats (raster data as
GeoTIFF, vector data as a GeoJSON file). You can download the georeferenced Sketch Maps as a
- GeoTIFF or the color-detected markings as vector data in a GeoJSON file. The vector data output
- file consists of different layers for each color and Sketch Map, if you have uploaded more than
- one Sketch Map at once. The GeoTIFF output file consists of a georeferenced picture for each
- of your uploaded Sketch Maps. The GeoJSON file (vector file) consists of the color-detected
- markings from your Sketch Map as a vector layer.') }}
+ GeoTIFF (a georeferenced "picture" for each of your uploaded Sketch Maps) and the color-detected markings as vector data in a GeoJSON file.') }}
-
{{ _('Recommendations:') }}
+
{{ _('Recommendations') }}
{{ _('If you experience problems during the download process, please check out the FAQ section
@@ -650,34 +696,42 @@
{{ _('Recommendations:') }}
- {{ _('The gained geodata can be even more valuable for the communities and humanitarian
- organizations if you create result maps or analyze it further. There are many different
- analyses possible based on your gained map data. If you would like more tips on different
- steps for basic analysis and how to create a result map, take a look at the following
+ {{ _('The gained geodata can be even more valuable for the communities and humanitarian
+ organizations if you create result maps or analyze it further. There are many different
+ analyses possible based on your gained map data.') }}
+
+
+ {{ _('To open, visualize and work with the downloaded geodata you need some type of GIS.
+ We recommend using QGIS because it is open-source and provides the most flexibility for analyzing and visualizing your data.
+ Alternatively you could also use browser based GIS-Applications like uMap.
+ These browser-based applications are easier to use for beginners, but limited in their functionality.
+ Please also keep in mind data security questions when using Online GIS-Applications for visualizing your data!') }}
+
+
+ {{ _('For more tips on how to open and analyze the downloaded geodata and how to create a result map in QGIS as well as in uMap,
+ take a look at the following
QGIS Training Lectures.') }}
+ target="_blank">QGIS Training Lectures.') }}
- {{ _('You can load your resulting geodata files into your GIS software.') }}
+ {{ _('Here you can see an overview on the characteristics of GeoTIFF and GeoJSON and how the results could look like:') }}
-
-
-
{{ _('GeoTiff') }}
-
{{ _('GeoJSON') }}
-
-
-
+
+
+
+
{{ _('GeoTIFF') }}
{{ _('The GeoTIFF output file consists of a georeferenced "picture" for each of your uploaded Sketch
- Maps. When you open the GeoTIFF files in QGIS, it should look similar to this example and show all the
- markings on your sketch map(s) as separate layers. You can view only one of your maps at a time.') }}
+ Maps. When you open the GeoTIFF files in a GIS, it should look similar to this example and show all
+ your sketch map(s) as separate layers. You can view only one of your maps at a time.') }}
-
-
+
+
+
{{ _('GeoJSON') }}
{{ _('If you open the GeoJSON, you can see the detected markings from all uploaded maps as polygons.
When you check the attribute table, you can see that for each marking, the name of the map and the detected color
are specified. With the help of these attributes, you can style your map or conduct analyses.') }}
@@ -691,14 +745,14 @@
{{ _('Recommendations:') }}
alt="{{ _('GEOJSON in QGIS.') }}">
-
-
-
+
+
+
-
{{ _('Recommendations:') }}
+
{{ _('Recommendations') }}
- {{ _('Usage of the GeoTIFF file (raster file) in QGIS:') }}
+ {{ _('The GeoTIFF file (raster file) can be opened in a GIS software like QGIS but can not be opened in many browser-based GIS-Applications like uMap:') }}
{{ _('It can be used, for example, as a background to combine
@@ -708,13 +762,8 @@
{{ _('Recommendations:') }}
- {{ _('Usage of the GeoJSON file (vector file) in QGIS:') }}
+ {{ _('The GeoJSON file (vector file) can be opened as well in QGIS as in many browser-based GIS-Applications like uMap:') }}
-
- {{ _('You can compare the vector output with the raster file to verify the
- marking detection. In case features are not detected or are incorrectly detected,
- you can manipulate your vector file based on the GeoTIFF.') }}
-
+ {{ _('In QGIS: You can compare the vector output with the raster file to verify the marking detection.
+ In case features are not detected or are incorrectly detected, you can manipulate your vector file based on the GeoTIFF.') }}
+
{{ _('If the imported data looks strange and does not represent the actual markings of
- the sketch maps, please check your uploaded sketch map files and, if necessary, scan them again
+ the Sketch Maps, please check your uploaded sketch map files and, if necessary, scan them again
or take new pictures. Please review the recommendations in the sections about the data collection,
then scan, photograph or the upload above and consult our FAQ section about the problems in the colour
detection. If you cannot find your answers there, please contact your Sketch Map Tool focal point in your
@@ -742,6 +795,93 @@
{{ _('Recommendations:') }}
+
{{ _('Data storage and security') }}
+
+ {{ _('Map creation') }}
+
+
+
+ {{ _('Functionally necessary data storage: We need the original map frame to digitize your Sketch Map.
+ The map frames of the created maps are stored for 12 months, giving you the opportunity to digitize your Sketch Map in those 12 months.') }}
+
+
+
+
+
+
+ {{ _('Paper to GIS') }}
+
+
+
+ {{ _('Functionally necessary data storage: Uploaded images of Sketch Maps are stored for processing
+ (georeferencing and marking detection) until the results are generated.') }}
+
+
+ {{ _('The results are stored and available for download for a period of 24 hours, after which they are deleted.') }}
+
+
+
+
+
+
+ {{ _('Share your data for the Improvement of the Sketch Map Tool') }}
+
+
+ {{ _('On a voluntary basis, you can enable us to keep your uploaded Sketch Maps beyond processing to further improve the Sketch Map Tool.') }}
+
+
+
+
{{ _('If you opt-in by checking the check box you enable us to ...') }}
+
+ {{ _('... keep your uploaded Sketch Maps for future improvements of the Sketch Map Tool such as training
+ our machine learning models which detect your markings on the uploaded images.') }}
+
+
+ {{ _('The Sketch Map Tool uses a sequence of machine learning models (SAM and YOLO) to detect the markings on the maps.
+ These models need to be trained with a lot of real-world examples so they are able to identity the markings correctly.') }}
+
+
+ {{ _('Further accuracy improvements can be achieved by incorporating additional real-world cases of marked maps into the models.
+ You can help us here by giving your consent!') }}
+
+
+ {{ _('For more detailed and technical information take a look at our
+ GitHub
+ and the following figure.') }}
+
+
+
+
+
+
+
+
{{ _('If you opt-out by leaving the checkbox unchecked (default) ...') }}
+
+ {{ _('... your uploaded Sketch Maps will be deleted after the results are generated. The results are stored and available for download
+ for a period of 24 hours, after which they are deleted too.') }}
+
+
+
+
+
+
+
+ {{ _('Basic statistics') }}
+
+ {{ _('To get a better insight into the general usage of the Sketch Map Tool we store anonymous data about the map generation
+ (date, centroid, layer, version, page format and orientation).') }}
+
+
+
+
+ {{ _('Questions and concerns') }}
+
+
{{ _('If you have further questions or any concerns please reach us via E-Mail.') }}
+
+
{{ _('It is also possible to set-up the Sketch Map Tool on your own server. In this case, please get in touch with the Sketch Map Tool team.') }}
+
+
{{ _('FAQs') }}
@@ -752,11 +892,13 @@
{{ _('FAQs') }}
- {{ _('What are the quality levels for OSM data used in the tool?')
+ {{ _('What are the quality levels for OSM data used in the Map Quality Check?')
}}
- {{ _('The OSM data is classified with a traffic light system. Green stands for good suitability of the data,
- yellow for possible problems when carrying out a
+ {{ _('Based on the
+ HeiGIT ohsome quality API, the OSM data used in the base map is classified with a traffic light system.
+ Green stands for good suitability of the data, yellow for possible problems when carrying out a
Sketch Map study with OSM-based Sketch Maps, and red for probable problems.
Recommendations are also given on what to consider based on the results.') }}
@@ -769,22 +911,11 @@
{{ _('FAQs') }}
paper.') }}
-
- {{ _('Why is it important to analyze the suitability of OSM data
- before creating a Sketch Map') }}
-
-
- {{ _('OSM data is used for the creation of the Sketch Map. If the OSM data in a study area lack some important
- features, they are missing on the maps as well.
- Thus, the quality of the OSM data is directly related to the quality of the Sketch Maps.
- The features might be relevant for participants to orientate on the map.') }}
-
- {{ _('For which research questions can the Sketch Map Tool
be used?') }}
- {{ _('The Sketch Map Tool has been primarily developed for research questions related to floodings.
+ {{ _('The Sketch Map Tool has been primarily developed for research questions related to flooding.
Since then, it has been used world wide for a variety of topics like vulnerability and capacity mapping or risk
mapping in general.
You can use the Sketch Maps and the Map Quality Check to investigate all kinds of research questions, as long as
@@ -798,7 +929,7 @@
{{ _('FAQs') }}
Sketch Map.
The larger paper formats also allow to hold group discussions about flooded areas. The maps with the markings
can be photographed and uploaded to the tool.
- The georeferenced TIFF and shape files can then be further analyzed or used.') }}
+ The georeferenced GeoTIFF and GeoJSON can then be further analyzed or used.') }}
@@ -809,9 +940,11 @@
{{ _('FAQs') }}
- {{ _('Why are there a QR code and globes on the Sketch Maps?') }}
+ {{ _('Why is there a QR code and globes on the Sketch Maps?') }}
- {{ _('These are required for georeferencing. This is why it is important to have them on the Sketch Maps.') }}
+ {{ _('These are required for georeferencing. The QR Code contains the ID of the reference map frame and the bounding box coordinates.
+ The tool employs computer vision algorithms to match uploaded and reference map frames (mainly based on the globes)
+ before it transforms and georeferences the uploaded Sketch Maps.') }}
@@ -822,22 +955,32 @@
{{ _('FAQs') }}
- {{ _('What do I have to pay attention to in the field?') }}
+ {{ _('What do I need keep in mind for the participatory mapping?') }}
- {{ _('Please make sure not to accidentally mark the globes at the edge as they are needed to improve the
- automatic map detection.
- But if someone accidentally marked the globes, it might still be possible to upload the Sketch Maps. Try the
- automatic detection of the map boundaries.
+ {{ _('Please make sure not to accidentally mark the globes at the edge as they are needed for automatic map detection.
Use thicker felt-tip pens with intense colors; red, blue, and black work best. Prepare the same set of pens for
- all interviewers. Add a number on the Sketch Map and save this number in the questionnaire as well, if you use one.') }}
+ all interviewers.
+ Here
+ you can download the most important tips and questions for the mapping (summarized in a one-pager).') }}
{{ _('How does the georeferencing work?') }}
- {{ _('You can find your answer in the paper
- about the Sketch Map Tool in the paragraph about Image Processing.') }}
+
+ {{ _('Our georeferencing process employs the Binary Robust Invariant Scalable Keypoints (BRISK)
+ method from the OpenCV library for feature matching. It begins by extracting bounding box
+ coordinates and an identification number from a QR code on the uploaded Sketch Map to identify
+ the corresponding unmarked reference map. Using the BRISK algorithm, the marked Sketch Map is
+ aligned with the unmarked map. Later, we use the coordinates of the bounding box to transform the
+ marked map into the world coordinate system (WGS 84), resulting in a georeferenced GeoTIFF file
+ suitable for geospatial analysis.') }}
+
- {{ _('Why does my generated TIFF file look strange?') }}
+ {{ _('Why does my generated GeoTIFF file look strange?') }}
{{ _('Please first try to open the file in a geographic information system (GIS) such as ArcGIS or QGIS.
- The georeferencing may have worked even if the TIFF file does not look right. If it still appears incorrect in
+ The georeferencing may have worked even if the GeoTIFF file does not look right. If it still appears incorrect in
the GIS,
the map might not have been properly detected by the tool in the photo, and there could be various possible
reasons.
@@ -878,10 +1021,29 @@
{{ _('FAQs') }}
{{ _('In case you use a satellite imagery background, please review the color saturation of your image.
- If the background is too dark, you might consider to choose OSM as base map.') }}
+ If the background is too dark, you might consider to choose OSM as base map or adjust the color saturation in the printer settings before printing.') }}
+
+ {{ _('How long are uploaded Sketch Maps stored?') }}
+
+
+ {{ _('The uploaded image(s) of your Sketch Map(s) will be stored on our server for processing (georeferencing and marking detection)
+ until the results are generated. If you consent, the image(s) will be stored long term for future improvements of the Sketch Map Tool such as
+ training our machine learning models which detect your markings on the uploaded images.
+ If you do not give consent, the uploaded images will be deleted after the results are generated.
+ The results are stored and available for download for a period of 24 hours, after which they are deleted too.') }}
+
+
+
+
+ {{ _('How much time do I have to upload the Sketch Maps for the digitization?') }}
+
+
+ {{ _('This is possible for up to 12 months after your maps have been created, after which the digitization will no longer work.') }}
+
+
{% endblock body %}