Jul 1 2004
Contents
 
Introduction
Reference Guide
 ICM command line options
 Command line editing
 Graphics controls
 Editing pairwise sequence-structure alignments
 Constants
 Subsets and index expressions
 Molecule intro
 Selections
 Arithmetics
 Flow control
 ICM molecular objects
 Energy and Penalty Terms
 Integer shell parameters.
 Real shell variables
 Logical variables
 String variables
  s_blastdbDir
  s_editor
  s_entryDelimiter
  s_errorFormat
  s_fieldDelimiter
  s_helpEngine
  s_icmhome
  s_inxDir
  s_icmPrompt
  s_imageViewer
  s_javaCodeBase
  s_labelHeader
  s_lib
  s_logDir
  s_out
  s_pdbDir
  s_projectDir
  s_printCommand
  s_prositeDat
  s_psViewer
  s_reslib
  s_skipMessages : ignore specific error messages
  s_tempDir
  s_translateString
  s_userDir
  s_usrlib (obsolete)
  s_webEntrezLink
  s_webViewer
  s_xpdbDir
 Preferences
 Tables (structures)
 Other shell variables
 Commands
 Functions
 Macros
 Files
User's guide
References
Glossary
 
Index
Prev
2.16 String variables
Next

[ s_blastdbDir | s_editor | s_entryDelimiter | s_errorFormat | s_fieldDelimiter | s_helpEngine | s_icmhome | s_inxDir | s_icmPrompt | s_imageViewer | s_javaCodeBase | s_labelHeader | s_lib | s_logDir | s_out | s_pdbDir | s_projectDir | s_printCommand | s_prositeDat | s_psViewer | s_reslib | s_skipMessages | s_tempDir | s_translateString | s_userDir | s_usrlib | s_webEntrezLink | s_webViewer | s_xpdbDir ]

2.16.1 s_blastdbDir

[Top]
return directory with Blast-formatted sequence files for ICM sequence searches. By default the directory is set to the $BLASTDB system shell variable. The variable can also be explicitly defined in the user_profile.icm or _startup file. In order to start using the $BLASTDB shell variable, delete explicit assignment of the s_blastdbDir from your _startup file or add
 
s_blastdbDir=Getenv("BLASTDB") 
to your ~/.icm/user_startup.icm file.
The find database family of sequence/pattern search commands use the s_blastdbDir directory.

2.16.2 s_editor

[Top]
a string to invoke an external editor.
Attention!!! Always use the call to the program which starts the program in the foreground. For example: use "jot -f" rather than just "jot", since the default is running in the background.
Examples:
 
 s_editor = "vi"      # good old vi, does not require a separate window 
 s_editor = "jot -f"  # popular SGI editor 
 s_editor = "xedit"   # simple and exists for X on every platform 
 s_editor = "notepad" # exists for PCs 


2.16.3 s_entryDelimiter

[Top]
a string which delimits entries in the database output of a table or a set of arrays, generated by the show database or write database commands. The %i specification at the end will be replaced by the current number of the entry and carriage return.
Default: ("#____________________________ %i")
Example:
 
 s_entryDelimiter="//\n"  # EMBL-database delimiter  


2.16.4 s_errorFormat

[Top]
defines the exact appearance of the ICM error messages. Specification %s corresponds to the minimal ICM error message. If %s is missing all error messages are reduced to the specified text. If s_errorFormat is equal to the empty string (""), all error messages will be suppressed. If icm is started in the "web" mode (i.e. with the -w path flag), the variable is automatically set to "<hr><h3>Error: %s</h3><hr>" .
Examples:
 
 s_errorFormat=""             # do NOT print error messages 
 s_errorFormat=" Error> %s"   # standard error messages 
 s_errorFormat=" Erreur> %s"  # French version 
                              # html-padding 
 s_errorFormat="<hr><h3>%s</h3><hr>"  
 s_errorFormat=" Fehler> der Betrieb ist verboten"    
                              # replace all the messages by this text 


2.16.5 s_fieldDelimiter

[Top]
contains characters which are considered as field delimiters by the Field and Split functions, as well as by read column and write table commands. In "Split" and "read table" one can also specify the field delimiter explicitly.
Important. If a character is duplicated in s_fieldDelimiter (e.g. s_fieldDelimiter="::" ), then multiple occurrences of this character will be ignored. Otherwise, EMPTY fields will be created between each pair of identical delimiter characters.
In write table s_fieldDelimiter is honored only if is a one-letter symbol, like "," or "\t".
See also the opposite operation, merging members of string array into one string: Sum( S_, s_separator )
Examples:
 
 s_fieldDelimiter="\t"   # "aaa\t\t bbb" splits into "aaa",""," bbb"  
 s_fieldDelimiter="\t\t" # "aaa\t\t bbb" splits into "aaa"," bbb"  
