class visigoth.map_layers.datagrid.DataGrid(data, lats=None, lons=None, hue_manager=None, sharpen=False)

Create a Data grid plot.


data (list) – data values, organised as a list of rows, where each row is an equal size list of column values

Keyword Arguments
  • lats (list) – a list of the lat values providing the center of each row

  • lons (list) – a list of the lon values providing the center of each column

  • hue_manager (object) – a ContinuousHueManager or DiscreteHueManager

  • sharpen (bool) – produce a sharper image at 2x resolution, slower to run


If lons/lats are None, just creates a rectangular image from the data, this assumes that the data reflects the map projection and boundaries. Don’t set these to None unless you know what you are doing.


(Link to open example in new tab):

Source Code (Link to Github):

# -*- coding: utf-8 -*-

import os
import json
import math

from visigoth import Diagram
from visigoth.common import Legend, Text
from visigoth.map_layers import DataGrid
from visigoth.containers import Map
from visigoth.utils import ContinuousHueManager
from pyproj import Transformer

class CustomProjection(object):
    """Map from pyproj to the interface for projections used for visigoth"""
    def __init__(self, name): = name
        self.to_4326 = Transformer.from_crs(name, "EPSG:4326",always_xy=True)
        self.from_4326 = Transformer.from_crs("EPSG:4326", name,always_xy=True)

    def getName(self):

    def fromLonLat(self, lon_lat):
        return self.from_4326.transform(lon_lat[0], lon_lat[1],)

    def toLonLat(self, e_n):
        return self.to_4326.transform(e_n[0], e_n[1])

# load sea temperatures dataset (2D grid)
sst = json.loads(open(os.path.join(folder,"seatemp.json")).read())

height = len(sst)
width = len(sst[0])

lat_spacing = 180/height
lon_spacing = 360/width

# work out the centers of each cell, first the latitudes
lats = [-90 + ((i+0.5)*lat_spacing) for i in range(height)]

# then the longitudes
lons = [-180 + ((i+0.5)*lon_spacing) for i in range(width)]

d = Diagram(fill="#D0D0D0")

# set up map with global coverage, Mollweide projection
m = Map(fill="#E0E0E0",width=512,projection=CustomProjection("ESRI:54009"),boundaries=((-180,-85),(180,85)))

maxv = -1000
minv = 1000

for row in sst:
    for val in row:
        if val is not None:
            maxv = max(maxv,val)
            minv = min(minv,val)

maxv = math.ceil(maxv)
minv = math.floor(minv)

# hue_manager = ContinuousHueManager(intervals=list(range(minv,maxv+1,2)))
hue_manager = ContinuousHueManager()

# add a huegrid layer to the map using the SST data
cg = DataGrid(sst,lats=lats,lons=lons,sharpen=True,hue_manager=hue_manager)

# add the map, some descriptive text and the legend to the diagram
d.add(Text("sea temperatures (kelvin)"))

html = d.draw(format="html")
f = open("example.html", "w")