indii/fmri/data/TextFileSeedReader.hpp

#ifndef INDII_FMRI_DATA_TEXTFILESEEDREADER_HPP
#define INDII_FMRI_DATA_TEXTFILESEEDREADER_HPP

#include "SeedReader.hpp"

#include "indii/ml/aux/vector.hpp"
#include "indii/ml/aux/matrix.hpp"

#include <sstream>

namespace indii {
  namespace fmri {
    namespace data {

/**
 * Reader for white-space delimited seed %data files. The ordered rows
 * of the file represent time steps, while each column represents a
 * particular seed.
 *
 * @author Lawrence Murray <lawrence@indii.org>
 * @version $Rev: 307 $
 * @date $Date: 2007-09-27 21:21:20 +0100 (Thu, 27 Sep 2007) $
 */
class TextFileSeedReader : public SeedReader {
public:
  /**
   * Construct new seed reader from input stream, where all seeds are
   * of interest.
   *
   * @param in Stream from which to read.
   */
  TextFileSeedReader(std::istream* in);

  /**
   * Construct new seed reader from file, where all seeds are of
   * interest.
   *
   * @param file Name of file from which to read.
   */
  TextFileSeedReader(const std::string file);

  /**
   * Construct new seed reader from input stream, where only a single
   * seed is of interest.
   *
   * @param in Stream from which to read.
   * @param seed Index of seed of interest.
   */
  TextFileSeedReader(std::istream* in, unsigned int seed);

  /**
   * Construct new seed reader from file, where only a single seed is
   * of interest.
   *
   * @param file Name of file from which to read.
   * @param seed Index of seed of interest.
   */
  TextFileSeedReader(const std::string file, unsigned int seed);

  /**
   * Construct new seed reader from input stream, where only a subset
   * of seeds are of interest.
   *
   * @param in Stream from which to read.
   * @param seeds Set of indices giving seeds of interest.
   */
  TextFileSeedReader(std::istream* in, const std::vector<unsigned int> seeds);

  /**
   * Construct new seed reader from file, where only a subset of seeds
   * are of interest.
   *
   * @param file Name of file from which to read.
   * @param seeds Set of indices giving seeds of interest.
   */
  TextFileSeedReader(const std::string file,
      const std::vector<unsigned int> seeds);

  /**
   * Destructor.
   */
  ~TextFileSeedReader();

  virtual unsigned int read(double* into);

  virtual unsigned int read(indii::ml::aux::vector* into);

  virtual unsigned int read(indii::ml::aux::matrix* into);

  virtual unsigned int read(indii::ml::aux::symmetric_matrix* into);

private:
  /**
   * Values on the current line.
   */
  std::vector<double> values;

  /**
   * Current index in the seeds of interest vector.
   */
  unsigned int nextIndex;

  /** 
   * Move to next line in the stream.
   */
  void nextLine();

};

    }
  }
}

#endif

---