1 Usage

1.3 Running BlasterSim

With BlasterSim placed on your PATH, you can run BlasterSim by typing blastersim in your terminal. With BlasterSim placed in your current directory, you can run BlasterSim by typing ./blastersim on Linux or blastersim on Windows.

The first command line argument is the input file. For example, to run BlasterSim on input.nml, type blastersim input.nml.

If BlasterSim is run without an input file by running the blastersim by itself, BlasterSim will print a message containing information about how to run BlasterSim, the BlasterSim version, and debugging information:

⬇
Usage: blastersim FILENAME
Version: v0.2.0 (2026-03-05 22:43:54 -0500)
Build: debug
Compiler: GCC version 13.3.0
Compiler flags: -mtune=generic -march=x86-64 -g -Og -Wall -Wextra -Werror -pedantic-errors -Wno-do-subscript -Wconversion -Wconversion-extra -Wimplicit-interface -Wunused -Wcharacter-truncation -Winteger-division -std=f2018 -fimplicit-none -fno-unsafe-math-optimizations -finit-real=snan -finit-integer=2147483647 -finit-logical=true -finit-derived -ffree-line-length-132 -fbacktrace -fcheck=all -ffpe-trap=invalid,zero,overflow,underflow,denormal -fprofile-arcs -ftest-coverage -fpre-include=/usr/include/finclude/x86_64-linux-gnu/math-vector-fortran.h
<http://github.com/btrettel/blastersim/>
Written by Ben Trettel.

If BlasterSim is on your PATH, you can run BlasterSim with an input file like blastersim springer-example.nml to simulate the blaster described in the input file. If BlasterSim is placed in your current directory, you can run BlasterSim with an input file like ./blastersim springer-example.nml on Linux or blastersim springer-example.nml on Windows. Using the example input file in § 1.7.2 returns the following:

⬇
SUCCESS!
muzzle velocity: 110.73 m/s