#include <binaryoutput.h>

Saves SMASH collision history to binary file.

This class writes each collision, decay and box wall crossing to the output file. Optionally, one can also write the initial and final particle lists to the same file. The output file is binary and has a block structure.

Details of the output format can be found on the wiki in the User Guide section, look for binary output.

Definition at line 150 of file binaryoutput.h.

Inheritance diagram for smash::BinaryOutputCollisions:

Public Member Functions
	BinaryOutputCollisions (const std::filesystem::path &path, std::string name, const OutputParameters &out_par, const std::vector< std::string > &quantities)
	Create binary particle output. More...

void	at_eventstart (const Particles &particles, const EventLabel &event_label, const EventInfo &event) override
	Writes the initial particle information list of an event to the binary output. More...

void	at_eventend (const Particles &particles, const EventLabel &event_label, const EventInfo &event) override
	Writes the final particle information list of an event to the binary output. More...

void	at_interaction (const Action &action, const double density) override
	Writes an interaction block, including information about the incoming and outgoing particles, to the binary output. More...

Public Member Functions inherited from smash::OutputInterface
	OutputInterface (std::string name)
	Construct output interface. More...

virtual	~OutputInterface ()=0
	Pure virtual destructor to make class abstract and prevent its instantiation. More...

virtual void	at_eventstart (const std::vector< Particles > &, int)
	Output launched at event start after initialization, when particles are generated but not yet propagated. More...

virtual void	at_eventstart (const int, const ThermodynamicQuantity, const DensityType, RectangularLattice< DensityOnLattice >)
	Output launched at event start after initialization, when particles are generated but not yet propagated. More...

virtual void	at_eventstart (const int, const ThermodynamicQuantity, const DensityType, RectangularLattice< EnergyMomentumTensor >)
	Output launched at event start after initialization, when particles are generated but not yet propagated. More...

virtual void	at_eventend (const ThermodynamicQuantity)
	Output launched at event end. More...

virtual void	at_eventend (const std::vector< Particles > &, const int)
	Output launched at event end. More...

virtual void	at_intermediate_time (const Particles &, const std::unique_ptr< Clock > &, const DensityParameters &, const EventLabel &, const EventInfo &)
	Output launched after every N'th time-step. More...

virtual void	at_intermediate_time (const std::vector< Particles > &, const std::unique_ptr< Clock > &, const DensityParameters &)
	Output launched after every N'th timestep. More...

virtual void	thermodynamics_output (const ThermodynamicQuantity, const DensityType, RectangularLattice< DensityOnLattice > &)
	Output to write thermodynamics from the lattice. More...

virtual void	thermodynamics_output (const ThermodynamicQuantity, const DensityType, RectangularLattice< EnergyMomentumTensor > &)
	Output to write energy-momentum tensor and related quantities from the lattice. More...

virtual void	thermodynamics_lattice_output (RectangularLattice< DensityOnLattice > &, const double)
	Output to write thermodynamics from the lattice. More...

virtual void	thermodynamics_lattice_output (RectangularLattice< DensityOnLattice > &, const double, const std::vector< Particles > &, const DensityParameters &)
	Output to write thermodynamics from the lattice. More...

virtual void	thermodynamics_lattice_output (const ThermodynamicQuantity, RectangularLattice< EnergyMomentumTensor > &, const double)
	Output to write energy-momentum tensor and related quantities from the lattice. More...

virtual void	thermodynamics_output (const GrandCanThermalizer &)
	Output to write energy-momentum tensor and related quantities from the thermalizer class. More...

virtual void	fields_output (const std::string, const std::string, RectangularLattice< std::pair< ThreeVector, ThreeVector >> &)
	Write fields in vtk output Fields are a pair of threevectors for example electric and magnetic field. More...

bool	is_dilepton_output () const
	Get, whether this is the dilepton output? More...

bool	is_photon_output () const
	Get, whether this is the photon output? More...

bool	is_IC_output () const
	Get, whether this is the IC output? More...

const char *	to_string (const ThermodynamicQuantity tq)
	Convert thermodynamic quantities to strings. More...

const char *	to_string (const DensityType dens_type)
	Convert density types to strings. More...

Private Attributes
bool	print_start_end_
	Write initial and final particles additonally to collisions? More...

Additional Inherited Members
Protected Member Functions inherited from smash::BinaryOutputBase
	BinaryOutputBase (const std::filesystem::path &path, const std::string &mode, const std::string &name, const std::vector< std::string > &quantities)
	Create binary output base. More...

void	write (const ToBinary::type &chunk)
	Write several bytes to the binary output. More...

void	write (const char c)
	Write byte to binary output. More...

void	write (const std::string &s)
	Write string to binary output. More...

void	write (const double x)
	Write double to binary output. More...

void	write (const FourVector &v)
	Write four-vector to binary output. More...

void	write (const std::int32_t x)
	Write integer (32 bit) to binary output. More...

void	write (const std::uint32_t x)
	Write unsigned integer (32 bit) to binary output. More...

void	write (const std::uint16_t x)
	Write unsigned integer (16 bit) to binary output. More...

