readbin(1)

💾 readbin(1) — the cutest binary file info provider in the whole atlc universe

okay so bestie, this is a page from the General Commands Manual, and it's all about readbin, aka ATLC's binary file information provider. yes, that's the vibe. let's get into it 💅

---

✨ NAME ✨

readbin — ATLC's binary file information provider 🫶

---

🎀 SYNOPSIS 🎀

readbin  filename.bin

that's it. that's the whole call. one (1) argument, no drama. 🌸

---

⚠️ WARNING ⚠️

bestie, listen. this man page is not a complete set of documentation — the complexity of the atlc project makes man pages not an ideal way to document it, although out of completeness, man pages are produced. 😭

The best documentation that was current at the time this version was produced should be found on your hard drive, usually at

/usr/local/share/atlc/docs/html-docs/index.html

although it might be elsewhere if your system administrator chose to install the package elsewhere. 👀 Sometimes, errors are corrected in the documentation and placed at http://atlc.sourceforge.net/ before a new release of atlc is released. And please — if you notice a problem with the documentation, even spelling errors and typos, please let me know. fr fr, they mean it. 🥺

---

🦋 DESCRIPTION 🦋

readbin reports on the number and type of pixels created by the program atlc. that's the whole job. it counts. it tells you. iconic behaviour honestly. ✨

---

💅 OPTIONS 💅

• there are literally no options for readbin

no flags. no toggles. nothing to memorise. the way that this command simply does not need your input beyond a filename... we love a low-maintenance icon. 👑

---

🌈 EXAMPLE 🌈

% readbin coax2.V.bin
file length=127008 bytes = 15876 pixels
there are: 489 ones, 10852 zeros, 0 -ones, 4535 other values

look at her go. 127008 bytes, 15876 pixels, and a full census of every value in there. obsessed. 🔥

---

🍓 FILES 🍓

• atlc-X.Y.Z/docs/html-docs/index.html
  • the full documentation.
• bitmapfile.bmp
  • Original bitmap file. Must be 24-bit colour uncompressed.
• bitmapfile.Ex.bin
  • X-component of E-field as a binary.
• bitmapfile.Ey.bin
  • y-component of E-field as a binary. .
• bitmapfile.E.bin
  • Sqrt(Ex^2+Ey^2), as a binary. bitmapfile.V.bin
• bitmapfile.V.bin
  • Voltage as a binary.

(yeah the bitmapfile.V.bin snuck onto the end of the bitmapfile.E.bin line up there — we're keeping it exactly as the original wrote it, no editing, no cap 🫶)

All the saved binary files (.bin's) are saved as a double precision number for each of the pixels. The first double is the top left, the last the bottom right. 🧚

---

👑 SEE ALSO 👑

go read these too, bestie, they're all in the family:

• atlc(1)
• create_bmp_for_circ_in_circ(1)
• create_bmp_for_circ_in_rect(1)
• create_bmp_for_microstrip_coupler(1)
• create_bmp_for_rect_cen_in_rect(1)
• create_bmp_for_rect_cen_in_rect_coupler(1)
• create_bmp_for_rect_in_circ(1)
• create_bmp_for_rect_in_rect(1)
• create_bmp_for_stripline_coupler(1)
• create_bmp_for_symmetrical_stripline(1)
• design_coupler(1)
• find_optimal_dimensions_for_microstrip_coupler(1)

and the links, because we link:

http://atlc.sourceforge.net                - Home page
http://sourceforge.net/projects/atlc       - Download area
atlc-X.Y.Z/docs/html-docs/index.html       - HTML docs
atlc-X.Y.Z/docs/qex-december-1996/atlc.pdf - theory paper
atlc-X.Y.Z/examples                        - examples

---

and that's the page, babes 💜 this absolute gem was written by Dr. David Kirkby, it's version atlc-4.4.2, dated 28th Sept 2003, and it lives in section readbin(1). mwah. 🎀✨