Click here to Skip to main content
13,352,175 members (72,718 online)
Click here to Skip to main content
Add your own
alternative version


49 bookmarked
Posted 21 Jun 2010

GHeat .NET

, 21 Jun 2010
Rate this:
Please Sign up or sign in to vote.
gheat ported to C#

SampleWebPage.PNG - Click to enlarge image


This is a fast and free heat mapping tool.


I had the need for a flexible and scalable heat mapping application. A quick Google search lead me to gheat. While playing with the application, I found it slow and not flexible enough to suit my needs. There was no way to quickly and easily add points and the tile generating was slow. So, I decided to attempt a port to C# and here I am now.

Using the Code

For simplicity, I have already written all of the code to get anyone started right out of the box.

UI (In VB)

I have made a session wrapper to store the points for each session. They are accessed through "SessionHandler.PointManager".

Map.aspx contains the code that adds the points to the map.

Dim pm As gheat.PointManager
pm = SessionHandler.PointManager
If pm.PointCount = 0 Then pm.LoadPointsFromFile("points.txt")

To add points dynamically, it is as simple as calling the AddPoint which is in the class PointManager.

pm.AddPoint(New GMap.NET.PointLatLng(30.123866, -92.070673))

If you wish to have to add points via post, I would suggest have a loop that adds each point. Below is an example:

'Post data would look like x,y|x,y
Dim lineSplit() As String
For Each line As String In Request("Address").Split("|")
lineSplit = line.Split(",")
pm.AddPoint(New GMap.NET.PointLatLng(lineSplit(0), lineSplit(1)))

Displaying the Tiles

Tile.aspx contains the code necessary to display the tiles.

Dim image As System.Drawing.Bitmap
Dim stream As New System.IO.MemoryStream()
'Make sure nothing else is being sent
'Set the content type
Response.ContentType = "image/png"
'Get the tile image
image = gheat.GHeat.GetTile(SessionHandler.PointManager, _
Request("colorScheme"), CInt(Request("zoom")), _
CInt(Request("x")), CInt(Request("y")))

'Must save the image to a stream because png's need a stream that can seek back and forth.
image.Save(DirectCast(stream, System.IO.Stream), System.Drawing.Imaging.ImageFormat.Png)
'Don't do anything else and send it to the requester

The Guts (In C#)

Internally, the library Gheat.Net is about 99% identical to the python version. It supports the same color schemes, dots, file structure, and points files. The organization is slightly different in an attempt to streamline and make it more efficient. All of the tiles are generated as needed, but all empty tiles are cached and done so per color scheme, per zoom. Other caching was done for the color scheme and dots, so any additions will not be picked up unless the site is restarted. There is no config file but it is necessary to specify the directory where the dots and color schemes are. This MUST be done prior to any other GHeat code execution, so for web apps it must be done on Application_Start.

Sub Application_Start(ByVal sender As Object, ByVal e As EventArgs)
     Dim baseDirectory As String = HttpRuntime.AppDomainAppPath

     gheat.Settings.BaseDirectory = baseDirectory + "__\etc\"
 End Sub

How Does It Work? (The Idea)

  • Points are drawn onto tiles, the more points the more intense the color (darker).
  • Based on the intensity of the color (darkness) in the tile on a scale of 0-255, it is mapped to the color scheme which is 255 pixels high.
  • Pixel by pixel is mapped and changed based on the color scheme.
  • The tile is trimmed due to it having to be larger to accommodate points on the edges of a tile.
  • Tile is sent out.
  • Everyone now smiles. ;)


While testing, I created a small winform app that goes though a bunch of tiles and stitches them together. This is located in the GheatDeskTop app.


Dim pm As New gheat.PointManager()
Dim g As Graphics
Dim tempImage As System.Drawing.Bitmap
Dim zoom As Integer = 4
Dim startX As Integer = 2
Dim startY As Integer = 5
Dim maxX As Integer = startX + 10
Dim maxY As Integer = startY + 10
Dim canvasImage As New System.Drawing.Bitmap(maxX * 256 - (startX * 256), _
maxY * 256 - (startY * 256), System.Drawing.Imaging.PixelFormat.Format32bppArgb)

gheat.Settings.BaseDirectory = "..\..\..\gheatWeb\__\etc\"

g = Graphics.FromImage(canvasImage)


For x As Integer = startX To maxX
    For y As Integer = startY To maxY
        tempImage = gheat.GHeat.GetTile(pm, "classic", zoom, x, y)
        g.DrawImage(tempImage, New System.Drawing.PointF(x * 256 - _
        (startX * 256), y * 256 - (startY * 256)))
PictureBox1.Image = canvasImage


Thanks to the original gheat project, I would never have thought of how to implement it without the source code.

Image multiplication via a blending images project.

Mercator projection thanks to Great Maps. I would have included the source, but it was extremely large so I just compiled a DLL and included it with the project. I did modify the source slightly to allow for weighted points. The modified file is now included as a separate download. Maybe I will one day explain how that works.


  • 21st June, 2010: Initial post
  • 9th September, 2014: Added Points.cs and PointLatLng.cs from Great Maps


This article, along with any associated source code and files, is licensed under The Code Project Open License (CPOL)


About the Author

