EXTRACT_ASCII(1)

πŸ“¦
version 2026.2 Β· 5 versions
, in ubuntu resolute, ubuntu stonking

πŸ’– extract_ascii(1) πŸ’–

okay bestie, welcome to the user commands section, we're doing extract_ascii today and honestly? it's giving scientific data pipeline and I'm obsessed πŸ¦‹


✨ NAME ✨

extract_ascii β€” the manual page for extract_ascii version 2026.2, no cap πŸ’…


🌸 DESCRIPTION 🌸

so first thing you see when you run this is a whole warning situation, and like, it's not your fault, it's just the library being dramatic. here's exactly what it says:

/usr/lib/python3/dist-packages/pytools/persistent_dict.py:52:
RecommendedHashNotFoundWarning: Unable to import recommended hash
'siphash24.siphash13', falling back to 'hashlib.sha256'. Run 'python3 -m
pip install siphash24' to install the recommended hash.

and then it goes:

warn("Unable to import recommended hash 'siphash24.siphash13', "

like okayyy we get it, no siphash24.siphash13 today, hashlib.sha256 is carrying the team, it's fine, we move 🫢

here's the usage line, screenshot it, memorize it:

usage: extract-ascii.py [OPTIONS] FILES

what does it actually do tho? it extracts the SAXS data from a Nexus file and hands it back to you as a 3 column ascii β€” that's q, I, err in that order, periodt. and the metadata? those get exported in the headers as needed. slay ✨


πŸŽ€ positional arguments πŸŽ€

  • FILE β€” your HDF5 input data, aka the snack you're feeding it πŸ’–

πŸ‘‘ options πŸ‘‘

  • -h, --help β€” shows this help message and dips. iconic behaviour honestly
  • -v, --verbose β€” switches to verbose mode, so it tells you everything it's doing. main character energy πŸ”₯
  • -V, --version β€” shows the program's version number and exits. quick lil flex πŸ’…
  • -a, --all β€” extracts every individual frame, not just the one. go big or go home 🌈
  • -z, --zip β€” extracts every individual frame into a zip-file. so organized, so cute πŸŽ€

and one more thing bestie: extract_ascii.py lets you export the data in inverse nm or inverse A, with possible intensity scaling. yes, units AND scaling, we love options πŸ’œ


πŸ¦‹ SEE ALSO πŸ¦‹

the full documentation for extract_ascii is living its best life as a Texinfo manual. if the info and extract_ascii programs are properly installed at your site, this command:

info extract_ascii

should give you access to the complete manual. go read it, it's lowkey worth it, iykyk πŸ“–βœ¨


okay that's the whole page!! this was extract_ascii version 2026.2, dated March 2026, brought to you from the user commands section of the manual. mwah, love u, go extract some data πŸ’–πŸ«ΆπŸŒΈ

πŸ“¦ where this page comes from