vacuum: Graph representation of the GHC heap

[ debug, ghc, lgpl, library ] [ Propose Tags ]

Vacuum is a library for extracting graph representations of values from the GHC heap at runtime. Those graphs may then be further processed or translated to various representations for visualization -- like Graphviz, or Ubigraph.

By itself this library is not of much use to most users, unless you want to use the raw graph data to visualize the heap in some (new) way. Most people will want to translate the graph representation to something like GraphViz format, which can then be rendered to a pretty PNG or SVG file for viewing. See the vacuum-graphviz package for more.


[Skip to Readme]

Modules

[Index]

Downloads

Maintainer's Corner

Package maintainers

For package maintainers and hackage trustees

Candidates

  • No Candidates
Versions [RSS] 0.0.1, 0.0.2, 0.0.3, 0.0.4, 0.0.5, 0.0.5.1, 0.0.6, 0.0.7, 0.0.8, 0.0.9, 0.0.91, 0.0.92, 0.0.93, 0.0.94, 0.0.95, 1.0.0, 1.0.0.1, 1.0.0.2, 2.0.0.0, 2.1.0.0, 2.1.0.1, 2.2.0.0
Dependencies array (>=0.3), base (>3 && <5), containers (>=0.4), ghc-prim [details]
License LGPL-3.0-only
Copyright Copyright (c) Matt Morrow 2009, (c) Austin Seipp 2011-2012
Author Matt Morrow
Maintainer Austin Seipp <mad.one@gmail.com>
Category Debug, GHC
Home page http://thoughtpolice.github.com/vacuum
Bug tracker http://github.com/thoughtpolice/vacuum/issues
Source repo head: git clone git://github.com/thoughtpolice/vacuum.git
Uploaded by AustinSeipp at 2012-09-13T07:02:37Z
Distributions
Reverse Dependencies 6 direct, 1 indirect [details]
Downloads 15610 total (36 in the last 30 days)
Rating (no votes yet) [estimated by Bayesian average]
Your Rating
  • λ
  • λ
  • λ
Status Docs uploaded by user
Build status unknown [no reports yet]

Readme for vacuum-2.1.0.1

[back to package description]

Vacuum: visualising the GHC heap

Vacuum is a library for extracting graph representations of values from the GHC heap, at runtime. Those graphs may then be further processed or translated to various representations for visualization -- like Graphviz, or Ubigraph.

travis-ci.org results: Build Status

Homepage.

Installation

It's just a cabal install away on Hackage:

$ cabal install vacuum
# also install the graphviz package, for SVG/PNG rendering:
$ cabal install vacuum-graphviz

Gallery of examples

Want to try before you buy, and see what Vacuum output looks like? Here are some examples:

  • Vacuuming the linked list [1, 2] - Results

More examples will come in the future.

Join in

File bugs in the GitHub issue tracker.

Master git repository:

  • git clone https://github.com/thoughtpolice/vacuum.git

There's also a BitBucket mirror:

  • git clone https://bitbucket.org/thoughtpolice/vacuum.git

Authors

See AUTHORS.txt.

License

LGPLv3. See LICENSE.txt for details.