MercuryDataFile Class Reference

#include <MercuryData.h>

Classes
class	IteratorProxy

Public Member Functions
	MercuryDataFile (std::string name)
	operator bool () const
	Gives the status of the backing std::ifstream Returns true is no error has occurred. In any other case (EOF, FailBit, ErrorBit), it returns false. For more information, see std::ifstream::operator bool(). More...
template<std::size_t NDIMS>
bool	isMercuryDataFile ()
	Checks if this file is a valid Mercury 3D data file. This function jumps to the start of the file, reads the first line and restores the readpointer. It then checks if that line can be succesfully parsed as a time step header. This does however not check if the file is consistent or the particle entries are valid. It can however serve as a first sanity check. More...
template<std::size_t NDIMS>
IteratorProxy< NDIMS >	as ()
template<std::size_t NDIMS>
MercuryTimeStepIterator< NDIMS >	begin ()
	Returns a forwarditerator to the timesteps Returns a forwarditerator to the timesteps, invalidating any other valid iterators in the process (since this is a lazy loader and does not actually load the entire file in memory). End iterators do not get invalidated. This function makes no guarantee for the validity of the file-state. More...
template<std::size_t NDIMS>
MercuryTimeStepIterator< NDIMS >	end () const
	Returns a forwarditerator one past the last timestep. More...

Private Attributes
std::ifstream	file_

Friends
template<std::size_t NDIMS>
class	MercuryTimeStep
template<std::size_t NDIMS>
class	MercuryTimeStepIterator

Detailed Description

Lazy loader for .data files. This class allows you to iterate over all the particles in it.

Author

dducks

Definition at line 434 of file MercuryData.h.

Constructor & Destructor Documentation

MercuryDataFile::MercuryDataFile ( std::string  name )

inline

Opens the Mercury 3D .data file with filename file.

Parameters

[in]

name

The filename

Definition at line 442 of file MercuryData.h.

      : file_(name)
    { }

Member Function Documentation

template<std::size_t NDIMS>

IteratorProxy<NDIMS> MercuryDataFile::as ( )

inline

Definition at line 525 of file MercuryData.h.

Referenced by transformMercuryToVTK().

    { 
      return {this};
    };

template<std::size_t NDIMS>

MercuryTimeStepIterator<NDIMS> MercuryDataFile::begin ( )

inline

Returns a forwarditerator to the timesteps Returns a forwarditerator to the timesteps, invalidating any other valid iterators in the process (since this is a lazy loader and does not actually load the entire file in memory). End iterators do not get invalidated. This function makes no guarantee for the validity of the file-state.

Definition at line 540 of file MercuryData.h.

References file_.

Referenced by MercuryDataFile::IteratorProxy< NDIMS >::begin().

    {
      file_.seekg(0);
      return {this};
    }

template<std::size_t NDIMS>

MercuryTimeStepIterator<NDIMS> MercuryDataFile::end ( ) const

inline

Returns a forwarditerator one past the last timestep.

Definition at line 550 of file MercuryData.h.

Referenced by MercuryDataFile::IteratorProxy< NDIMS >::end().

    {
      return {};
    }

template<std::size_t NDIMS>

bool MercuryDataFile::isMercuryDataFile ( )

inline

Checks if this file is a valid Mercury 3D data file. This function jumps to the start of the file, reads the first line and restores the readpointer. It then checks if that line can be succesfully parsed as a time step header. This does however not check if the file is consistent or the particle entries are valid. It can however serve as a first sanity check.

Returns

true if the file appears to be a valid Mercury 3D .data file.

See also

MercuryDataFile::isMercury2DDataFile()

Definition at line 470 of file MercuryData.h.

References file_.

Referenced by main().

    {
      //Store the position, so we can jump back at the end of the function..
      std::ios::pos_type currentPosition = file_.tellg();
      //and jump to the start
      file_.seekg(0);
      //get the first line
      std::string line;
      std::getline(file_, line);
      file_.seekg(currentPosition); //and pretend nothing has happened
      
      std::istringstream lineStream(line);
      
      //We'll try to find out if there were exactly enough arguments.
      MercuryTimeStep<NDIMS> step;
      lineStream >> step;
      
      //Did we reach the end yet?
      bool isValid = lineStream.good();
      double dummy;
      lineStream >> dummy;
      
      //now we should have reached it.
      isValid = isValid && !lineStream.good();
      return isValid;
    }

MercuryDataFile::operator bool ( ) const

inline

Gives the status of the backing std::ifstream Returns true is no error has occurred. In any other case (EOF, FailBit, ErrorBit), it returns false. For more information, see std::ifstream::operator bool().

Returns

true if the underlying file is readable, false otherwise.

Definition at line 453 of file MercuryData.h.

References file_.

    {
      return file_.good();
    }

Friends And Related Function Documentation

template<std::size_t NDIMS>

friend class MercuryTimeStep

friend

Definition at line 561 of file MercuryData.h.

template<std::size_t NDIMS>

friend class MercuryTimeStepIterator

friend

Definition at line 563 of file MercuryData.h.

Member Data Documentation

std::ifstream MercuryDataFile::file_

private

The backing file stream used to represent the data file.

Definition at line 558 of file MercuryData.h.

Referenced by begin(), isMercuryDataFile(), operator bool(), and MercuryTimeStepIterator< NDIMS >::operator++().

---

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

• /usr/local/www/mercury/repo/Alpha/Tools/MercuryData.h