Corey Fournier
Software Developer
United States United States
Graduate of University of Louisiana at Lafayette in computer science.

You may also be interested in...

Comments and Discussions

AnswerRe: How to clear overlay between data changes Pin
Corey Fournier10-Apr-12 12:31
memberCorey Fournier10-Apr-12 12:31 
AnswerRe: How to clear overlay between data changes Pin
Corey Fournier10-Apr-12 12:33
memberCorey Fournier10-Apr-12 12:33 
GeneralRe: How to clear overlay between data changes Pin
Member 354017210-Apr-12 13:14
memberMember 354017210-Apr-12 13:14 
GeneralRe: How to clear overlay between data changes Pin
SeanJCo10-Apr-12 14:08
memberSeanJCo10-Apr-12 14:08 
GeneralRe: How to clear overlay between data changes Pin
Corey Fournier11-Apr-12 3:13
memberCorey Fournier11-Apr-12 3:13 
GeneralRe: How to clear overlay between data changes Pin
SeanJCo11-Apr-12 3:50
memberSeanJCo11-Apr-12 3:50 
GeneralRe: How to clear overlay between data changes Pin
Corey Fournier11-Apr-12 4:06
memberCorey Fournier11-Apr-12 4:06 
GeneralRe: How to clear overlay between data changes Pin
SeanJCo11-Apr-12 6:15
memberSeanJCo11-Apr-12 6:15 
I guess we have a different of opinion as to what is polite and what isn't I just think saying "Then I have no answer for you. I would have to trouble shoot it with your code changes and I don't have the time for that" comes across a bit unpolite. But never mind.

I will be happy to share the code after I have found the cause of the problem, the tiles are not being stored in any cache, nor are they being stored in the session, yet each time I change the data it does not change the heatmap. The desktop version works fine, so it my guess that it may be a application level problem, either on the web server at my end or with the Google Map cache. But I will be happy to share my update once I get to the bottom of it.

We all do appreciate the effort you went to in programming and porting this code over, its kinda the same reason why I worked on V2 of Google maps for nothing, for the greater good. I will let you know once I figure it out, and in the meantime if you have any pearls of wisdom on the problem, that would be great.
GeneralRe: How to clear overlay between data changes Pin
Corey Fournier11-Apr-12 11:27
memberCorey Fournier11-Apr-12 11:27 
GeneralRe: How to clear overlay between data changes Pin
SeanJCo11-Apr-12 12:24
memberSeanJCo11-Apr-12 12:24 
GeneralRe: How to clear overlay between data changes Pin
SeanJCo22-Apr-12 7:07
memberSeanJCo22-Apr-12 7:07 
GeneralRe: How to clear overlay between data changes Pin
Corey Fournier20-Jun-12 3:00
memberCorey Fournier20-Jun-12 3:00 
GeneralRe: How to clear overlay between data changes Pin
SeanJCo20-Jun-12 11:57
memberSeanJCo20-Jun-12 11:57 
QuestionBackground transparency Pin
Manuel Pazos22-Feb-12 6:37
memberManuel Pazos22-Feb-12 6:37 
AnswerRe: Background transparency Pin
Corey Fournier22-Feb-12 9:52
memberCorey Fournier22-Feb-12 9:52 
GeneralRe: Background transparency Pin
Manuel Pazos10-Apr-12 6:00
memberManuel Pazos10-Apr-12 6:00 
GeneralRe: Background transparency Pin
Alan Novitskiy19-Jun-12 14:07
memberAlan Novitskiy19-Jun-12 14:07 
QuestionlogScale Pin
cdoger22-Dec-11 12:24
membercdoger22-Dec-11 12:24 
AnswerRe: logScale Pin
Corey Fournier22-Dec-11 16:22
memberCorey Fournier22-Dec-11 16:22 
QuestionWeight Intensity Pin
Demig0d25-Oct-11 12:41
memberDemig0d25-Oct-11 12:41 
AnswerRe: Weight Intensity Pin
Corey Fournier1-Nov-11 8:34
memberCorey Fournier1-Nov-11 8:34 
GeneralParameter for dotsize Pin
Member 789383924-May-11 7:57
memberMember 789383924-May-11 7:57 
GeneralRe: Parameter for dotsize Pin
Corey Fournier24-May-11 8:13
memberCorey Fournier24-May-11 8:13 
QuestionGenerate colors based on weight range Pin
mustafaa turab ali29-Mar-11 10:38
membermustafaa turab ali29-Mar-11 10:38 
AnswerRe: Generate colors based on weight range Pin
Corey Fournier29-Mar-11 10:49
memberCorey Fournier29-Mar-11 10:49 

General General    News News    Suggestion Suggestion    Question Question    Bug Bug    Answer Answer    Joke Joke    Praise Praise    Rant Rant    Admin Admin   

Use Ctrl+Left/Right to switch messages, Ctrl+Up/Down to switch threads, Ctrl+Shift+Left/Right to switch pages.

Permalink | Advertise | Privacy | Terms of Use | Mobile
Web04 | 2.8.180111.1 | Last Updated 21 Jun 2010
Article Copyright 2010 by Corey Fournier
Everything else Copyright © CodeProject, 1999-2018
Layout: fixed | fluid