Default ( " \t\t" i.e. two blanks, two tabs, meaning skip multiple blanks or tabs). Another reasonable possibility is " \t\t\n\n" which means skip blanks,tabs and carriage returns.

2.16.6 s_helpEngine

[Top]
path to the HTML help file browser program. If you have no HTML browser, the default setting is s_helpEngine="icm", so you can use the simple internal ascii help-file viewer more filter ('q' - to stop, '/' to find a string, 'Enter' - next screen). If the desired help information is not found, just type help and then use '/' plus the search pattern to perform the context search in the whole help file.
Examples:
 
 s_helpEngine="/usr/bin/netscape" 
 s_helpEngine="mozilla"  # make sure you can start it in the UNIX shell  
 s_helpEngine="icm"      # why would one need more?  


2.16.7 s_icmhome

[Top]
defines the home directory of the ICM program. This directory contains all standard ICM databases, all scripts, examples, documentation, initial configuration files (later users can override them with the files stored in the s_userDir directory.
The Linux icm-rpm package creates s_icmhome in /usr/icm directory.

2.16.8 s_inxDir

[Top]
defines directory from which icm - index files for large sequence or chemical databases are stored. This variable is used by the write index command. By default s_inxDir is set to s_icmhome + "/data/inx/" .
See also: read index , write index table, write index .

2.16.9 s_icmPrompt

[Top]
defines the ICM-prompt string. This string contains text and a bunch of wild cards for:
  • %o - name of the current molecular object
  • %e - list of the active energy terms (see the set terms command)
  • %t - time spent in ICM (may be convenient for scripts)
  • %T - astronomical Time
  • %% - % character
  • %# - icm-command order number
Be smart, see the energy or penalty terms you are using by adding %e to the prompt string.
Examples:
 
 s_icmPrompt="%## "                     # for askets 
 s_icmPrompt=""                         # for super-askets 
 s_icmPrompt="%T> "                     # for anxious paranoiac freaks 
 s_icmPrompt="MY_ICM/%o/%e/%T/%#> "     # for the verbose 
 s_icmPrompt="Hi-hi|%e-^%o+%T>   "      # for the messy 
 s_icmPrompt="Icm command number %#> "  # for the retarded 
 s_icmPrompt="Hey dude, type something" # for dudes 
 s_icmPrompt="%o/%e> "                  # for humble and wise researches 

Default: "icm/%o> "

2.16.10 s_imageViewer

[Top]
defines the command to view the image files ( tiff, png, targa and rgb formats) if the display option is specified. An alternative to the default is the "xv" program. See also the write image command.
Default for SGIs ( "imgview").

2.16.11 s_javaCodeBase

[Top]
path to the folder containing java applet class files. Java applets are currently used by the web or write html commands with a chemical table.
Default: "/Java/"

2.16.12 s_labelHeader

[Top]
defines a prefix string for all labels. For example, when displaying CPK atoms you may move the label to the right of the atom center by
 
 s_labelHeader="     " 
Default ( "" - an empty string).

2.16.13 s_lib

[Top]
ICM library name root. If you redefine it to say "new", ICM will start to look for the following library files: new.cod, new.bbt, new.bbs, .... etc. in the $ICMHOME directory.
Default ( "icm").

2.16.14 s_logDir

[Top]
when you quit an icm-session, a _seslog.icm file is automatically stored. If the s_logDir variable is empty, it is stored to the s_userDir + "/log/" directory. However one can redirect it to the current working directory ( "." ) or any other directory.
The same logic applies to the _crashlog.icm file which is created when ICM crashes.
Examples:
 
s_logDir = "." # _seslog.icm stored in the current working directory 
s_logDir = ""  # to the current working directory 

2.16.15 s_out

[Top]
a string where some commands store their string/text output. See also: printf read database read string, read table, and read unix,
Default ( "is where the string/text is stored" ).

2.16.16 s_pdbDir

[Top]
directory containing the PDB database of 3D structures. These files can also be easily downloaded directly from the PDB site if the variables are set as in the example below. PDB distributions can exist in several styles (all files in the same directory, or divided etc.). The style is defined by the pdbDirStyle preference.
The pdb directory also contains the derived_data subdirectory with useful files ( pdb sequences, index files etc. )
Example:
 
 s_pdbDir ="ftp://ftp.rcsb.org/pub/pdb/data/structures/divided/pdb/" 
 pdbDirStyle = "ab/pdb1abc.ent.Z" 
 
 s_pdbDir = "/data/pdb/" 
 read sarray s_pdbDir+"/derived_data/index/source.idx" 
 source = Tolower(Trim(Field(source,1))) 
 for i=1,Nof(source) 
   read pdb source[i] 
#  do some analysis 
   delete a_*. 
 endfor 
Default ( "/data/pdb/"). It is usually redefined in the _startup file.

2.16.17 s_projectDir

[Top]
a relative path to the directory in which icm-projects (all the icm-objects in a session) are stored. This path is appended to the s_userDir directory.

2.16.18 s_printCommand

[Top]
a command to print text or postscript files. This command is invoked if the print option is specified in the write image postscript or write postscript commands. Customize this string. Default ( "lp -c" ).
Example:
 
 s_printCommand = "lp -c -d ColorPrn22" 
 write image postscript print  # save image and print 


2.16.19 s_prositeDat

[Top]
is a file containing the full file name of the prosite database of protein patterns. This file is not large and is distributed with ICM. If you have your own copy of prosite, redefine the variable and delete prosite.dat in the $ICMHOME directory to avoid redundancy.
Default ( "prosite.dat" ). It is usually redefined to s_icmhome+"prosite.dat" in the _startup file.

2.16.20 s_psViewer

[Top]
a PostScript viewer used while you are in ICM session. A command to invoke is to be:
 
 unix $s_psViewer </tt><i>your PostScript file name</i>  

Default ( "/usr/opt/bin/gs -q" ).

2.16.21 s_reslib

[Top]
name of the icm residue library. The file will be loaded from the $ICMHOME directory.
Default ( "icm").

2.16.22 s_skipMessages : ignore specific error messages

[Top]
In ICM all error and warning messages are numbered (e.g. " Warning> [123] .. " ). You may specify a set of message numbers which you want to suppress. While the messages are suppressed the error code can still be returned with the Error(number) function.
Example:
 
 a = 1 
 if = 2       # deliberately generate error 
  Error> [2073] illegal IF: wrong condition in  if=2 
 
 s_skipMessages = "[2073]" 
 if = 2        # now no message is generated 
 if Error(number)==2073  quit 
 
 a = yes      # generates another error 
  Error> [696] wrong assignment or name conflict   
 s_skipMessages = "[2073][696]" 
 a = yes      # hides the error message 
 
 234*2352352532  
 Warning> [147] number 2352352532 is too big for an integer (>2147483647)    
 0 
 s_skipMessages = "[2073][696][147]"   # suppress the warning 
 234*2352352532    
 0 

See also: errorAction , s_errorFormat .
Default ( "[3000][3012]" just to show an example).

2.16.23 s_tempDir

[Top]
scratch directory for temporary files ( some montecarlo files will be saved there ).
Default ( "/usr/tmp/").

2.16.24 s_translateString

[Top]
a set of characters used in the ascii representation of numerical values of arrays, matrices and maps. See also the String function and the show map command.
Default ( ".:*0#" ).

2.16.25 s_userDir

[Top]
The path to the user directory containing ICM-related and ICM-generated data files.
The suggested _startup file sets this variable to a subdirectory .icm of the user $HOME directory ( $USERPROFILE for Windows), but you may set it anywhere you want.
Default ( "$HOME/.icm/").



2.16.26 s_usrlib (obsolete)

[Top]
an obsolete variable. The new mechanism to add new icm residue libraries uses the LIBRARY.ressarray. You can generate the entries using the write library command.
Default ( "usr").

2.16.27 s_webEntrezLink

[Top]
defines the NCBI Entrez link.
See also: webEntrezOption, Default ( "http://www3.ncbi.nlm.nih.gov/htbin-post/Entrez/query?db=s&form=6&uid=%s&Dopt=%c").

2.16.28 s_webViewer

[Top]
an HTML browser invoked by ICM by the following commands: web dbEntryCode, web T_, write html.
Examples:
 
 s_webViewer="/usr/bin/netscape" 
 s_webViewer="Mozilla"          
Default ( "netscape").

2.16.29 s_xpdbDir

[Top]
path to the ICM XPDB database of compact binary ICM objects which are annotated with the site information. The advantage of the XPDB database is the speed of reading and smaller size than PDB. XPDB entries are read about 80 times faster!
Here we compare the execution times for the pdb and xpdb files:
 
eos:/home/ruben/icm> time ./icm -s -e 'read object "/data/xpdb/1ffk.ob"' 
0.450u 0.090s 0:00.54 100.0%   
eos:/home/ruben/icm> time ./icm -s -e 'read pdb "/data/pdb/ff/pdb1ffk.ent.Z"' 
38.800u 0.430s 0:42.11 93.1%  



Prev
l_xrUseHydrogen
Home
Up
Next
preference

Copyright© 1989-2004, Molsoft,LLC - All Rights Reserved.
This document contains proprietary and confidential information of Molsoft, LLC.
The content of this document may not be disclosed to third parties, copied or duplicated in any form,
in whole or in part, without the prior written permission from Molsoft, LLC.