31:[] 2f:{"title":"Spike mark","cells":[{"id":0,"value":"# Spike mark","pinned":false,"hidden":false,"mode":"md"},{"id":358,"value":"🆕 *Updated for Notebook 2.0*","pinned":false,"hidden":false,"mode":"md"},{"id":5,"value":"disclaimer","pinned":false,"hidden":false,"mode":"ojs"},{"id":7,"value":"## 1 - A simple spike","pinned":false,"hidden":false,"mode":"md"},{"id":23,"value":"As the name implies, the **spike mark** is used to draw spikes. The **`width`** and the **`height`** attributes allows to define the size of the spike. To customize the style, you can use svg attributes with camelcase notation such as **`stroke`**, **`fill`**, **`strokeWidth`**, **`fillOpacity`**, **`strokeDasharray`**...","pinned":false,"hidden":false,"mode":"md"},{"id":29,"value":"viz.spike({\n height: 100,\n width: 40,\n fill: \"#38896F\",\n stroke: \"#38896F\"\n})","pinned":true,"hidden":false,"mode":"js"},{"id":357,"value":"Or","pinned":false,"hidden":false,"mode":"md"},{"id":355,"value":"viz.plot({\n type: \"spike\",\n height: 100,\n width: 40,\n fill: \"#38896F\",\n stroke: \"#38896F\"\n})","pinned":true,"hidden":false,"mode":"js"},{"id":35,"value":"The **`straight`** attribute allow to customize the curve (0 = curved ; 1 = straight). ","pinned":false,"hidden":false,"mode":"md"},{"id":40,"value":"let straight = view(Inputs.range([0, 1], { label: \"straight\", step: 0.05 }))","pinned":true,"hidden":false,"mode":"js"},{"id":38,"value":"viz.spike({\n height: 100,\n width: 40,\n fill: \"#38896F\",\n stroke: \"#38896F\",\n straight\n})","pinned":true,"hidden":false,"mode":"js"},{"id":47,"value":"You can use this mark to add a spike to the map, giving its x,y position with the **`pos`** attribute. In this case, the spike is static, it doesn't move when you zoom in on the map.","pinned":false,"hidden":false,"mode":"md"},{"id":52,"value":"let position = [300, 100]","pinned":true,"hidden":false,"mode":"js"},{"id":50,"value":"// Container\n let svg = viz.create({\n width: 500,\n domain: world,\n zoomable: true\n });\n\n // Basemap\n svg.path({ datum: world, fill: \"#CCC\" });\n\n // Spike\n svg.spike({\n pos: position,\n fill: \"#38896F\",\n stroke: \"#38896F\"\n });\n\n // Render\n display(svg.render())\n","pinned":true,"hidden":false,"mode":"js"},{"id":57,"value":"You can also give a geographic position in latitude and longitude. In this case, set **`coords`** to `\"geo\"`. In this case, the spike move when you zoom in on the map. ","pinned":false,"hidden":false,"mode":"md"},{"id":59,"value":"let mumbai = [72.88, 19.07]","pinned":false,"hidden":false,"mode":"js"},{"id":62,"value":"\n // Container\n let svg = viz.create({\n width: 500,\n domain: world,\n zoomable: true\n });\n\n // Basemap\n svg.path({ datum: world, fill: \"#CCC\" });\n\n // Spike\n svg.spike({\n coords: \"geo\",\n pos: mumbai,\n fill: \"#38896F\",\n stroke: \"#38896F\"\n });\n\n // Render\n display(svg.render())\n","pinned":true,"hidden":false,"mode":"js"},{"id":65,"value":"## 2 - Display spikes from a geoJSON","pinned":false,"hidden":false,"mode":"md"},{"id":67,"value":"The mark spike can also be used to draw circles from a geoJSON, using the **`data`** attribute instead of the `pos` attribute. If the input geoJSON contains points, the spikes are mapped onto these points. In the case of polygons or multipolygons, the spike is drawn at the center of the largest polygon. ","pinned":false,"hidden":false,"mode":"md"},{"id":72,"value":"// Container\n let svg = viz.create({\n width: 500,\n zoomable: true,\n domain: world\n });\n\n // Basemap\n svg.path({ datum: world, fill: \"#CCC\" });\n\n // Spikes\n svg.spike({\n data: world,\n width: 10,\n stroke: \"#38896F\",\n straight: 0.5,\n height: 10,\n fill: \"#38896F\"\n });\n\n // Render\n display(svg.render())\n","pinned":true,"hidden":false,"mode":"js"},{"id":92,"value":"## 3 - Proportional spikes","pinned":false,"hidden":false,"mode":"md"},{"id":94,"value":"To vary the height proportionally to an absolute quantitative data, all you have to do is specify the variable name in the **`height`** attribute.","pinned":false,"hidden":false,"mode":"md"},{"id":98,"value":"The **`k`** parameter lets you define the height of the highest spike. The **`fixmax`** parameter allows you to set this height to a specific value. This one is very useful for comparing different maps or for time evolution. ","pinned":false,"hidden":false,"mode":"md"},{"id":144,"value":"viewof k = Inputs.range([10, 100], { label: \"k\", step: 1 })","pinned":false,"hidden":false,"mode":"ojs"},{"id":102,"value":" // Container\n let svg = viz.create({\n width: 1000,\n zoomable: true,\n domain: world\n });\n\n // Basemap\n svg.path({ datum: world, fill: \"#CCC\" });\n\n // Spikes\n svg.spike({\n data: world,\n width: 10,\n k,\n fillOpacity: 1,\n stroke: \"#38896F\",\n straight: 0.5,\n height: \"pop\",\n fill: \"#38896F\",\n tip: true\n });\n\n // Render\n display(svg.render())\n","pinned":true,"hidden":false,"mode":"js"},{"id":107,"value":"## 4 - Legends","pinned":false,"hidden":false,"mode":"md"},{"id":148,"value":"To add a legend corresponding to the mark spike, you can use the functions legend.spikes(). See the [legend](https://observablehq.com/@neocartocnrs/legends) section in the documentation.","pinned":false,"hidden":false,"mode":"md"},{"id":124,"value":"viz.legend.spikes({ spike_stroke: \"#38896F\", title: \"Number of inhabitants\" })","pinned":true,"hidden":false,"mode":"js"},{"id":198,"value":"You can set specific values with the data parameter. ","pinned":false,"hidden":false,"mode":"md"},{"id":203,"value":"viz.legend.spikes({\n data: world.features.map((d) => d.properties.pop),\n values_round: 0,\n spike_stroke: \"#38896F\"\n})","pinned":true,"hidden":false,"mode":"js"},{"id":210,"value":"You can also set your own values","pinned":false,"hidden":false,"mode":"md"},{"id":212,"value":"viz.legend.spikes({\n data: [1, 500, 1000, 1402],\n nb: 4,\n spike_stroke: \"#38896F\"\n})","pinned":true,"hidden":false,"mode":"js"},{"id":159,"value":"Thanks to the nb parameter, you can define the number of spikes to display. With spike_spacing, you can affect the gap between spikes.","pinned":false,"hidden":false,"mode":"md"},{"id":155,"value":"let nb = view(Inputs.range([2, 10], { label: \"nb\", step: 1, value: 7 }))","pinned":false,"hidden":false,"mode":"js"},{"id":180,"value":"let spike_spacing = view(Inputs.range([0, 100], {\n label: \"spike_spacing\",\n step: 1,\n value: 0\n}))","pinned":false,"hidden":false,"mode":"js"},{"id":185,"value":"let spike_width = view(Inputs.range([5, 100], {\n label: \"spike_width\",\n step: 1,\n value: 75\n}))","pinned":false,"hidden":false,"mode":"js"},{"id":328,"value":"let spike_straight = view(Inputs.range([0, 1], {\n label: \"spike_straight\",\n step: 0.1,\n value: 0\n}))","pinned":false,"hidden":false,"mode":"js"},{"id":151,"value":"viz.legend.spikes({\n spike_strokeWidth: 2,\n spike_stroke: \"#38896F\",\n nb,\n gap: 10,\n spike_spacing,\n spike_straight,\n spike_width\n})","pinned":true,"hidden":false,"mode":"js"},{"id":9,"value":"## Appendix","pinned":false,"hidden":false,"mode":"md"},{"id":11,"value":"import { style, world, disclaimer, viz } from \"observable:@neocartocnrs/geoviz-appendix\"","pinned":true,"hidden":false,"mode":"js"},{"id":13,"value":"style","pinned":false,"hidden":false,"mode":"ojs"}],"files":"$W31","stdlib":"2","titling":"auto"}