Struct DensityMapbox 

pub struct DensityMapbox { /* private fields */ }

A structure representing a density mapbox visualization.

The DensityMapbox struct enables the creation of geographic density visualizations on an interactive map. It displays density or intensity values at geographic locations using latitude and longitude coordinates, with a third dimension (z) representing the intensity at each point. This is useful for visualizing population density, heat maps of activity, or any geographic concentration of values.

Arguments

• data - A reference to the DataFrame containing the data to be plotted.
• lat - A string slice specifying the column name containing latitude values.
• lon - A string slice specifying the column name containing longitude values.
• z - A string slice specifying the column name containing intensity/density values.
• center - An optional array [f64; 2] specifying the initial center point of the map ([latitude, longitude]).
• zoom - An optional u8 specifying the initial zoom level of the map.
• radius - An optional u8 specifying the radius of influence for each point.
• opacity - An optional f64 value between 0.0 and 1.0 specifying the opacity of the density layer.
• z_min - An optional f64 specifying the minimum value for the color scale.
• z_max - An optional f64 specifying the maximum value for the color scale.
• z_mid - An optional f64 specifying the midpoint value for the color scale.
• plot_title - An optional Text struct specifying the title of the plot.
• legend_title - An optional Text struct specifying the title of the legend.
• legend - An optional reference to a Legend struct for customizing the legend.

Example

use plotlars::{DensityMapbox, Plot, Text};
use polars::prelude::*;

// Create sample data with US city population density
let data = df![
    "city_lat" => [40.7128, 34.0522, 41.8781, 29.7604, 33.4484, 37.7749, 47.6062, 42.3601,
                   32.7767, 39.9526, 38.9072, 35.2271, 30.2672, 36.1699, 39.7392],
    "city_lon" => [-74.0060, -118.2437, -87.6298, -95.3698, -112.0740, -122.4194, -122.3321, -71.0589,
                   -79.9309, -75.1652, -77.0369, -80.8431, -97.7431, -115.1398, -104.9903],
    "population_density" => [27000.0, 8092.0, 11841.0, 3540.0, 3165.0, 18581.0, 8386.0, 13321.0,
                             4707.0, 11379.0, 9856.0, 2457.0, 1386.0, 4525.0, 4193.0],
    "city_name" => ["New York", "Los Angeles", "Chicago", "Houston", "Phoenix", "San Francisco",
                    "Seattle", "Boston", "Charleston", "Philadelphia", "Washington DC",
                    "Charlotte", "Austin", "Las Vegas", "Denver"]
].unwrap();

DensityMapbox::builder()
    .data(&data)
    .lat("city_lat")
    .lon("city_lon")
    .z("population_density")
    .center([39.8283, -98.5795])
    .zoom(3)
    .plot_title(
        Text::from("US City Population Density")
            .font("Arial")
            .size(20)
    )
    .build()
    .plot();

Implementations

impl DensityMapbox

pub fn builder<'f1, 'f2, 'f3, 'f4, 'f5>() -> DensityMapboxBuilder<'f1, 'f2, 'f3, 'f4, 'f5>

Examples found in repository

examples/density_mapbox.rs (line 18)

fn main() {
    // Create sample data with US city population density
    let data = df![
        "city_lat" => [40.7128, 34.0522, 41.8781, 29.7604, 33.4484, 37.7749, 47.6062, 42.3601,
                       32.7767, 39.9526, 38.9072, 35.2271, 30.2672, 36.1699, 39.7392],
        "city_lon" => [-74.0060, -118.2437, -87.6298, -95.3698, -112.0740, -122.4194, -122.3321, -71.0589,
                       -79.9309, -75.1652, -77.0369, -80.8431, -97.7431, -115.1398, -104.9903],
        "population_density" => [27000.0, 8092.0, 11841.0, 3540.0, 3165.0, 18581.0, 8386.0, 13321.0,
                                 4707.0, 11379.0, 9856.0, 2457.0, 1386.0, 4525.0, 4193.0],
        "city_name" => ["New York", "Los Angeles", "Chicago", "Houston", "Phoenix", "San Francisco",
                       "Seattle", "Boston", "Charleston", "Philadelphia", "Washington DC",
                       "Charlotte", "Austin", "Las Vegas", "Denver"]
    ].unwrap();

    DensityMapbox::builder()
        .data(&data)
        .lat("city_lat")
        .lon("city_lon")
        .z("population_density")
        .center([39.8283, -98.5795]) // Center of USA
        .zoom(3)
        .plot_title(
            Text::from("US City Population Density")
                .font("Arial")
                .size(20),
        )
        .build()
        .plot();

    println!("Density map plotted!");
}

Trait Implementations

impl Clone for DensityMapbox

fn clone(&self) -> DensityMapbox

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl PlotHelper for DensityMapbox

fn get_layout(&self) -> &LayoutPlotly

fn get_traces(&self) -> &Vec<Box<dyn Trace + 'static>>

impl Serialize for DensityMapbox

fn serialize<__S>(&self, __serializer: __S) -> Result<__S::Ok, __S::Error>

where __S: Serializer,

Serialize this value into the given Serde serializer.