Getting Started
Installation of the Molconn-Z software package on a PC,or unix machine consists of (1) setting up the appropriate (sub)directory for Molconn-Z and (2) copying the files into that (sub)directory.
Before the software is loaded into your system, setup the (sub)directory which will house the software materials, the executable module, and example input/output files. See the table below.
MKDIR C:\MOLCONNZ\
NOTE: It is essential that the Molconn-Z software be placed in a subdirectory with this name.
Enter that (sub)directory and prepare to load the Molconn-Z files from the source disk or tape.
CD C:\MOLCONNZ\
Use the proper command(s) to copy all files into designated (sub)directory. Do a directory command to determine that all the files have been loaded.
See the directory listing for a copy of the contents of the software file directory.
COPY A:*.* C:
Examine the directory of C:\MOLCONNZ to determine whether the copy command has been executed successfully.
To determine that your software is properly executing, execute one or more test runs of Molconn-Z.
MOLCONNZ
You may run Molconn-Z with any one of several of the example input file(s). Use of SMILES.B, MDL.B or SAMPLE.B is recommended. If an error is encountered, check Chapter 5 for the proper Menu option for the the .B files. See Chapter 4 for specific information on executing Molconn-Z.
Several example input files are supplied, as follows:
The preliminary test of Molconn-Z may be done using some of the above example files, such as SMILES.B , MDL.B or SAMPLE.B, or as many others as the user may wish to test. To execute Molconn-Z for each of these files, it is necessary to exercise the MENU option in which file format is specified. See MENU listings given below and further information in Chapter 5.
In the software supplied with Molconn-Z, example output listing files are also included for each of the .B file and are labeled with the same file name and the extension L. Compare your output to the example output files to determine program performance. In the example files delivered in the Molconn-Z package, all the output options have been selected for the .L file and all the records have been selected for the .S file.
If the user is not interested in some of the file formats, the corresponding .B, .L and .S files should be deleted at this time. There are many other program options which the user may exercise; these are described in Chapter 5. The user should consider printing out the .B, .L and .S files at this time for future reference.
Consideration should be given to the manner of use of the OPTION.DAT file when several users may access the same file.
The UNIX distribution of Molconn-Z is on a tape tar set. Please create a directory, mkdir eduSoft under /usr or another convenient location which will be the root directory for this product and unload the tape (tar xov) here.
Install the Molconn-Z License Keys(s) as described on the included (hardcopy) documentation or on-line.
Edit the appropriate file in /usr/eduSoft/eslc/lib (see table below) to correct the entry for the actual location of $EDUSOFT_ROOT.
Product(s) | Platform | cshrc | profile |
---|---|---|---|
Molconn-Z 3.50 | r4000 | cshrc_molconnz_r4 | profile_molconnz_r4 |
r5000 | cshrc_molconnz | profile_molconnz | |
r8000, r10000, r12000 | cshrc_molconnz_r8 | profile_molconnz_r8 | |
HintLogP 2.30 & Molconn-Z 3.50 | r4000 | cshrc_hintlogp+molconnz_r4 | profile_hintlogp+molconnz_r4 |
r5000 | cshrc_hintlogp+molconnz | profile_hintlogp+molconnz | |
r8000, r10000, r12000 | cshrc_hintlogp+molconnz_r8 | profile_hintlogp+molconnz_r8 |
Each user must:
(Note that the unix filenames are all lowercase.)
The following is a listing of the directory of the contents which the Molconn-Z software contains (shown here for a PC). It is useful to create and printout the directory listing for the account in which Molconn-Z is installed. Comparison can then be made with this listing for completeness of the software package.
Unix File Name | DOS File Name | File Description |
---|---|---|
bin/installMolconnZUser | n/a | shell file to create user's options files |
bin/make_demo.csh | n/a | shell file to create a user demo directory |
bin/molconnz | MOLCONNZ.EXE | MOLCONNZ executable file |
demo/4clbiphe.tbl | 4CLBIPHE.TBL | Molecule file for CDRAW.B |
demo/acetica.css | ACETICAC.CSS | Molecule file for CHX.B |
demo/cdraw.b | CDRAW.B | .B file, CHEMDRAW file format |
demo/cdraw.e | CDRAW.E | .E file with CDRAW.B as input |
demo/cdraw.l | CDRAW.L | .L file with CDRAW.B as input |
demo/cdraw.s | CDRAW.S | .S file with CDRAW.B as input |
demo/clphenol.mol | CLPHENOL.MOL | molecule file for MDL.B |
demo/chx.b | CHX.B | .B file, ChemDesign file format |
demo/chx.e | CHX.E | .E file with CHX.B as input |
demo/chx.l | CHX.L | .L file with CHX.B as input |
demo/chx.s | CHX.S | .S file with CHX.B as input |
demo/clbenzca.css | CLBENZCA.CSS | Molecule file for CHX.B |
demo/cnphenol.mol | CNPHENOL.MOL | molecule file for MDL.B |
demo/ethanol.css | ETHANOL.CSS | Molecule file for CHX.B |
demo/mdl.b | MDL.B | .B file, MDL MOL file format |
demo/mdl.e | MDL.E | .E file with MDL.B as input |
demo/mdl.l | MDL.L | .L file with MDL.B as input |
demo/mdl.s | MDL.S | .S file with MDL.B as input |
demo/nnphenol.mol | NNPHENOL.MOL | molecule file for MDL.B |
demo/phenol.mol | PHENOL.MOL | molecule file for MDL.B |
demo/prop_acd.tbl | PROP_ACD.TBL | molecule file for CDRAW.B |
demo/pyridin0.tbl | PYRIDIN0.TBL | molecule file for CDRAW.B |
demo/pyridine.tbl | PYRIDINE.TBL | molecule file for CDRAW.B |
demo/sample.b | SAMPLE.B | .B file, MOLCONNX file format |
demo/sample.e | SAMPLE.E | .E file with SAMPLE.B as input |
demo/sample.l | SAMPLE.L | .L file with SAMPLE.B as input |
demo/sample.s | SAMPLE.S | .S file with SAMPLE.B as input |
demo/sdf.b | SDF.B | .B file for SDFile input format |
demo/sdf.l | SDF.L | .L file with SDF.B as input |
demo/smiles.b | SMILES.B | .B file, SMILES code format |
demo/smallmol.smi | n/a | sample SMILES file in Daylight format |
demo/smiles.b | SMILES.B | .B file, SMILES code format |
demo/smiles.e | SMILES.E | .E file with SMILES.B as input |
demo/smiles.l | SMILES.L | .L file with SMILES.B as input |
demo/smiles.s | SMILES.S | .S file with SMILES.B as input |
demo/smiles.sub | SMILES.SUB | .SUB file with SMILES.B as input |
demo/snphenol.mol | SNPHENOL.MOL | molecule file for MDL.B |
installuser/mconn_option.std | OPTION.DAT | file of program MENU option variables |
installuser/mconn_option.org | OPTION.ORG | backup copy of OPTION.DAT |
lib/cshrc | n/a | molconnz resource file for csh |
lib/profile | n/a | molconnz resource file for sh |
tables/sasinpae.txt | SASINPAE.TXT | file with .E file format for SAS input, for all bond types |
tables/sasinpoe.txt | SASINPOE.TXT | file with .E file format for SAS input, for only organic bond types |
tables/sasinpz.txt | SASINPZ.TXT | file with .S file format for SAS input |
tables/spl_atom_definitions.dat | n/a | equivalence files for Sybyl atom types |
n/a | PARAM.DAT | Compiler and array size options |
For use in the test run of Molconn-Z, samples of the program option Menus are given below, including the default value for each option. For specific information on each Menu, see Chapter 5.
MOLCONNZ PROGRAM OPTIONS Enter Number for the Desired Option Change1- Input File (Molconn/SMILES code/ Molfile/SDFile/CHEM-X) (BFILE) <C> 2- Topological State Algorithm (1 to 6) (IFUNCT) <4> 3- Number of E-State Values in S File (NSTATE) <90> 4- Output to Bond Type File (A, O, I, N) (ETOUT) <O> 5- Full Job or Only Output to Verify Input (FULL) <Y> 6- Maximum Order of Chi Calculated (MAXORD) <100> Output File Selections 7- Output .S Index File (ITEXT) <Y> 8- Output .L Listing File (Screen Output) (FAST) <N> 9- Output .E Bond Type E-state File (EDGECALC)<Y> 10- Output Distance/Connectivity Matrices (AFILE) <N> 11- Select FIRST SubMENU on Program Control 12- Select SECOND SubMENU on Listing File Contents 13- Quit Menu .............Proceed with Calculations <Return> Please Enter Desired Option (1 to 14 or RETURN):
1- Topological Symmetry Perception (KSYM) <Y> 2- Field Delimiter (DLM) <,> 3- Maximum Order of Chi Output to File (MOFILE) <10> 4- Sign of Fluorine Contribution (IFSIGN) <+> 5- Molecular Connectivity Algorithm (Standard/Topological State Algorithm) (CTYPE) <R> 6- Topological State Algorithm Type (STYPE) <G> 7- Print Seclected Subgraphs (ITERM,SORDER) <N 4> 8- Records output to .S file (NRECS) <48> 9- Marker at end of each .S file line (MARK) < > 10- Quit SubMENU . . Return to Main Menu 11- Quit SubMenu . . Proceed with Calculations <Return> Please Enter Desired Option (1 to 11 or RETURN):
This SubMENU contains options for selecting output to be included in the output listing file (.L) A table of atom identification is always included YOU MAY SELECT EACH OUTPUT BLOCK TO BE PRINTED <Y> OR NOT TO BE PRINTED <N> 1- Atom Symmetry Classification (OUT1) <Y> 2- Table of subgraph counts (OUT2) <Y> 3- Table of Connectivity and kappa indexes (OUT3) <Y> 4- Total Topological Index and Wiener Indexes (OUT4) <Y> 5- Information Indexes and ad hoc parameters (OUT5) <Y> Please, enter the number of an output block whose print status you wish to change. >>> Just push RETURN to go back to the MAIN MENU < Enter the number (or RETURN) :
In the unix, "multiuser-environment" each user has his own copy of mconn_option.std which resides in a resource directory .molconnz, but it is still important for this file to be protected against corruption.