The application cnetsplit splits the input control network into user
specified number of control networks.
Overview
Parameters
Example 1
Description
The application cnetsplit splits the input control network into a user
specified number of control networks with the user specified output name.
A possible use of this application would be to allow extremely large
control networks to be split, then further processing could be divided
among multiple computers. The application, "cnetmerge" can then be used
to merge the individual control networks back into a single large
network. The application log will display statistics for the input
ControlNet.
The input control network keyword values for Description, NetworkId, and
Target Keywords will be copied to each output control network. The
DateTime and UserName keywords will be created new for the output control
networks. The output control networks are filled from smallest to
largest output file name from the first points in the input control
network to the last.
We can denote the number of control points in the input file by
n and the number of output files to be created is by
k. Then, denote the remainder of n/k by
R . If R is not zero, then, the first
R files will have one more point than the last
k-R files.
Otherwise, if R = 0, i.e. if the number of output files
evenly divides the number of points in the input control network, then
each of the output files will have the same number of points.
Errors thrown by cnetsplit will include the following:
No question marks in the ONET_PREFIX string.
More than one set of question marks in the ONET_PREFIX string.
Not enough question marks for the specified number of output
files.
Number of output files exceeds the number of control points in the
intput control network.
This string will be used to create unique output file names. It
should contain a set of question marks ("?") where the file number
will be placed. The string should not have question marks
anywhere else. For each output file, the question marks will be
replaced with a number from one to the number of output files.
For example, if the user sets the pattern to
ONET_PREFIX="ControlNet????" and NUM_OUTPUT_FILES=999,
then cnetsplit will create 999 files with file names
"ControlNet0001.net" through "ControlNet0999.net".
Note: If there are not enough "?"s for the number of output files to
be created during this run, the user will be thrown an error .
Split a control network with 8 points into 3 control networks.
Description
This example will show how a control network is split when the number
of output networks does not evenly divide the number points in the
input control network.
This is the first of the output control networks created by
cnetsplit. It contains the 1st, 2nd, and 3rd control points from
the input control network.
This is the first of the output control networks created by
cnetsplit. It contains the 4th, 5th, and 6th control points from
the input control network.
