1Blurb::
2Read initial solutions from file
3Description::
4\c flat_file allows the initial population to be read from a flat
5file. If \c flat_file is specified, a file name must be given.
6
7%Variables can be delimited in the flat file in any way you see fit
8with a few exceptions. The delimiter must be the same on any given
9line of input with the exception of leading and trailing whitespace.
10So a line could look like: 1.1, 2.2 ,3.3 for example but could not
11look like: 1.1, 2.2 3.3. The delimiter can vary from line to line
12within the file which can be useful if data from multiple sources is
13pasted into the same input file.  The delimiter can be any string that
14does not contain any of the characters .+-dDeE or any of the digits
150-9. The input will be read until the end of the file. The algorithm
16will discard any configurations for which it was unable to retrieve at
17least the number of design variables. The objective and constraint
18entries are not required but if ALL are present, they will be recorded
19and the design will be tagged as evaluated so that evaluators may
20choose not to re-evaluate them.
21
22Setting the size for this initializer has the effect of requiring a
23minimum number of designs to create. If this minimum number has not
24been created once the files are all read, the rest are created using
25the \c unique_random initializer and then the \c simple_random
26initializer if necessary.  If more designs are found in the
27initialization files than specified by the initial size, then the
28initial size is ignored and all designs read out of the files are kept
29in the initial population.
30
31
32Topics::
33Examples::
34Theory::
35Faq::
36See_Also::
37