ASCIIReader Class Reference

The ASCIIReader reads in phasespace information using ls1-MarDyn's (old) ASCII input file format. More...

#include <ASCIIReader.h>

Inheritance diagram for ASCIIReader:

Public Member Functions
void	readXML (XMLfileUnits &xmlconfig)
void	setPhaseSpaceFile (std::string filename)
	Set the phase space file to be read. More...
void	setPhaseSpaceHeaderFile (std::string filename)
	For this class, header and data are in the same file, so there is no separate header file.
void	readPhaseSpaceHeader (Domain *domain, double timestep)
	reads in header of the input file (including component description) More...
unsigned long	readPhaseSpace (ParticleContainer *particleContainer, Domain *domain, DomainDecompBase *domainDecomp)
	reads in the data of all molecules More...

Detailed Description

The ASCIIReader reads in phasespace information using ls1-MarDyn's (old) ASCII input file format.

Member Function Documentation

readPhaseSpace()

unsigned long ASCIIReader::readPhaseSpace ( ParticleContainer *  particleContainer, Domain *  domain, DomainDecompBase *  domainDecomp  )

virtual

reads in the data of all molecules

The Molecule Data starts in a new line with the string "MoleculeFormat" followed by whitespace and a string representing the format. In the standard case (format ICRVQD), the following values are provided for each molecule:

• id of the molecule (int)
• id of the component of the molecule (int)
• Coordinates: x, y, z (all double)
• velocities: vx, vy, vz (all double)
• Orientation (quaternion): q0, q1, q2, q3 (all double)
• Angular Momentum: Dx, Dy, Dz (all double)

Parameters

particleContainer

Here the Molecules from the input file are stored

Returns

Number of molecules read in from the input phase space file

Implements InputBase.

readPhaseSpaceHeader()

void ASCIIReader::readPhaseSpaceHeader ( Domain *  domain, double  timestep  )

virtual

reads in header of the input file (including component description)

The Header in the input file consists of several elements. An element starts in a new line with the element name followed by some whitespace (e.g. "Temperature "). After that, there can be any number of tokens belonging to that element. A description of the different elements follows below. But first some rules dealing with the order of the elements:

• The first header element must start with the string "MDProject" followed by a timestamp.
• The last header element must start with the string NumberOfMolecules. After that, the header is over and the molecule data follows
• The order of the remaining header lines is not important.
• Header elements beginning with "#" are ignored.

Now the description of the different elements:

• MDProject: One token follows with a version number (see description of _inpversion);
• currenttime: One token follows with the start time
• Temperature: One token follows with the temperature
• Length: Three tokens follow with the length of the simulation box in the three dimensions (x, y and z)
• NumberOfComponents: Here follow several tokens, the first one is the actual Number of Components. Then the values describing the components have to follow, seperated by whitespace. For each component, the following values have to be provided:
  • Number of Lennard-Jones-Centers, Number of Dipoles, Number of Quadrupoles (all int)
  • For each LJ-Center: x-coord., y-coord., z-coord., mass, epsilon, sigma, tcutoff, do_shift (all double)
  • For each Dipole: x-coord., y-coord., z-coord., eMyx, eMyy, eMyz, absMy (all double)
  • For each Quadrupole: x-coord., y-coord., z-coord., eQx, eQy, eQz, absQ (all double)
  • moments of inertia for principal axes: I11, I22, I33 (all double)
  • For each pair of different components: xi, eta (both double)
  • epsilonRF (double)
• NumberOfMolecules: One token follows with the number of molecules

Implements InputBase.

readXML()

void ASCIIReader::readXML ( XMLfileUnits &  xmlconfig )

virtual

Reimplemented from InputBase.

setPhaseSpaceFile()

void ASCIIReader::setPhaseSpaceFile

(

std::string

filename

)

Set the phase space file to be read.

Parameters

filename

full path to the phase space file

---

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

• src/io/ASCIIReader.h
• src/io/ASCIIReader.cpp