MMTSB
Tool Set Documentation

Difference between revisions of "setprop.pl"

From MMTSB
Jump to: navigation, search
Line 10: Line 10:
 
the structure subset for which the property should be set and
 
the structure subset for which the property should be set and
 
a property tag to identify the property itself.<BR>
 
a property tag to identify the property itself.<BR>
 +
 
In order to set or change a single value the new value can be
 
In order to set or change a single value the new value can be
 
given as the last argument while the option <B>-at</B> may
 
given as the last argument while the option <B>-at</B> may
Line 18: Line 19:
 
contains multiple data fields per line, the first value of each
 
contains multiple data fields per line, the first value of each
 
line is used by default, a different field index can be specifeid
 
line is used by default, a different field index can be specifeid
with <B>-inx</B>.
+
with <B>-inx</B>.<BR>
<BR>
+
 
 
The location of the ensemble directory may be given with <B>-dir</B>
 
The location of the ensemble directory may be given with <B>-dir</B>
 
if it is not the current directory.<BR>
 
if it is not the current directory.<BR>
 +
 
<font color=#508060>setprop.pl</font> can also be used to remove a
 
<font color=#508060>setprop.pl</font> can also be used to remove a
 
property and all its values from a data file. The
 
property and all its values from a data file. The
Line 27: Line 29:
 
should be used with care since there is no way to restore data once
 
should be used with care since there is no way to restore data once
 
it has been removed.<BR>
 
it has been removed.<BR>
 +
 
== Options ==
 
== Options ==
  

Revision as of 14:26, 30 July 2009

Usage

usage:   setprop.pl [options] tag proptag [value]
options: [-dir datadir]
         [-remove]
         [-at index]
         [-f file]
         [-inx index]

Show source


Description

This script can be used to manually modify or add property values for a structure ensemble. Required parameters are a tag identifying the structure subset for which the property should be set and a property tag to identify the property itself.

In order to set or change a single value the new value can be given as the last argument while the option -at may be used to specify the structure index. Alternatively a whole series of data may be read from a file given with -f. The values from the file are then set consecutively starting at index 1 unless a different first index is given with -at. If the input file contains multiple data fields per line, the first value of each line is used by default, a different field index can be specifeid with -inx.

The location of the ensemble directory may be given with -dir if it is not the current directory.

setprop.pl can also be used to remove a property and all its values from a data file. The -remove option is available for this purpose. This option should be used with care since there is no way to restore data once it has been removed.

Options

-help 
usage information


Examples

setprop.pl -dir data -at 4 sample etot 20.14
modifies the value for etot in the sample structure with the index 4


setprop.pl -dir data -f etot.data -inx 2 sample etot
sets etot values from the second column in the file etot.data for structures associated with the sample tag