1.4 Time trace output to CSV file

After BlasterSim completes, a CSV spreadsheet with detailed data the simulation is written. This spreadsheet can be opened in a spreadsheet program like Excel or any other program that supports CSV spreadsheets. The name of the spreadsheet is determined by file name of the input file. The file extension of the input file is removed and the file extension csv is used instead in the CSV output. For example, in § 1.7.2 the file name is springer-example.nml, so the spreadsheet is written to springer-example.csv.

The CSV file contains the following columns:

• •

  t ($t$): Simulation time. Floating-point number. Units of ms.

• •

  m_total ($m_{\text{total}}$): Total mass in the simulation. Floating-point number. Units of mg. This should remain approximately constant and is present for debugging purposes.

• •

  e_total ($e_{\text{total}}$): Total energy in the simulation. Floating-point number. Units of J. This should remain approximately constant and is present for debugging purposes.

• •

  For each control volume $i$ (for a springer this would be the plunger tube, barrel, atmosphere for the plunger tube, and atmosphere for the barrel):

  • –

    x ($x_i$): Position of the projectile/plunger. Floating-point number. Units of m. Not present for constant pressure control volumes like atmospheres.

  • –

    x_dot (${\dot{x}}_i$): Velocity of the projectile/plunger. Floating-point number. Units of m/s. Not present for constant pressure control volumes like atmospheres.

  • –

    m ($m_{i,k}$): Mass of gas $k$. Floating-point number. Units of mg. For constant pressure control volumes (atmospheres), this starts out at zero. This can be used to track leaks to the atmosphere.

  • –

    e ($e_i$): Energy of gas. Floating-point number. Units of J. For constant pressure control volumes (atmospheres), this starts out at zero. BlasterSim does not distinguish between work done on a control volume and leaks at the moment, so this being non-zero does not necessarily indicate anything about leaks.

  • –

    p ($p_i$): Pressure of gas. Floating-point number. Units of kPa.

  • –

    temp ($T_i$): Temperature of gas. Floating-point number. Units of K.

  • –

    rho (${\rho }_i$): Mass density of gas. Floating-point number. Units of kg/m³. Not present for constant pressure control volumes like atmospheres.

  • –

    e_f ($e_{\text{f},i}$): Energy lost due to friction on the projectile/plunger. Floating-point number. Units of J. Not present for one side of a projectile/plunger control volume to avoid double counting.

  • –

    e_s ($e_{\text{s},i}$): Spring potential energy. Floating-point number. Units of J. Not present for one side of a projectile/plunger control volume to avoid double counting.

  • –

    e_k ($e_{\text{k},i}$): Projectile/plunger kinetic energy. Floating-point number. Units of J. Not present for one side of a projectile/plunger control volume to avoid double counting. For control volumes with springs ($m_{\text{spring}}\ne 0$ kg), the added mass from the spring is factored in as well. See equation 2.14 for how the spring mass factors in.

• •

  rc: Return code of run subroutine. Integer. A value of -1 means that BlasterSim will continue to the next time step. A value of 0 means that BlasterSim completed the simulation successfully. Values above 0 indicate an error occurred and are discussed in § 3.1.1.