EA_IID(1)

👑 EA_IID — the man page, but make it cute 👑

okay bestie, so you know ea_iid(1)? yeah, that one. the entropy assessment tool. it runs IID tests. here's literally everything about it, no notes, no skips, all the flags. you're welcome 💅

---

✨ NAME ✨

ea_iid — run IID tests for entropy assesment 🦋

(and yes, that's how the original spells "assesment", we do not correct the ancestors 💀)

---

🔥 SYNOPSIS 🔥

ea_iid [-i|-c] [-a|-t] [-v] [-q] [-l <index>,<samples> ] <file_name>
[bits_per_symbol]

that's the whole vibe. one file, a bunch of little flags, and optionally a number. iconic honestly 🌸

---

💖 DESCRIPTION 💖

Run IID tests for entropy assesment. that's the mission. that's the whole job. 🎀

• <file_name> — has to be a relative path to a binary file, and that file needs at least 1 million entries (samples). no tiny files, bestie, the math needs data fr fr. 🔥
• [bits_per_symbol] — must be between 1-8, inclusive. if you don't pass it, the value is inferred from the data. by default. she figures it out herself 💅

🌈 the flag pairings

• [-i|-c] — pick one: -i means initial entropy estimate, -c means conditioned sequential dataset entropy estimate</memint>. the initial entropy estimate is the default, so if you say nothing, you get -i. 🙈
• [-a|-t] — pick one: -a produces the H_bitstring assessment using all read bits. -t truncates the bitstring used to produce the H_bitstring assessment to 1000000 bits. testing all data is the default. 🦋

💀 Note, and this one matters: when you're testing binary data, no H_bitstring assessment is produced at all. so -a and -t produce the same results for the initial assessment of binary data. not me warning you before you spend an hour comparing them 😭

🎀 the rest of the flags

• -v — optional verbosity flag for more output. you can stack it, bestie — it can be used multiple times. more v's, more yapping ✨
• -q — quiet mode, less output to screen. and heads up: this overrides any verbose flags. she's louder than -v and she will not be silenced 💅
• -l <index>,<samples> — read the <index> substring of length <samples>. 🍓

samples are assumed to be packed into 8-bit values, where the least significant bits_per_symbol bits constitute the symbol. that's the packing rule, don't fight it. 🧚

💜 the entropy estimate modes, in full

• -i — Initial Entropy Estimate (Section 3.1.3) 👑

Computes the initial entropy estimate H_I as described in Section 3.1.3 (not accounting for H_submitter) using the entropy estimators specified in Section 6.3. if bits_per_symbol is greater than 1, the samples are also converted to bitstrings and assessed to create H_bitstring. for multi-bit symbols, two entropy estimates get computed: H_original and H_bitstring. returns min(H_original, bits_per_symbol X H_bitstring). and the initial entropy estimate itself is:

H_I = min(H_submitter, H_original, bits_per_symbol X H_bitstring)

that's the whole formula, copied exactly, do not @ me. 💖

• -c — Conditioned Sequential Dataset Entropy Estimate (Section 3.1.5.2) 🦋

Computes the entropy estimate per bit h' for the conditioned sequential dataset, if the conditioning function is non-vetted. the samples are converted to a bitstring. returns:

h' = min(H_bitstring)

• -o — Set Output Type to JSON 🌈

changes the output format to JSON and sets the file location for the output file. yes, it's in the option list even though it's not in the synopsis. that's just how she is. 🙈

• --version — prints tool version information. ✨

---

📜 COPYRIGHT 📜

okay bestie, this part is the legal tea and I'm keeping it exactly as-is, because that is the entire point of a legal notice. read it, it's not a vibe, it's a contract 🫶

Disclaimer: NIST-developed software is provided by NIST as a public service. You may use, copy, and distribute copies of the software in any medium, provided that you keep intact this entire notice. You may improve, modify, and create derivative works of the software or any portion of the software, and you may copy and distribute such modifications or works. Modified works should carry a notice stating that you changed the software and should note the date and nature of any such change. Please explicitly acknowledge the National Institute of Standards and Technology as the source of the software.

NIST-developed software is expressly provided "AS IS." NIST MAKES NO WARRANTY OF ANY KIND, EXPRESS, IMPLIED, IN FACT, OR ARISING BY OPERATION OF LAW, INCLUDING, WITHOUT LIMITATION, THE IMPLIED WARRANTY OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE, NON-INFRINGEMENT, AND DATA ACCURACY. NIST NEITHER REPRESENTS NOR WARRANTS THAT THE OPERATION OF THE SOFTWARE WILL BE UNINTERRUPTED OR ERROR-FREE, OR THAT ANY DEFECTS WILL BE CORRECTED. NIST DOES NOT WARRANT OR MAKE ANY REPRESENTATIONS REGARDING THE USE OF THE SOFTWARE OR THE RESULTS THEREOF, INCLUDING BUT NOT LIMITED TO THE CORRECTNESS, ACCURACY, RELIABILITY, OR USEFULNESS OF THE SOFTWARE.

You are solely responsible for determining the appropriateness of using and distributing the software and you assume all risks associated with its use, including but not limited to the risks and costs of program errors, compliance with applicable laws, damage to or loss of data, programs or equipment, and the unavailability or interruption of operation. This software is not intended to be used in any situation where a failure could cause risk of injury or damage to property. The software developed by NIST employees is not subject to copyright protection within the United States.

---

and that's the whole page, bestie. go run some IID tests. slay. periodt. 💅✨

🌸 sign-off time: this was ea_iid version 1.1.5, dated April 2023, living in section EA_IID(1) of the manual. mwah. 💖🦋🎀