RichardNeill.org

Simulate the Hawaii sensor's responds to a given clocking pattern

Introduction

This is part of my PhD camera system, for simulating the Hawaii sensor and ADC. It combines a physics model of the detector with code to interpret a .pbsim file (simulation replay log from the pulseblaster).
It is very specific to this system, and probably not useful to a wider audience.

Given a pulseblaster program (.pbsrc), it can be parsed and simulated by the pulseblaster-compiler (pb_parse), and then played back into hawaiisim. It's particularly useful for validating that a clocking scheme is correct, and that it will actually address the particular pixels intended. The physics of the detector can also be simulated to a degree (notably light-pattern, noise, and mains-hum).

For example:
hawaiisim -i infile.pbsim -o outfile.dat simulates the clocking scheme and generates an image.
Further details are in the README.txt; also see hawaii_characterise -g

Bugs: the NI4462 ADC does not read one sample per edge (though it should); actually it has one edge and reads a million samples. This is not modelled; instead, we use "FAKEADC".

Installation

  • Documentation is in the README.txt, the man pages, and by invoking each command with -h. Or read the source (in C).
  • To install, simply: make && sudo make install
  • This is Free Software released under the GNU GPL v3+. Please feel free to take it, modify it, package it etc.
  • Author: Richard Neill. Do ask if you would like further information and assistance.

Notes

This was written as part of my PhD Infrared Camera system.
Whereas other programs are likely to be of use to the Internet community, hawaiisim is just part of my system documentation and bibliography.

Download

hawaiisim.tgz

Documents

Some selected files, from the tarball: Readme and Man-pages.
README.txt
hawaiisim.1

Navigation

Return to all programs, site home.