be.ac.ulg.montefiore.run.jahmm.io
Class ObservationSequencesReader

java.lang.Object
  be.ac.ulg.montefiore.run.jahmm.io.ObservationSequencesReader

public class ObservationSequencesReader
extends java.lang.Object

This class can read observations sequences from file.

The file format has been chosen to be very simple:

• a line per observation sequence, in pure 7 bits ASCII;
• empty (white) lines, space and tab characters are not significant;
• each observation is followed by a semi-colon (i.e. the line ends with a semi-colon);
• The '#' character introduce a comment; the rest of the line is skipped;
• A newline can be escaped using the '\' character; this character can't be used in any other context;
• the format of each observation is defined by the corresponding IO class.

Those rules must be followed by ObservationReader subclasses.

Constructor Summary

ObservationSequencesReader()

Method Summary

static <O extends Observation> java.util.List<O>	readSequence(ObservationReader<O> oir, java.io.Reader reader) Reads an observation sequence out of a file Reader.
static <O extends Observation> java.util.List<java.util.List<O>>	readSequences(ObservationReader<O> or, java.io.Reader reader) Reads observation sequences file.

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructor Detail

ObservationSequencesReader

public ObservationSequencesReader()

Method Detail

readSequences

public static <O extends Observation> java.util.List<java.util.List<O>> readSequences(ObservationReader<O> or,
                                                                                      java.io.Reader reader)
                                                                           throws java.io.IOException,
                                                                                  FileFormatException

Reads observation sequences file. Such a file holds a set of observation sequences.

Parameters:

or - An observation reader.

reader - Holds the character stream reader the sequences are read from.

Returns:

A Vector of Vectors of Observations.

Throws:

java.io.IOException

FileFormatException

readSequence

public static <O extends Observation> java.util.List<O> readSequence(ObservationReader<O> oir,
                                                                     java.io.Reader reader)
                                                          throws java.io.IOException,
                                                                 FileFormatException

Reads an observation sequence out of a file Reader.

Parameters:

oir - An observation reader.

reader - Holds the character reader the sequences are read from.

Returns:

An observation sequence read from st or null if the end of the file is reached before any sequence is found.

Throws:

java.io.IOException

FileFormatException