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:


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.