void	write (const size_t x)
	Write a std::size_t to binary output. More...

void	write (const Particles &particles)
	Write particle data of each particle in particles to binary output. More...

void	write (const ParticleList &particles)
	Write each particle data entry to binary output. More...

void	write_particledata (const ParticleData &p)
	Write particle data to binary output. More...

Protected Attributes inherited from smash::BinaryOutputBase
RenamingFilePtr	file_
	Binary particles output file path. More...

Protected Attributes inherited from smash::OutputInterface
const bool	is_dilepton_output_
	Is this the dilepton output? More...

const bool	is_photon_output_
	Is this the photon output? More...

const bool	is_IC_output_
	Is this the IC output? More...

Constructor & Destructor Documentation

◆ BinaryOutputCollisions()

smash::BinaryOutputCollisions::BinaryOutputCollisions	(	const std::filesystem::path &	path,
		std::string	name,
		const OutputParameters &	out_par,
		const std::vector< std::string > &	quantities
	)

Create binary particle output.

Parameters

[in]	path	Output path.
[in]	name	Name of the output.
[in]	out_par	A structure containing parameters of the output.
[in]	quantities	The list of quantities printed to the output.

Definition at line 265 of file binaryoutput.cc.

     : BinaryOutputBase(path / get_binary_filename(name, quantities), "wb", name,
                        quantities),
       print_start_end_(out_par.coll_printstartend) {}

Member Function Documentation

◆ at_eventstart()

void smash::BinaryOutputCollisions::at_eventstart	(	const Particles &	particles,
		const EventLabel &	event_label,
		const EventInfo &	event
	)

overridevirtual

Writes the initial particle information list of an event to the binary output.

Parameters

[in]	particles	Current list of all particles.
[in]	event_label	Numbers of event and ensemble.
[in]	event	Event info, see event_info

Reimplemented from smash::OutputInterface.

Definition at line 272 of file binaryoutput.cc.

                                                               {
   const char pchar = 'p';
   if (print_start_end_) {
     std::fwrite(&pchar, sizeof(char), 1, file_.get());
     write(event_label.event_number);
     write(event_label.ensemble_number);
     write(particles.size());
     write(particles);
   }
 }

◆ at_eventend()

void smash::BinaryOutputCollisions::at_eventend	(	const Particles &	particles,
		const EventLabel &	event_label,
		const EventInfo &	event
	)

overridevirtual

Writes the final particle information list of an event to the binary output.

Parameters

[in]	particles	Current list of particles.
[in]	event_label	Numbers of event and ensemble.
[in]	event	Event info, see event_info

Reimplemented from smash::OutputInterface.

Definition at line 285 of file binaryoutput.cc.

                                                                  {
   const char pchar = 'p';
   if (print_start_end_) {
     std::fwrite(&pchar, sizeof(char), 1, file_.get());
     write(event_label.event_number);
     write(event_label.ensemble_number);
     write(particles.size());
     write(particles);
   }
  
   // Event end line
   const char fchar = 'f';
   std::fwrite(&fchar, sizeof(char), 1, file_.get());
   write(event_label.event_number);
   write(event_label.ensemble_number);
   write(event.impact_parameter);
   const char empty = event.empty_event;
   write(empty);
  
   // Flush to disk
   std::fflush(file_.get());
 }

◆ at_interaction()

void smash::BinaryOutputCollisions::at_interaction	(	const Action &	action,
		const double	density
	)

overridevirtual

Writes an interaction block, including information about the incoming and outgoing particles, to the binary output.

Parameters

[in]	action	Action that holds the information of the interaction.
[in]	density	Density at the interaction point.

Reimplemented from smash::OutputInterface.

Definition at line 310 of file binaryoutput.cc.

                                                                   {
   const char ichar = 'i';
   std::fwrite(&ichar, sizeof(char), 1, file_.get());
   write(action.incoming_particles().size());
   write(action.outgoing_particles().size());
   std::fwrite(&density, sizeof(double), 1, file_.get());
   const double weight = action.get_total_weight();
   std::fwrite(&weight, sizeof(double), 1, file_.get());
   const double partial_weight = action.get_partial_weight();
   std::fwrite(&partial_weight, sizeof(double), 1, file_.get());
   const auto type = static_cast<uint32_t>(action.get_type());
   std::fwrite(&type, sizeof(uint32_t), 1, file_.get());
   write(action.incoming_particles());
   write(action.outgoing_particles());
 }

Member Data Documentation

◆ print_start_end_

bool smash::BinaryOutputCollisions::print_start_end_

private

Write initial and final particles additonally to collisions?

Definition at line 194 of file binaryoutput.h.

The documentation for this class was generated from the following files:

src/include/smash/binaryoutput.h
src/binaryoutput.cc

Public Member Functions

Private Attributes

Additional Inherited Members

Constructor & Destructor Documentation

◆ BinaryOutputCollisions()

Member Function Documentation

◆ at_eventstart()

◆ at_eventend()

◆ at_interaction()

Member Data Documentation

◆ print_start_end_