Accessing CNSsolve
Access to the correct version of CNSsolve for the current machine type is provided by:
For C-shell users (csh, tcsh):
% source CNSsolve-directory/cns_solve_env
this should be sourced from a .cshrc file, or prior to running the program.
For Bourne shell users (sh, bash):
% . CNSsolve-directory/.cns_solve_env_sh
this should be sourced from a .profile or .bashrc file, or prior to running the program.
The cns_solve_env or .cns_solve_env_sh script will automatically determine if an appropriate executable exists for the current machine type. If so the following environmental variables will be set:
The directories containing the cns_solve executable and utility programs will be added to the path.
Warning: in the event that CNSsolve is not installed on the current machine no error message will be given when the file cns_solve_env is sourced, but when the cns_solve command is executed the following will be reported:
Running the CNSsolve program
To run an interactive CNSsolve session, type:
To run an non-interactive CNSsolve session, type:
cns_solve
cns_solve < task-file > output-file
Accessing help information
To access the online HTML documentation and the HTML interface from
the UNIX command line, type: cns_web
To access the online help provided within the CNSsolve program during an
interactive session, type:
help
This online help is context dependent. Typing help at the
main CNSsolve prompt (CNSsolve>) will give information about the commands
available at this level. Typing help at the xray prompt
(XRAY>) will give information about the commands available at this
level. Information about commands that can be issued at all CNSsolve levels
can be obtained by typing:
help-global
Information about data types can be obtained by typing:
help-datatypes
CNSsolve task files
Task files are located in the directory:
$CNS_SOLVE/inputs
Taks files are best modified using the HTML based WWW interface. This
can be accessed through the online HTML documentation, see:
Main Menu -> Input files
The HTML task file editor can also be accessed from the Unix command line
by typing:
cns_edit task-file
Defaults for input parameters in a task file can be set through the
online HTML documentation, see:
Main Menu -> Input files -> Defaults
Defaults can be passed to the HTML task file editor from the Unix command line:
cns_edit -def defaults-file task-file
The online help can be enabled by typing:
cns_edit -help task-file
or
cns_edit -help -def defaults-file task-file
Defaults for input parameters in a task file can be transfered to
another task file from the Unix command line without invoking the HTML
interface:
cns_transfer -def defaults-file -inp task-file [-out output-file]
The input parameters in a task file can be extracted using the command:
cns_header task-file
The parameter definition section of the task file is printed to
stdout and can be redirected to a file or to a printer for a hardcopy
record of the task file parameters.