PHONOPY-BANDPLOT(1)

💖 NAME 💖

phonopy-bandplot — it's the manual page for phonopy-bandplot 2.48.0, and bestie, it's the little command-line cutie that draws your phonon band structure and optionally your DOS right next to it. 🎀

---

✨ DESCRIPTION ✨

So, phonopy-bandplot is the Phonopy bandplot command-line-tool. That's the whole vibe. You feed it your phonon band structure results, it gives you a plot. Slay. 🦋

Here's the usage exactly as it wants it:

usage: phonopy-bandplot [-h] [--hdf5] [--dmax DOS_MAX] [--dos
       DOS_FILENAME]

       [--dos-factor DOS_FACTOR] [--dos-xlabel DOS_XLABEL]
              [--factor FACTOR] [--fmax F_MAX] [--fmin F_MIN] [--gnuplot] [-i
              PDOS_INDICES] [--legend] [-o OUTPUT_FILENAME] [--ylabel YLABEL]
              [--mev] [-t TITLE] [filenames ...]

🌸 positional arguments: 🌸

• filenames — the filenames of your phonon band structure result, and no cap, it's gotta be either band.yaml or band.hdf5 (that second one is only if you bring --hdf5 along 🫶).

💅 options: 💅

• -h, --help — shows this help message and then dips. 👋
• --hdf5 — read HDF5 format, periodt.
• --dmax DOS_MAX — the maximum DOS plotted. Cap it, queen. 👑
• --dos DOS_FILENAME — filename of the dos.dat file you wanna plot right next to the band structure. Them side by side? It's giving main character energy. 💖
• --dos-factor DOS_FACTOR — the factor to be multiplied with the DOS. Math but make it cute. ✨
• --dos-xlabel DOS_XLABEL — specify the x-label of the DOS, because labels matter. 🏷️
• --factor FACTOR — conversion factor to your favorite frequency unit. 🥰
• --fmax F_MAX — maximum frequency plotted.
• --fmin F_MIN — minimum frequency plotted.
• --gnuplot — output in gnuplot data style, iykyk. 🐧
• -i, --indices PDOS_INDICES — indices like 1 2, 3 4 5 6... pick your faves bestie. 🔢
• --legend — show legend. Lowkey essential. 📖
• -o, --output OUTPUT_FILENAME — output filename of the PDF plot. Yes, a PDF. Fr fr. 📄
• --ylabel YLABEL — specify the y-label of the band structure. Label that axis, you icon. 🌟
• --mev — convert unit to meV, assuming THz as the input. ✨
• -t, --title TITLE — the title of the plot. Give it a name, it deserves one. 🎀

---

Okay that's literally everything, no details left behind, we keep it thorough in this house. 💜

Big kiss, this was phonopy-bandplot 2.48.0, dated February 2026, and it's a PHONOPY-BANDPLOT(1) girlie forever. XOXO, go plot something iconic. 🌈💅