NGSPICE(1)

✨ NGSPICE ✨

okay bestie, gather round, because this is the ngspice man page 💅 — a circuit simulator derived from SPICE3f5, and yes she is that girl. 🎀

---

🌸 NAME 🌸

ngspice — a circuit simulator derived from SPICE3f5. no cap, that's literally what she is. 🦋

---

🫶 SYNOPSIS 🫶

ngspice [options] [file ...]

---

💖 DESCRIPTION 💖

okay so real talk: this man page is just a lil overview, she's the appetizer not the meal 🍓. The primary documentation of ngspice lives in the ngspice User's Manual, which you can get as a pdf or an html file. so if you need the deep lore, that's where it's at. ✨

---

👑 OPTIONS 👑

• -n, --no-spiceinit — don't even try to source the file .spiceinit at startup. Normally ngspice goes looking for that file in the current directory first, and if she can't find it there, she checks the user's home directory. this flag says "girl, don't bother". 💅
• -t term, --term=term — the program is being run on a terminal whose mfb name is term. 🌈
• -b, --batch — run in batch mode. ngspice will read the standard input or the specified input file and do the simulation. ⚠️ heads up bestie: if the standard input is not a terminal, ngspice will default to batch mode, unless you gave the -i flag. iykyk.
• -s, --server — run in server mode. this is like batch mode, except a temporary rawfile is used and then written to the standard output, preceded by a line with a single "@", after the simulation is done. this mode is used by the ngspice daemon. serving, literally. 🔥
• -i, --interactive — run in interactive mode. super useful if the standard input is not a terminal but you still want interactive mode. however 👀: command completion is not available unless the standard input is a terminal. tragic, i know. 😭
• -r rawfile, --rawfile=file — use rawfile as the default file into which the results of the simulation get saved. 🎀
• -c circuitfile, --circuitfile=circuitfile — use circuitfile as the default input deck. 📓
• -h, --help — display a verbose help on the arguments available to the program. bestie behavior, honestly. 🫶
• -v, --version — display a version number and copyright information of the program. 💜
• -a, --autorun — FIXME. that's it. that's the whole description. not me leaving it exactly as she is 🙈.
• -o outfile, --output=outfile — all logs generated during a batch run (-b) will be saved in outfile. 🌸
• -p, --pipe — allow a program (e.g., xcircuit) to act as a GUI frontend for ngspice through a pipe. so ngspice will assume that the pipe is a tty and allows one to run in interactive mode. iconic pipeline energy. 🦋

---

any further arguments are taken to be SPICE input decks, which are read and saved. and if batch mode is requested, then they are run immediately. ⭐

---

🌈 ENVIRONMENT 🌈

• SPICE_LIB_DIR
• SPICE_EXEC_DIR
• SPICE_HOST
• SPICE_BUGADDR
• SPICE_EDITOR
• SPICE_ASCIIRAWFILE — default 0. the format of the rawfile. 0 for binary, and 1 for ascii. pick your fighter 💀
• SPICE_NEWS — default $SPICE_LIB_DIR/news. a file which is copied verbatim to stdout when ngspice starts in interactive mode. it's giving morning newsletter ☕✨
• SPICE_MFBCAP — default $SPICE_LIB_DIR/mfbcap
• SPICE_HELP_DIR — default $SPICE_LIB_DIR/helpdir
• SPICE_SCRIPTS — default $SPICE_LIB_DIR/scripts. in this directory the spinit file will be searched. 🔍
• SPICE_PATH — default $SPICE_EXEC_DIR/ngspice

---

💫 various undocumented ngspice centric environment variables 💫

• NGSPICE_MEAS_PRECISION
• SPICE_NO_DATASEG_CHECK

(undocumented. mysterious. main character energy. we simply do not know. 🧚)

---

💜 Common environment variables 💜

• TERM LINES COLS DISPLAY HOME PATH EDITOR SHELL
• POSIXLY_CORRECT

---

🎀 FILES 🎀

• $SPICE_LIB_DIR/scripts/spinit — the System's Initialisation File. 👑
• .spiceinit or $HOME/.spiceinit — the User's Initialisation File. 🫶

---

⭐ SEE ALSO ⭐

sconvert(1), ngnutmeg(1), mfb(3), writedata(3), and the ngspice User's Manual at http://ngspice.sourceforge.net/docs.html

---

🐛 BUGS 🐛

please report bugs to the ngspice project via http://ngspice.sourceforge.net/bugrep.html — she wants to hear from you fr fr 💖

---

👑 AUTHORS 👑

• spice3: Tom Quarles (quarles@cad.berkeley.edu)
• nutmeg: User interface: Wayne Christopher (faustus@cad.berkeley.edu)
• ngspice: various authors (see https://sourceforge.net/projects/ngspice/)

---

and that's the whole page bestie!! 🦋 this overview comes from the General Commands Manual, dated 2014-10-28, and it's page NGSPICE(1) of the manual set. slay, go simulate something. 💅✨🌈