SSJ
V. labo.

umontreal.iro.lecuyer.hups
Class DigitalNetFromFile

java.lang.Object
  extended by umontreal.iro.lecuyer.hups.PointSet
      extended by umontreal.iro.lecuyer.hups.DigitalNet
          extended by umontreal.iro.lecuyer.hups.DigitalNetFromFile

public class DigitalNetFromFile
extends DigitalNet

DigitalNetFromFile

This class allows us to read the parameters defining a digital net either from a file, or from a URL address on the World Wide Web. The parameters used in building the net are those defined in class umontreal.iro.lecuyer.hupsDigitalNet. The format of the data files must be the following: (see the format in guidehups.pdf)

\begin{figure}\begin{center}
 \tt
 \fbox{
 \begin {tabular}{llll}
 \multicolumn{4}{...
 ... $c_{2k}$\ & $\cdots$\ & $c_{rk}$\ \\
 \end {tabular}
 }
 \end{center}\end{figure}

The figure above gives the general format of the data file needed by DigitalNetFromFile. The values of the parameters on the left must appear in the file as integers. On the right of each parameter, there is an optional comment that is disregarded by the reader program. In general, the Java line comments // are accepted anywhere and will ensure that the rest of the line is dropped by the reader. Blank lines are also disregarded by the reader program. For each dimension, there must be a k×r matrix of integers in {0, 1,…, b - 1} (note that the matrices must appear in transposed form).

The predefined files of parameters are kept in different directories, depending on the criteria used in the searches for the parameters defining the digital net. These files have all been stored at the address http://simul.iro.umontreal.ca/ssj/data. Each file contains the parameters for a specific digital net. The name of the files gives information about the main parameters of the digital net. For example, the file named Edel/OOA2/B3S13R9C9St6 contains the parameters for a digital net proposed by Yves Edel (see http://www.mathi.uni-heidelberg.de/~yves/index.html) based on ordered orthogonal arrays; the digital net has base B = 3, dimension S = 13, the generating matrices have R = 9 rows and C = 9 columns, and the strength of the net is St = 6.


Constructor Summary
DigitalNetFromFile(String filename, int s)
          .
DigitalNetFromFile(String filename, int r1, int w, int s1)
          .
 
Method Summary
static String listDir(String dirname)
          .
static void listDirHTML(String dirname, String filename)
          .
 String toString()
          .
 String toStringDetailed()
          .
 
Methods inherited from class umontreal.iro.lecuyer.hups.DigitalNet
addRandomShift, addRandomShift, clearRandomShift, eraseOriginalGeneratorMatrices, getCoordinate, getCoordinateNoGray, iBinomialMatrixScramble, iBinomialMatrixScrambleFaurePermut, iBinomialMatrixScrambleFaurePermutAll, iBinomialMatrixScrambleFaurePermutDiag, iterator, iteratorNoGray, leftMatrixScramble, leftMatrixScrambleDiag, leftMatrixScrambleFaurePermut, leftMatrixScrambleFaurePermutAll, leftMatrixScrambleFaurePermutDiag, printGeneratorMatrices, resetGeneratorMatrices, rightMatrixScramble, stripedMatrixScramble, stripedMatrixScrambleFaurePermutAll, unrandomize
 
Methods inherited from class umontreal.iro.lecuyer.hups.PointSet
addRandomShift, addRandomShift, formatPoints, formatPoints, formatPoints, formatPoints, formatPointsBase, formatPointsBase, formatPointsBase, formatPointsBase, formatPointsNumbered, formatPointsNumbered, getDimension, getNumPoints, getStream, randomize, randomize, randomize, randomize, randomize, setStream
 
Methods inherited from class java.lang.Object
equals, getClass, hashCode, notify, notifyAll, wait, wait, wait
 

Constructor Detail

DigitalNetFromFile

public DigitalNetFromFile(String filename,
                          int r1,
                          int w,
                          int s1)
                   throws MalformedURLException,
                          IOException
. \begin{tabb}
 Constructs a digital net after reading its parameters from file
 {...
 ...number of rows in the data file.
 Also \texttt{w} $\ge$\ \texttt{r1}.
 \end{tabb}
filenameName of the file to be read r1Number of rows for the generating matrices wNumber of digits of resolution s1Number of dimensions

Throws:
MalformedURLException
IOException

DigitalNetFromFile

public DigitalNetFromFile(String filename,
                          int s)
                   throws MalformedURLException,
                          IOException
. \begin{tabb}
 Same as \method{DigitalNetFromFile}{}\texttt{(filename, r, r, s)} ...
 ...the dimension and \texttt{r} is given in data file \texttt{filename}.
 \end{tabb}
filenameName of the file to be read sNumber of dimensions

Throws:
MalformedURLException
IOException
Method Detail

toString

public String toString()
Description copied from class: PointSet
. \begin{tabb}
 Formats a string that contains information about the point set.
 \end{tabb}
string representation of the point set information

Overrides:
toString in class DigitalNet

toStringDetailed

public String toStringDetailed()
. \begin{tabb}
 Writes the parameters and the generating matrices of this digital ...
 ...s useful to check that the file parameters have been
 read correctly.
 \end{tabb}


listDir

public static String listDir(String dirname)
                      throws IOException
. \begin{tabb}
 Lists all files (or directories) in directory \texttt{dirname}. On...
 ...)}
 will give the list of all files in directory \texttt{Edel/OOA2}.
 \end{tabb}

Throws:
IOException

listDirHTML

public static void listDirHTML(String dirname,
                               String filename)
                        throws IOException
. \begin{tabb}
 Creates a list of all data files in directory \texttt{dirname} and...
 ... of rows and
 the number of columns of the corresponding digital net.
 \end{tabb}

Throws:
IOException

SSJ
V. labo.

To submit a bug or ask questions, send an e-mail to Pierre L'Ecuyer.