H5TOTXT(1)

💖 H5TOTXT 💖

okay so bestie, welcome to the h5utils manual, and today's main character is h5totxt — the girl who turns your HDF5 files into cute little comma-delimited text. let's get into it 🎀

---

✨ NAME ✨

h5totxt — generate comma-delimited text from 2d slices of HDF5 files 💅

---

🌸 SYNOPSIS 🌸

h5totxt [OPTION]... [HDF5FILE]...

---

🦋 DESCRIPTION 🦋

So h5totxt is this adorable utility that generates comma-delimited text (and like, similar formats too, she's flexible) from one-, two-, or even more-dimensional slices of numeric datasets sitting inside HDF5 files. The whole point? So you can yeet your data straight into spreadsheets and similar programs for analysis and visualization. it's giving data portability ✨

HDF5 is a free, portable binary format and supporting library, developed by the National Center for Supercomputing Applications at the University of Illinois in Urbana-Champaign. No cap. And a single h5 file can contain multiple datasets — like a little friend group in there. By default, h5totxt takes the first dataset, but you can change that via the -d option, or by using the syntax HDF5FILE:DATASET. iykyk 💅

By default, the entire dataset is dumped to the output. in row-major order. For 3d datasets, this corresponds to a sequence of yz slices, in order of increasing x, separated by blank lines. And if -T is specified, it outputs in the transposed (column-major) order instead. pick your vibe 🌈

Often, however, you want only a one- or two-dimensional slice of multi-dimensional data. To do this, you specify coordinates in one or more slice dimensions, via the -xyzt options. it's giving surgical precision 💅

The most basic usage is something like h5totxt foo.h5, which will output comma-delimited text to stdout from the data in foo.h5. periodt.

---

💅 OPTIONS 💅

• -h — Display help on the command-line options and usage. bestie behavior fr fr
• -V — Print the version number and copyright info for h5totxt.
• -v — Verbose output. she's chatty 🗣️
• -o file — Send text output to file rather than to stdout (the default).
• -s sep — Use the string sep to separate columns of the output rather than a comma (the default). customize ur separator, slay ✨
• -x ix, -y iy, -z iz, -t it — This tells h5totxt to use a particular slice of a multi-dimensional dataset. e.g. -x causes a yz plane (of a 3d dataset) to be used, at an x index of ix (where the indices run from zero to one less than the maximum index in that direction). Here, x/y/z correspond to the first/second/third dimensions of the HDF5 dataset. The -t option specifies a slice in the last dimension, whichever that might be. See also the -0 option to shift the origin of the x/y/z slice coordinates to the dataset center. 👑
• -0 — Shift the origin of the x/y/z slice coordinates to the dataset center, so that e.g. -0 -x 0 (or more compactly -0x0) returns the central x plane of the dataset instead of the edge x plane. (-t coordinates are not affected.) center of attention energy, literally 💅
• -T — Transpose the data (interchange the dimension ordering). By default, no transposition is done.
• -. numdigits — Output numdigits digits after the decimal point (defaults to 16). precision queen 🎀
• -d name — Use dataset name from the input files; otherwise, the first dataset from each file is used. Alternatively, use the syntax HDF5FILE:DATASET, which allows you to specify a different dataset for each file. You can use the h5ls command (included with hdf5) to find the names of datasets within a file. go find ur dataset bestie 🔍

---

💀 BUGS 💀

Send bug reports to S. G. Johnson, stevenj@alum.mit.edu. not me asking u to email a whole human but ok that's literally the instructions 🙈

---

🫶 AUTHORS 🫶

Written by Steven G. Johnson. Copyright (c) 2005 by the Massachusetts Institute of Technology. iconic, we stan 🎀

---

and that's the whole page bestie! this one came from the h5utils manual set, and the date on it is March 9, 2002 — vintage but still serving 💖✨🦋

no notes, u got this 🌸💅👑