[[File:Heatmap webreport 51.jpeg|thumb|right|450px|Heatmap report ([https://stamen.com/about/ Stamen Design] Terrain map tiles)example]]<!-- how do I create this example, my attempts show the map zoomed out (I've selected all events and have the entire database selected) but I'm unable to find the heatmap!-->

Once this Report addon has been installed, Heatmap web pages can be generated from the Graphical User Interface Report interface or the Book interface. Report only looks for {{icon|plac}}Places found within a subset of the {{icon|even}}Events related to a group of {{icon|peop}}People.

The output webpage contains an embedded list of GPS coordinates for places with the number of Events occurring at each place. The list is set up for output to the Heatmapping overlay feature of a selected [https://wikipedia.org/wiki/Web_Map_Service Web map service].

* {{man label|Filter:}} ** ''defaults'Entire database''' to (default)** To restrict {{icon|peop}}Person results to match the "<code>Ancestors of <selected person></code>" filter. <br />Other filters include the "<code>Descendants of <selected person></code>" or any of the [[Gramps_{{man version}}_Wiki_Manual_-_Filters#Custom_Filter_Editor|custom filter]] for the Person category.* {{man label|Filter Person:}} Sets the <code><selected person></code> for the filter. <br />This ''defaults'' to the currently [[Gramps_Glossary#active_person|Active Person]]. **{{man button|{{icon|share}}Select Existing a different person}} button opens the {{man label|[[Addon:HeatmapWebReport#Select_a_person_for_the_report_dialog|Select a person for the report]]}} dialog that allows the <code><selected person></code> to be re-designatedchanged. <br />The Share list is initially filtered to the current Active Person, Home Person and any bookmarked persons. <br />{{checkbox|0|* {{man label|Show all}}Name format:}} checkbox allows choosing from an unfiltered People list. 

**'''OpenStreetMap''' (default)

* {{man label|FilepathPoint size:}} <code>15</code> Set the size of the heatmap points.** {{man button| - (Decrease)}} / {{man button| + (Increase)}}* {{man label|File path:}} The file directory where the Web Page file should be saved.** {{man button| Select path }}

====Select a Person person for the report dialog====[[File:Gramplet_HeatmapSelectPerson.png|thumb|right|417px450px|Heatmap - Select Person a person for the report - dialog]] The Share list is initially filtered to the current Active Person, Home Person and any bookmarked persons.  * {{checkbox|0|{{man label|Show all}}}} checkbox allows choosing from an unfiltered People list.

This tab allows the following Event type options to be selected:* {{checkbox|0|{{man label|Birth}}}} If selected, the report plots Birth event [[Gramps_Glossary#place|Place]] data as heatmap datapoints.* {{checkbox|0|{{man label|Death}}}} If selected, the report plots Death event [[Gramps_Glossary#place|Place]] data as heatmap datapoints.* {{checkbox|0|{{man label|Residence}}}} If selected, the The report then plots Residence event [[Gramps_Glossary#place|Place]] data as heatmap datapoints.* {{checkbox|0|{{man label|Occupation}}}} If selected, the report plots Occupation event events [[Gramps_Glossary#place|Place]] data as heatmap datapoints.:

* {{man label|Start latitude:}} <code>50</code> (default) - +90 (north pole) to -90 (south pole). The central latitude for a displayed map.* {{man label|Start longitude:}} <code>10</code> (default) - -180 to 0 for the western hemisphere and 0 to +180 for the eastern hemisphere. The central longitude for a displayed map.* {{man label|Start zoom:}} <code>5</code> (default) - 1 to 18 [8 default]. 1 shows the entire planet surface in about 5 inches square.

== See also = Development history ===

* [https://gramps.discourse.group/t/hotspot-heatmap-for-event-clusters/776 Hotspot heatmap for event clusters] Discourse forum thread]- October 2020* It avoids new libraries by using a folium/leaflet generated html file as template.** [https://leafletjs.com/ Leaflet]