HP2PS(1)

💅 HP2PS(1) — bestie edition

okay so this is a General Commands Manual page, the star of the show being hp2ps. hi hello, welcome, sit down, we're converting heap profiles into POSTSCRIPT graphs and honestly it's giving main character energy. 🎀

---

✨ NAME ✨

hp2ps — convert a heap profile to a POSTSCRIPT graph 🦋

---

🌸 SYNOPSIS 🌸

hp2ps [flags] [file][.hp]

---

💖 DESCRIPTION 💖

So like, hp2ps takes a heap profile that's chillin' inside file and turns it into a POSTSCRIPT graph, and it sends that graph straight to file.ps. iconic.

By convention, the files you feed to hp2ps have a .hp extension. but — and this is the lowkey important bit — for compatibility with older versions of hp2ps, you can totally omit that extension. no cap.

And if you just... don't give it a file at all? Then the program behaves as a filter. 🫶

---

✨ OPTIONS ✨

The flags are, in order, no skipping, every single one:

• -d — to make graphs more readable, hp2ps sorts the shaded bands for each identifier. The default sort ordering stacks the bands with the largest area on top of the smaller ones. The -d option makes it so the rougher bands — the ones representing series of values with the largest standard deviations — get stacked on top of the smoother ones.
• -b — normally hp2ps puts the title of the graph in a small box at the top of the page. however, if the JOB string is too long to fit in a small box (more than 35 characters), then hp2ps will choose to use a big box instead. The -b option forces hp2ps to use a big box. periodt.
• -e float[in|mm|pt] — generate encapsulated POSTSCRIPT suitable for inclusion in LaTeX documents. Usually, the POSTSCRIPT graph is drawn in landscape mode in an area 9 inches wide by 6 inches high, and hp2ps arranges for this area to be approximately centered on a sheet of a4 paper. This format is convenient for studying the graph in detail, but it is unsuitable for inclusion in LaTeX documents. The -e option causes the graph to be drawn in portrait mode, with float specifying the width in inches, millimetres or points (the default). The resulting POSTSCRIPT file conforms to the Encapsulated Post Script (EPS) convention, and it can be included in a LaTeX document using Rokicki's dvi-to-POSTSCRIPT converter dvips. hp2ps requires the width to exceed 2 inches.
• -g — create output suitable for the gs POSTSCRIPT previewer (or similar). In this case the graph is printed in portrait mode without scaling. the output is unsuitable for a laser printer. noted.
• -p — use previous parameters. By default, the POSTSCRIPT graph is automatically scaled both horizontally and vertically so that it fills the page. However, when preparing a series of graphs for use in a presentation, it is often useful to draw a new graph using the same scale, shading and ordering as a previous one. The -p flag causes the graph to be drawn using the parameters determined by a previous run of hp2ps on file.
• -s — use a small box for the title. 🎀
• -y — draw the graph in the traditional York style, ignoring marks. 👑
• -c — use colours in the rendering of the graphs. 🌈
• -? — print out usage information.

---

🦋 INPUT FORMAT 🦋

The format of a heap profile is best described by example, so here it is, bestie, look at it:

JOB "a.out -p"
DATE "Fri Apr 17 11:43:45 1992"
SAMPLE_UNIT "seconds"
VALUE_UNIT "bytes"
BEGIN_SAMPLE 0.00
  SYSTEM 24
END_SAMPLE 0.00
BEGIN_SAMPLE 1.00
  elim 180
  insert 24
  intersect 12
  disin 60
  main 12
  reduce 20
  SYSTEM 12
END_SAMPLE 1.00
MARK 1.50
MARK 1.75
MARK 1.80
BEGIN_SAMPLE 2.00
  elim 192
  insert 24
  intersect 12
  disin 84
  main 12
  SYSTEM 24
END_SAMPLE 2.00
BEGIN_SAMPLE 2.82
END_SAMPLE 2.82

---

🌈 SEE ALSO 🌈

• dvips(1)
• latex(1)
• hbchp (1)
• lmlchp(1)
• C. Runciman and D. Wakeling, Heap Profiling for Lazy Functional Languages, YCS-172, University of York, 1992

---

📝 NOTES 📝

POSTSCRIPT is a registered trademark of Adobe Systems Incorporated. ✨

---

👑 AUTHOR 👑

David Wakeling of the University of York.

---

and that's the whole page, bestie — 18 April 1992, HP2PS(1), that's the version and the date, mwah 💖 go forth and graph, you absolute icon 🧚