Planning issue .

[sagarpreet-chadha]

Task List ⭐️ :

• 1. A spec for describing the precision of location data in human terms

  • this wouldn't need to be incredibly formal, but we would basically try to write out a very precise and clear description of the role LBL fulfills, abstractly. It could include very clear examples of how location is blurred and how much precision it "degrades" for each level. Does this make sense? [ solved in Revamped Architecture . #65 ]

• 2. A utility library for filtering locations to a specific precision level

  • this would be a mini sub-node module broken out of LBL that could be re-used in LBLD, and also in other apps, that would just do the conversions - no UI or geocoding or anything! This should be pretty easy and could have a set of tests to demonstrate how it works (that could overlap a lot with the spec task above)

[sagarpreet-chadha]

@jywarren ...lets add here 😄 !

[sagarpreet-chadha]

Leaflet Blurred Location Display (LBLD), a library for displaying collections of locations of variable precision

• establish a simple way to instantiate individual locations and collections (based on other Leaflet libraries)
• implement changes to have the library read from the plots2 API as a default and display locations accordingly in LBLD based on zoom level
• define a source URL parameter to point the library at the API
• document how to connect it to the parent app, as modeled at https://github.com/publiclab/inline-markdown-editor/
• explore heatmap or aggregate means of displaying locations that, for example, fall in the same grid square, using varying shades to indicate density
• explore above heatmap display (configurable with a constructor parameter) with ability to click on a grid square to expose a list of points within that square
• set up gh-pages demo
• publish on NPM --- to be done by Jeff :)
• integrate with PublicLab.org and troubleshoot
• publish blog post introducing the library

A utility library for filtering locations to a specific precision level for use in Leaflet Blurred Location (LBL)

• as a self-contained, tested node module that is included into LBL
• determine input types and output formats and develop examples to be used in both tests and documentation
• integrate the module into LBLD, and also in other apps
• the module would just do conversions - no UI or geocoding
• [This is not part of this library : https://github.com/limit zoom level of map ?  blurred-location#3] use the module to implement an option in LBL to limit map input to a precision range, with { max: 14, min: 4 } (i.e. the map would not zoom outside that range nor would coordinates generated fall outside that range of precisions)

[jywarren]

Looking great!

• Let's write tests that assert the markers are shown or hidden as in the new example code!
• let's separate out the UI code like popup code from the data management code using require()
• let's clarify what happens when local static data AND remote url are both provided, or move to do only one or the other per layer
• Let's make a demo of switching between shading and markers modes using a toggle (later when we're ready!) [Done in Revamped Architecture . #65 ]

How do these sound?

[jywarren]

Let's also

• standardize the method names returned by the constructor function to be more readable and clear
• make some functions like getMarkersOfPrecision(int) and filterCoordinatesToPrecison(int)

[jywarren]

Hi @sagarpreet-chadha could you update these checkboxes so I can get synced up about progress? Thank you so much!!!

[sagarpreet-chadha]

@jywarren ...done 👍 !

[jywarren]

OK, we're almost there -- can you check off items again? thank you!!!

[sagarpreet-chadha]

Done 👍 !