annotate mayachemtools/docs/scripts/html/ExtractFromSDFiles.html @ 9:ab29fa5c8c1f draft default tip

Uploaded
author deepakjadmin
date Thu, 15 Dec 2016 14:18:03 -0500
parents 73ae111cf86f
children
Ignore whitespace changes - Everywhere: Within whitespace: At end of lines:
rev   line source
0
73ae111cf86f Uploaded
deepakjadmin
parents:
diff changeset
1 <html>
73ae111cf86f Uploaded
deepakjadmin
parents:
diff changeset
2 <head>
73ae111cf86f Uploaded
deepakjadmin
parents:
diff changeset
3 <title>MayaChemTools:Documentation:ExtractFromSDFiles.pl</title>
73ae111cf86f Uploaded
deepakjadmin
parents:
diff changeset
4 <meta http-equiv="content-type" content="text/html;charset=utf-8">
73ae111cf86f Uploaded
deepakjadmin
parents:
diff changeset
5 <link rel="stylesheet" type="text/css" href="../../css/MayaChemTools.css">
73ae111cf86f Uploaded
deepakjadmin
parents:
diff changeset
6 </head>
73ae111cf86f Uploaded
deepakjadmin
parents:
diff changeset
7 <body leftmargin="20" rightmargin="20" topmargin="10" bottommargin="10">
73ae111cf86f Uploaded
deepakjadmin
parents:
diff changeset
8 <br/>
73ae111cf86f Uploaded
deepakjadmin
parents:
diff changeset
9 <center>
73ae111cf86f Uploaded
deepakjadmin
parents:
diff changeset
10 <a href="http://www.mayachemtools.org" title="MayaChemTools Home"><img src="../../images/MayaChemToolsLogo.gif" border="0" alt="MayaChemTools"></a>
73ae111cf86f Uploaded
deepakjadmin
parents:
diff changeset
11 </center>
73ae111cf86f Uploaded
deepakjadmin
parents:
diff changeset
12 <br/>
73ae111cf86f Uploaded
deepakjadmin
parents:
diff changeset
13 <div class="DocNav">
73ae111cf86f Uploaded
deepakjadmin
parents:
diff changeset
14 <table width="100%" border=0 cellpadding=0 cellspacing=2>
73ae111cf86f Uploaded
deepakjadmin
parents:
diff changeset
15 <tr align="left" valign="top"><td width="33%" align="left"><a href="./ExtractFromPDBFiles.html" title="ExtractFromPDBFiles.html">Previous</a>&nbsp;&nbsp;<a href="./index.html" title="Table of Contents">TOC</a>&nbsp;&nbsp;<a href="./ExtractFromSequenceFiles.html" title="ExtractFromSequenceFiles.html">Next</a></td><td width="34%" align="middle"><strong>ExtractFromSDFiles.pl</strong></td><td width="33%" align="right"><a href="././code/ExtractFromSDFiles.html" title="View source code">Code</a>&nbsp;|&nbsp;<a href="./../pdf/ExtractFromSDFiles.pdf" title="PDF US Letter Size">PDF</a>&nbsp;|&nbsp;<a href="./../pdfgreen/ExtractFromSDFiles.pdf" title="PDF US Letter Size with narrow margins: www.changethemargins.com">PDFGreen</a>&nbsp;|&nbsp;<a href="./../pdfa4/ExtractFromSDFiles.pdf" title="PDF A4 Size">PDFA4</a>&nbsp;|&nbsp;<a href="./../pdfa4green/ExtractFromSDFiles.pdf" title="PDF A4 Size with narrow margins: www.changethemargins.com">PDFA4Green</a></td></tr>
73ae111cf86f Uploaded
deepakjadmin
parents:
diff changeset
16 </table>
73ae111cf86f Uploaded
deepakjadmin
parents:
diff changeset
17 </div>
73ae111cf86f Uploaded
deepakjadmin
parents:
diff changeset
18 <p>
73ae111cf86f Uploaded
deepakjadmin
parents:
diff changeset
19 </p>
73ae111cf86f Uploaded
deepakjadmin
parents:
diff changeset
20 <h2>NAME</h2>
73ae111cf86f Uploaded
deepakjadmin
parents:
diff changeset
21 <p>ExtractFromSDFiles.pl - Extract specific data from SDFile(s)</p>
73ae111cf86f Uploaded
deepakjadmin
parents:
diff changeset
22 <p>
73ae111cf86f Uploaded
deepakjadmin
parents:
diff changeset
23 </p>
73ae111cf86f Uploaded
deepakjadmin
parents:
diff changeset
24 <h2>SYNOPSIS</h2>
73ae111cf86f Uploaded
deepakjadmin
parents:
diff changeset
25 <p>ExtractFromSDFiles.pl SDFile(s)...</p>
73ae111cf86f Uploaded
deepakjadmin
parents:
diff changeset
26 <p>ExtractFromSDFiles.pl [<strong>-h, --help</strong>]
73ae111cf86f Uploaded
deepakjadmin
parents:
diff changeset
27 [<strong>-d, --datafields</strong> &quot;fieldlabel,...&quot; | &quot;fieldlabel,value,criteria...&quot; | &quot;fieldlabel,value,value...&quot;]
73ae111cf86f Uploaded
deepakjadmin
parents:
diff changeset
28 [<strong>--datafieldsfile</strong> filename] [<strong>--indelim</strong> comma | tab | semicolon] [<strong>-m, --mode</strong> alldatafields |
73ae111cf86f Uploaded
deepakjadmin
parents:
diff changeset
29 commondatafields | | datafieldnotbylist | datafields | datafieldsbyvalue | datafieldsbyregex | datafieldbylist |
73ae111cf86f Uploaded
deepakjadmin
parents:
diff changeset
30 datafielduniquebylist | molnames | randomcmpds | recordnum | recordnums | recordrange | 2dcmpdrecords |
73ae111cf86f Uploaded
deepakjadmin
parents:
diff changeset
31 3dcmpdrecords ] [<strong>-n, --numofcmpds</strong> number] [<strong>--outdelim</strong> comma | tab | semicolon]
73ae111cf86f Uploaded
deepakjadmin
parents:
diff changeset
32 [<strong>--output</strong> SD | text | both] [<strong>-o, --overwrite</strong>] [<strong>-q, --quote</strong> yes | no]
73ae111cf86f Uploaded
deepakjadmin
parents:
diff changeset
33 [<strong>--record</strong> recnum | startrecnum,endrecnum] <strong>--RegexIgnoreCase</strong> <em>yes or no</em>
73ae111cf86f Uploaded
deepakjadmin
parents:
diff changeset
34 [<strong>-r, --root</strong> rootname] [<strong>-s, --seed</strong> number] [<strong>--StrDataString</strong> yes | no]
73ae111cf86f Uploaded
deepakjadmin
parents:
diff changeset
35 [<strong>--StrDataStringDelimiter</strong> text] [<strong>--StrDataStringMode</strong> StrOnly | StrAndDataFields]
73ae111cf86f Uploaded
deepakjadmin
parents:
diff changeset
36 [<strong>--ValueComparisonMode</strong> <em>Numeric | Alphanumeric</em>]
73ae111cf86f Uploaded
deepakjadmin
parents:
diff changeset
37 [<strong>-v, --violations-</strong> number] [<strong>-w, --workingdir</strong> dirname] SDFile(s)...</p>
73ae111cf86f Uploaded
deepakjadmin
parents:
diff changeset
38 <p>
73ae111cf86f Uploaded
deepakjadmin
parents:
diff changeset
39 </p>
73ae111cf86f Uploaded
deepakjadmin
parents:
diff changeset
40 <h2>DESCRIPTION</h2>
73ae111cf86f Uploaded
deepakjadmin
parents:
diff changeset
41 <p>Extract specific data from <em>SDFile(s)</em> and generate appropriate SD or CSV/TSV text
73ae111cf86f Uploaded
deepakjadmin
parents:
diff changeset
42 file(s). The structure data from SDFile(s) is not transferred to CSV/TSV text file(s).
73ae111cf86f Uploaded
deepakjadmin
parents:
diff changeset
43 Multiple SDFile names are separated by spaces. The valid file extensions are <em>.sdf</em>
73ae111cf86f Uploaded
deepakjadmin
parents:
diff changeset
44 and <em>.sd</em>. All other file names are ignored. All the SD files in a current directory
73ae111cf86f Uploaded
deepakjadmin
parents:
diff changeset
45 can be specified either by <em>*.sdf</em> or the current directory name.</p>
73ae111cf86f Uploaded
deepakjadmin
parents:
diff changeset
46 <p>
73ae111cf86f Uploaded
deepakjadmin
parents:
diff changeset
47 </p>
73ae111cf86f Uploaded
deepakjadmin
parents:
diff changeset
48 <h2>OPTIONS</h2>
73ae111cf86f Uploaded
deepakjadmin
parents:
diff changeset
49 <dl>
73ae111cf86f Uploaded
deepakjadmin
parents:
diff changeset
50 <dt><strong><strong>-h, --help</strong></strong></dt>
73ae111cf86f Uploaded
deepakjadmin
parents:
diff changeset
51 <dd>
73ae111cf86f Uploaded
deepakjadmin
parents:
diff changeset
52 <p>Print this help message.</p>
73ae111cf86f Uploaded
deepakjadmin
parents:
diff changeset
53 </dd>
73ae111cf86f Uploaded
deepakjadmin
parents:
diff changeset
54 <dt><strong><strong>-d, --datafields</strong> <em>&quot;fieldlabel,...&quot; | &quot;fieldlabel,value,criteria...&quot; | &quot;fieldlabel,value,value,...&quot;</em></strong></dt>
73ae111cf86f Uploaded
deepakjadmin
parents:
diff changeset
55 <dd>
73ae111cf86f Uploaded
deepakjadmin
parents:
diff changeset
56 <p>This value is mode specific. In general, it's a list of comma separated data field labels
73ae111cf86f Uploaded
deepakjadmin
parents:
diff changeset
57 and associated mode specific values.</p>
73ae111cf86f Uploaded
deepakjadmin
parents:
diff changeset
58 <p>For <em>datafields</em> mode, input value format is: <em>fieldlabel,...</em>. Examples:</p>
73ae111cf86f Uploaded
deepakjadmin
parents:
diff changeset
59 <div class="OptionsBox">
73ae111cf86f Uploaded
deepakjadmin
parents:
diff changeset
60 Extreg
73ae111cf86f Uploaded
deepakjadmin
parents:
diff changeset
61 <br/> Extreg,CompoundName,ID</div>
73ae111cf86f Uploaded
deepakjadmin
parents:
diff changeset
62 <p>For <em>datafieldsbyvalue</em> mode, input value format contains these triplets:
73ae111cf86f Uploaded
deepakjadmin
parents:
diff changeset
63 <em>fieldlabel,value, criteria...</em>. Possible values for criteria: <em>le, ge or eq</em>.
73ae111cf86f Uploaded
deepakjadmin
parents:
diff changeset
64 The values of <strong>--ValueComparisonMode</strong> indicates whether values are
73ae111cf86f Uploaded
deepakjadmin
parents:
diff changeset
65 compared numerical or string comarison operators. Default is to consider
73ae111cf86f Uploaded
deepakjadmin
parents:
diff changeset
66 data field values as numerical values and use numerical comparison operators.
73ae111cf86f Uploaded
deepakjadmin
parents:
diff changeset
67 Examples:</p>
73ae111cf86f Uploaded
deepakjadmin
parents:
diff changeset
68 <div class="OptionsBox">
73ae111cf86f Uploaded
deepakjadmin
parents:
diff changeset
69 MolWt,450,le
73ae111cf86f Uploaded
deepakjadmin
parents:
diff changeset
70 <br/> MolWt,450,le,LogP,5,le,SumNumNO,10,le,SumNHOH,5,le</div>
73ae111cf86f Uploaded
deepakjadmin
parents:
diff changeset
71 <p>For <em>datafieldsbyregex</em> mode, input value format contains these triplets:
73ae111cf86f Uploaded
deepakjadmin
parents:
diff changeset
72 <em>fieldlabel,regex, criteria...</em>. <em>regex</em> corresponds to any valid regular expression
73ae111cf86f Uploaded
deepakjadmin
parents:
diff changeset
73 and is used to match the values for specified <em>fieldlabel</em>. Possible values for criteria:
73ae111cf86f Uploaded
deepakjadmin
parents:
diff changeset
74 <em>eq or ne</em>. During <em>eq</em> and <em>ne</em> values, data field label value is matched with
73ae111cf86f Uploaded
deepakjadmin
parents:
diff changeset
75 regular expression using =~ and !~ respectively. <strong>--RegexIgnoreCase</strong> option
73ae111cf86f Uploaded
deepakjadmin
parents:
diff changeset
76 value is used to determine whether to ignore letter upper/lower case during
73ae111cf86f Uploaded
deepakjadmin
parents:
diff changeset
77 regular expression match. Examples:</p>
73ae111cf86f Uploaded
deepakjadmin
parents:
diff changeset
78 <div class="OptionsBox">
73ae111cf86f Uploaded
deepakjadmin
parents:
diff changeset
79 Name,ol,eq
73ae111cf86f Uploaded
deepakjadmin
parents:
diff changeset
80 <br/> Name,'^pat',ne</div>
73ae111cf86f Uploaded
deepakjadmin
parents:
diff changeset
81 <p>For <em>datafieldbylist</em> and <em>datafielduniquebylist</em> mode, input value format is:
73ae111cf86f Uploaded
deepakjadmin
parents:
diff changeset
82 <em>fieldlabel,value1,value2...</em>. This is equivalent to <em>datafieldsbyvalue</em> mode with
73ae111cf86f Uploaded
deepakjadmin
parents:
diff changeset
83 this input value format:<em>fieldlabel,value1,eq,fieldlabel,value2,eq,...</em>. For
73ae111cf86f Uploaded
deepakjadmin
parents:
diff changeset
84 <em>datafielduniquebylist</em> mode, only unique compounds identified by first occurrence
73ae111cf86f Uploaded
deepakjadmin
parents:
diff changeset
85 of <em>value</em> associated with <em>fieldlabel</em> in <em>SDFile(s)</em> are kept; any subsequent compounds
73ae111cf86f Uploaded
deepakjadmin
parents:
diff changeset
86 are simply ignored.</p>
73ae111cf86f Uploaded
deepakjadmin
parents:
diff changeset
87 <p>For <em>datafieldnotbylist</em> mode, input value format is: <em>fieldlabel,value1,value2...</em>. In this
73ae111cf86f Uploaded
deepakjadmin
parents:
diff changeset
88 mode, the script behaves exactly opposite of <em>datafieldbylist</em> mode, and only those compounds
73ae111cf86f Uploaded
deepakjadmin
parents:
diff changeset
89 are extracted whose data field values don't match any specified data field value.</p>
73ae111cf86f Uploaded
deepakjadmin
parents:
diff changeset
90 </dd>
73ae111cf86f Uploaded
deepakjadmin
parents:
diff changeset
91 <dt><strong><strong>--datafieldsfile</strong> <em>filename</em></strong></dt>
73ae111cf86f Uploaded
deepakjadmin
parents:
diff changeset
92 <dd>
73ae111cf86f Uploaded
deepakjadmin
parents:
diff changeset
93 <p>Filename which contains various mode specific values. This option provides a way
73ae111cf86f Uploaded
deepakjadmin
parents:
diff changeset
94 to specify mode specific values in a file instead of entering them on the command
73ae111cf86f Uploaded
deepakjadmin
parents:
diff changeset
95 line using <strong>-d --datafields</strong>.</p>
73ae111cf86f Uploaded
deepakjadmin
parents:
diff changeset
96 <p>For <em>datafields</em> mode, input file lines contain comma delimited field labels:
73ae111cf86f Uploaded
deepakjadmin
parents:
diff changeset
97 <em>fieldlabel,...</em>. Example:</p>
73ae111cf86f Uploaded
deepakjadmin
parents:
diff changeset
98 <div class="OptionsBox">
73ae111cf86f Uploaded
deepakjadmin
parents:
diff changeset
99 Line 1:MolId
73ae111cf86f Uploaded
deepakjadmin
parents:
diff changeset
100 <br/> Line 2:&quot;Extreg&quot;,CompoundName,ID</div>
73ae111cf86f Uploaded
deepakjadmin
parents:
diff changeset
101 <p>For <em>datafieldsbyvalue</em> mode, input file lines contains these comma separated triplets:
73ae111cf86f Uploaded
deepakjadmin
parents:
diff changeset
102 <em>fieldlabel,value, criteria</em>. Possible values for criteria: <em>le, ge or eq</em>. Examples:</p>
73ae111cf86f Uploaded
deepakjadmin
parents:
diff changeset
103 <div class="OptionsBox">
73ae111cf86f Uploaded
deepakjadmin
parents:
diff changeset
104 Line 1:MolWt,450,le</div>
73ae111cf86f Uploaded
deepakjadmin
parents:
diff changeset
105 <div class="OptionsBox">
73ae111cf86f Uploaded
deepakjadmin
parents:
diff changeset
106 Line 1:&quot;MolWt&quot;,450,le,&quot;LogP&quot;,5,le,&quot;SumNumNO&quot;,10,le,&quot;SumNHOH&quot;,5,le</div>
73ae111cf86f Uploaded
deepakjadmin
parents:
diff changeset
107 <div class="OptionsBox">
73ae111cf86f Uploaded
deepakjadmin
parents:
diff changeset
108 Line 1:MolWt,450,le
73ae111cf86f Uploaded
deepakjadmin
parents:
diff changeset
109 <br/> Line 2:&quot;LogP&quot;,5,le
73ae111cf86f Uploaded
deepakjadmin
parents:
diff changeset
110 <br/> Line 3:&quot;SumNumNO&quot;,10,le
73ae111cf86f Uploaded
deepakjadmin
parents:
diff changeset
111 <br/> Line 4: SumNHOH,5,le</div>
73ae111cf86f Uploaded
deepakjadmin
parents:
diff changeset
112 <p>For <em>datafieldbylist</em> and <em>datafielduniquebylist</em> mode, input file line format is:</p>
73ae111cf86f Uploaded
deepakjadmin
parents:
diff changeset
113 <div class="OptionsBox">
73ae111cf86f Uploaded
deepakjadmin
parents:
diff changeset
114 Line 1:fieldlabel;
73ae111cf86f Uploaded
deepakjadmin
parents:
diff changeset
115 <br/> Subsequent lines:value1,value2...</div>
73ae111cf86f Uploaded
deepakjadmin
parents:
diff changeset
116 <p>For <em>datafieldbylist</em>, <em>datafielduniquebylist</em>, and <em>datafieldnotbylist</em> mode, input file
73ae111cf86f Uploaded
deepakjadmin
parents:
diff changeset
117 line format is:</p>
73ae111cf86f Uploaded
deepakjadmin
parents:
diff changeset
118 <div class="OptionsBox">
73ae111cf86f Uploaded
deepakjadmin
parents:
diff changeset
119 Line 1:fieldlabel;
73ae111cf86f Uploaded
deepakjadmin
parents:
diff changeset
120 <br/> Subsequent lines:value1,value2...</div>
73ae111cf86f Uploaded
deepakjadmin
parents:
diff changeset
121 <p>For <em>datafielduniquebylist</em> mode, only unique compounds identified by first occurrence
73ae111cf86f Uploaded
deepakjadmin
parents:
diff changeset
122 of <em>value</em> associated with <em>fieldlabel</em> in <em>SDFile(s)</em> are kept; any subsequent compounds
73ae111cf86f Uploaded
deepakjadmin
parents:
diff changeset
123 are simply ignored. Example:</p>
73ae111cf86f Uploaded
deepakjadmin
parents:
diff changeset
124 <div class="OptionsBox">
73ae111cf86f Uploaded
deepakjadmin
parents:
diff changeset
125 Line 1: MolID
73ae111cf86f Uploaded
deepakjadmin
parents:
diff changeset
126 <br/> Subsequent Lines:
73ae111cf86f Uploaded
deepakjadmin
parents:
diff changeset
127 <br/> 907508
73ae111cf86f Uploaded
deepakjadmin
parents:
diff changeset
128 <br/> 832291,4642
73ae111cf86f Uploaded
deepakjadmin
parents:
diff changeset
129 <br/> &quot;1254&quot;,&quot;907303&quot;</div>
73ae111cf86f Uploaded
deepakjadmin
parents:
diff changeset
130 </dd>
73ae111cf86f Uploaded
deepakjadmin
parents:
diff changeset
131 <dt><strong><strong>--indelim</strong> <em>comma | tab | semicolon</em></strong></dt>
73ae111cf86f Uploaded
deepakjadmin
parents:
diff changeset
132 <dd>
73ae111cf86f Uploaded
deepakjadmin
parents:
diff changeset
133 <p>Delimiter used to specify text values for <strong>-d --datafields</strong> and <strong>--datafieldsfile</strong> options.
73ae111cf86f Uploaded
deepakjadmin
parents:
diff changeset
134 Possible values: <em>comma, tab, or semicolon</em>. Default value: <em>comma</em>.</p>
73ae111cf86f Uploaded
deepakjadmin
parents:
diff changeset
135 </dd>
73ae111cf86f Uploaded
deepakjadmin
parents:
diff changeset
136 <dt><strong><strong>-m, --mode</strong> <em>alldatafields | commondatafields | datafields | datafieldsbyvalue | datafieldsbyregex | datafieldbylist | datafielduniquebylist | datafieldnotbylist | molnames | randomcmpds | recordnum | recordnums | recordrange | 2dcmpdrecords | 3dcmpdrecords</em></strong></dt>
73ae111cf86f Uploaded
deepakjadmin
parents:
diff changeset
137 <dd>
73ae111cf86f Uploaded
deepakjadmin
parents:
diff changeset
138 <p>Specify what to extract from <em>SDFile(s)</em>. Possible values: <em>alldatafields, commondatafields,
73ae111cf86f Uploaded
deepakjadmin
parents:
diff changeset
139 datafields, datafieldsbyvalue, datafieldsbyregex, datafieldbylist, datafielduniquebylist, datafieldnotbylist,
73ae111cf86f Uploaded
deepakjadmin
parents:
diff changeset
140 molnames, randomcmpds, recordnum, recordnums, recordrange, 2dcmpdrecords, 3dcmpdrecords</em>.
73ae111cf86f Uploaded
deepakjadmin
parents:
diff changeset
141 Default value: <em>alldatafields</em>.</p>
73ae111cf86f Uploaded
deepakjadmin
parents:
diff changeset
142 <p>For <em>alldatafields</em> and <em>molnames</em> mode, only a CSV/TSV text file is generated; for all
73ae111cf86f Uploaded
deepakjadmin
parents:
diff changeset
143 other modes, however, a SD file is generated by default - you can change the behavior to genereate
73ae111cf86f Uploaded
deepakjadmin
parents:
diff changeset
144 text file using <em>--output</em> option.</p>
73ae111cf86f Uploaded
deepakjadmin
parents:
diff changeset
145 <p>For <em>3DCmpdRecords</em> mode, only those compounds with at least one non-zero value for Z atomic coordinates
73ae111cf86f Uploaded
deepakjadmin
parents:
diff changeset
146 are retrieved; however, during retrieval of compounds in <em>2DCmpdRecords</em> mode, all Z atomic coordinates must
73ae111cf86f Uploaded
deepakjadmin
parents:
diff changeset
147 be zero.</p>
73ae111cf86f Uploaded
deepakjadmin
parents:
diff changeset
148 </dd>
73ae111cf86f Uploaded
deepakjadmin
parents:
diff changeset
149 <dt><strong><strong>-n, --numofcmpds</strong> <em>number</em></strong></dt>
73ae111cf86f Uploaded
deepakjadmin
parents:
diff changeset
150 <dd>
73ae111cf86f Uploaded
deepakjadmin
parents:
diff changeset
151 <p>Number of compouds to extract during <em>randomcmpds</em> mode.</p>
73ae111cf86f Uploaded
deepakjadmin
parents:
diff changeset
152 </dd>
73ae111cf86f Uploaded
deepakjadmin
parents:
diff changeset
153 <dt><strong><strong>--outdelim</strong> <em>comma | tab | semicolon</em></strong></dt>
73ae111cf86f Uploaded
deepakjadmin
parents:
diff changeset
154 <dd>
73ae111cf86f Uploaded
deepakjadmin
parents:
diff changeset
155 <p>Delimiter for output CSV/TSV text file(s). Possible values: <em>comma, tab, or semicolon</em>
73ae111cf86f Uploaded
deepakjadmin
parents:
diff changeset
156 Default value: <em>comma</em></p>
73ae111cf86f Uploaded
deepakjadmin
parents:
diff changeset
157 </dd>
73ae111cf86f Uploaded
deepakjadmin
parents:
diff changeset
158 <dt><strong><strong>--output</strong> <em>SD | text | both</em></strong></dt>
73ae111cf86f Uploaded
deepakjadmin
parents:
diff changeset
159 <dd>
73ae111cf86f Uploaded
deepakjadmin
parents:
diff changeset
160 <p>Type of output files to generate. Possible values: <em>SD, text, or both</em>. Default value: <em>SD</em>. For
73ae111cf86f Uploaded
deepakjadmin
parents:
diff changeset
161 <em>alldatafields</em> and <em>molnames</em> mode, this option is ingored and only a CSV/TSV text file is generated.</p>
73ae111cf86f Uploaded
deepakjadmin
parents:
diff changeset
162 </dd>
73ae111cf86f Uploaded
deepakjadmin
parents:
diff changeset
163 <dt><strong><strong>-o, --overwrite</strong></strong></dt>
73ae111cf86f Uploaded
deepakjadmin
parents:
diff changeset
164 <dd>
73ae111cf86f Uploaded
deepakjadmin
parents:
diff changeset
165 <p>Overwrite existing files.</p>
73ae111cf86f Uploaded
deepakjadmin
parents:
diff changeset
166 </dd>
73ae111cf86f Uploaded
deepakjadmin
parents:
diff changeset
167 <dt><strong><strong>-q, --quote</strong> <em>yes | no</em></strong></dt>
73ae111cf86f Uploaded
deepakjadmin
parents:
diff changeset
168 <dd>
73ae111cf86f Uploaded
deepakjadmin
parents:
diff changeset
169 <p>Put quote around column values in output CSV/TSV text file(s). Possible values:
73ae111cf86f Uploaded
deepakjadmin
parents:
diff changeset
170 <em>yes or no</em>. Default value: <em>yes</em>.</p>
73ae111cf86f Uploaded
deepakjadmin
parents:
diff changeset
171 </dd>
73ae111cf86f Uploaded
deepakjadmin
parents:
diff changeset
172 <dt><strong><strong>--record</strong> <em>recnum | recnums | startrecnum,endrecnum</em></strong></dt>
73ae111cf86f Uploaded
deepakjadmin
parents:
diff changeset
173 <dd>
73ae111cf86f Uploaded
deepakjadmin
parents:
diff changeset
174 <p>Record number, record numbers or range of records to extract during <em>recordnum</em>, <em>recordnums</em>
73ae111cf86f Uploaded
deepakjadmin
parents:
diff changeset
175 and <em>recordrange</em> mode. Input value format is: &lt;num&gt;, &lt;num1,num2,...&gt; and &lt;startnum, endnum&gt;
73ae111cf86f Uploaded
deepakjadmin
parents:
diff changeset
176 for <em>recordnum</em>, <em>recordnums</em> and <em>recordrange</em> modes recpectively. Default value: none.</p>
73ae111cf86f Uploaded
deepakjadmin
parents:
diff changeset
177 </dd>
73ae111cf86f Uploaded
deepakjadmin
parents:
diff changeset
178 <dt><strong><strong>--RegexIgnoreCase</strong> <em>yes or no</em></strong></dt>
73ae111cf86f Uploaded
deepakjadmin
parents:
diff changeset
179 <dd>
73ae111cf86f Uploaded
deepakjadmin
parents:
diff changeset
180 <p>Specify whether to ingnore case during <em>datafieldsbyregex</em> value of <strong>-m, --mode</strong> option.
73ae111cf86f Uploaded
deepakjadmin
parents:
diff changeset
181 Possible values: <em>yes or no</em>. Default value: <em>yes</em>.</p>
73ae111cf86f Uploaded
deepakjadmin
parents:
diff changeset
182 </dd>
73ae111cf86f Uploaded
deepakjadmin
parents:
diff changeset
183 <dt><strong><strong>-r, --root</strong> <em>rootname</em></strong></dt>
73ae111cf86f Uploaded
deepakjadmin
parents:
diff changeset
184 <dd>
73ae111cf86f Uploaded
deepakjadmin
parents:
diff changeset
185 <p>New file name is generated using the root: &lt;Root&gt;.&lt;Ext&gt;. Default for new file
73ae111cf86f Uploaded
deepakjadmin
parents:
diff changeset
186 names: &lt;SDFileName&gt;&lt;mode&gt;.&lt;Ext&gt;. The file type determines &lt;Ext&gt; value.
73ae111cf86f Uploaded
deepakjadmin
parents:
diff changeset
187 The sdf, csv, and tsv &lt;Ext&gt; values are used for SD, comma/semicolon, and tab
73ae111cf86f Uploaded
deepakjadmin
parents:
diff changeset
188 delimited text files respectively.This option is ignored for multiple input files.</p>
73ae111cf86f Uploaded
deepakjadmin
parents:
diff changeset
189 </dd>
73ae111cf86f Uploaded
deepakjadmin
parents:
diff changeset
190 <dt><strong><strong>-s, --seed</strong> <em>number</em></strong></dt>
73ae111cf86f Uploaded
deepakjadmin
parents:
diff changeset
191 <dd>
73ae111cf86f Uploaded
deepakjadmin
parents:
diff changeset
192 <p>Random number seed used for <em>randomcmpds</em> mode. Default:123456789.</p>
73ae111cf86f Uploaded
deepakjadmin
parents:
diff changeset
193 </dd>
73ae111cf86f Uploaded
deepakjadmin
parents:
diff changeset
194 <dt><strong><strong>--StrDataString</strong> <em>yes | no</em></strong></dt>
73ae111cf86f Uploaded
deepakjadmin
parents:
diff changeset
195 <dd>
73ae111cf86f Uploaded
deepakjadmin
parents:
diff changeset
196 <p>Specify whether to write out structure data string to CSV/TSV text file(s). Possible values:
73ae111cf86f Uploaded
deepakjadmin
parents:
diff changeset
197 <em>yes or no</em>. Default value: <em>no</em>.</p>
73ae111cf86f Uploaded
deepakjadmin
parents:
diff changeset
198 <p>The value of <strong>StrDataStringDelimiter</strong> option is used as a delimiter to join structure
73ae111cf86f Uploaded
deepakjadmin
parents:
diff changeset
199 data lines into a structure data string.</p>
73ae111cf86f Uploaded
deepakjadmin
parents:
diff changeset
200 <p>This option is ignored during generation of SD file(s).</p>
73ae111cf86f Uploaded
deepakjadmin
parents:
diff changeset
201 </dd>
73ae111cf86f Uploaded
deepakjadmin
parents:
diff changeset
202 <dt><strong><strong>--StrDataStringDelimiter</strong> <em>text</em></strong></dt>
73ae111cf86f Uploaded
deepakjadmin
parents:
diff changeset
203 <dd>
73ae111cf86f Uploaded
deepakjadmin
parents:
diff changeset
204 <p>Delimiter for joining multiple stucture data lines into a string before writing to CSV/TSV text
73ae111cf86f Uploaded
deepakjadmin
parents:
diff changeset
205 file(s). Possible values: <em>any alphanumeric text</em>. Default value: <em>|</em>.</p>
73ae111cf86f Uploaded
deepakjadmin
parents:
diff changeset
206 <p>This option is ignored during generation of SD file(s).</p>
73ae111cf86f Uploaded
deepakjadmin
parents:
diff changeset
207 </dd>
73ae111cf86f Uploaded
deepakjadmin
parents:
diff changeset
208 <dt><strong><strong>--StrDataStringMode</strong> <em>StrOnly | StrAndDataFields</em></strong></dt>
73ae111cf86f Uploaded
deepakjadmin
parents:
diff changeset
209 <dd>
73ae111cf86f Uploaded
deepakjadmin
parents:
diff changeset
210 <p>Specify whether to include SD data fields and values along with the structure data into structure
73ae111cf86f Uploaded
deepakjadmin
parents:
diff changeset
211 data string before writing it out to CSV/TSV text file(s). Possible values: <em>StrOnly or StrAndDataFields</em>.
73ae111cf86f Uploaded
deepakjadmin
parents:
diff changeset
212 Default value: <em>StrOnly</em>.</p>
73ae111cf86f Uploaded
deepakjadmin
parents:
diff changeset
213 <p>The value of <strong>StrDataStringDelimiter</strong> option is used as a delimiter to join structure
73ae111cf86f Uploaded
deepakjadmin
parents:
diff changeset
214 data lines into a structure data string.</p>
73ae111cf86f Uploaded
deepakjadmin
parents:
diff changeset
215 <p>This option is ignored during generation of SD file(s).</p>
73ae111cf86f Uploaded
deepakjadmin
parents:
diff changeset
216 </dd>
73ae111cf86f Uploaded
deepakjadmin
parents:
diff changeset
217 <dt><strong><strong>--ValueComparisonMode</strong> <em>Numeric | Alphanumeric</em></strong></dt>
73ae111cf86f Uploaded
deepakjadmin
parents:
diff changeset
218 <dd>
73ae111cf86f Uploaded
deepakjadmin
parents:
diff changeset
219 <p>Specify how to compare data field values during <em>datafieldsbyvalue</em> mode: Compare
73ae111cf86f Uploaded
deepakjadmin
parents:
diff changeset
220 values using either numeric or string ((eq, le, ge) comparison operators. Possible values:
73ae111cf86f Uploaded
deepakjadmin
parents:
diff changeset
221 <em>Numeric or Alphanumeric</em>. Defaule value: <em>Numeric</em>.</p>
73ae111cf86f Uploaded
deepakjadmin
parents:
diff changeset
222 </dd>
73ae111cf86f Uploaded
deepakjadmin
parents:
diff changeset
223 <dt><strong><strong>-v, --violations</strong> <em>number</em></strong></dt>
73ae111cf86f Uploaded
deepakjadmin
parents:
diff changeset
224 <dd>
73ae111cf86f Uploaded
deepakjadmin
parents:
diff changeset
225 <p>Number of criterion violations allowed for values specified during <em>datafieldsbyvalue</em>
73ae111cf86f Uploaded
deepakjadmin
parents:
diff changeset
226 and <em>datafieldsbyregex</em> mode. Default value: <em>0</em>.</p>
73ae111cf86f Uploaded
deepakjadmin
parents:
diff changeset
227 </dd>
73ae111cf86f Uploaded
deepakjadmin
parents:
diff changeset
228 <dt><strong><strong>-w, --workingdir</strong> <em>dirname</em></strong></dt>
73ae111cf86f Uploaded
deepakjadmin
parents:
diff changeset
229 <dd>
73ae111cf86f Uploaded
deepakjadmin
parents:
diff changeset
230 <p>Location of working directory. Default: current directory.</p>
73ae111cf86f Uploaded
deepakjadmin
parents:
diff changeset
231 </dd>
73ae111cf86f Uploaded
deepakjadmin
parents:
diff changeset
232 </dl>
73ae111cf86f Uploaded
deepakjadmin
parents:
diff changeset
233 <p>
73ae111cf86f Uploaded
deepakjadmin
parents:
diff changeset
234 </p>
73ae111cf86f Uploaded
deepakjadmin
parents:
diff changeset
235 <h2>EXAMPLES</h2>
73ae111cf86f Uploaded
deepakjadmin
parents:
diff changeset
236 <p>To retrieve all data fields from SD files and generate CSV text files, type:</p>
73ae111cf86f Uploaded
deepakjadmin
parents:
diff changeset
237 <div class="ExampleBox">
73ae111cf86f Uploaded
deepakjadmin
parents:
diff changeset
238 % ExtractFromSDFiles.pl -o Sample.sdf
73ae111cf86f Uploaded
deepakjadmin
parents:
diff changeset
239 <br/>% ExtractFromSDFiles.pl -o *.sdf</div>
73ae111cf86f Uploaded
deepakjadmin
parents:
diff changeset
240 <p>To retrieve all data fields from SD file and generate CSV text files containing
73ae111cf86f Uploaded
deepakjadmin
parents:
diff changeset
241 a column with structure data as a string with | as line delimiter, type:</p>
73ae111cf86f Uploaded
deepakjadmin
parents:
diff changeset
242 <div class="ExampleBox">
73ae111cf86f Uploaded
deepakjadmin
parents:
diff changeset
243 % ExtractFromSDFiles.pl --StrDataString Yes -o Sample.sdf</div>
73ae111cf86f Uploaded
deepakjadmin
parents:
diff changeset
244 <p>To retrieve MOL_ID data fileld from SD file and generate CSV text files containing
73ae111cf86f Uploaded
deepakjadmin
parents:
diff changeset
245 a column with structure data along with all data fields as a string with | as line
73ae111cf86f Uploaded
deepakjadmin
parents:
diff changeset
246 delimiter, type:</p>
73ae111cf86f Uploaded
deepakjadmin
parents:
diff changeset
247 <div class="ExampleBox">
73ae111cf86f Uploaded
deepakjadmin
parents:
diff changeset
248 % ExtractFromSDFiles.pl -m datafields -d &quot;Mol_ID&quot; --StrDataString Yes
73ae111cf86f Uploaded
deepakjadmin
parents:
diff changeset
249 --StrDataStringMode StrAndDataFields --StrDataStringDelimiter &quot;|&quot;
73ae111cf86f Uploaded
deepakjadmin
parents:
diff changeset
250 --output text -o Sample.sdf</div>
73ae111cf86f Uploaded
deepakjadmin
parents:
diff changeset
251 <p>To retrieve common data fields which exists for all the compounds in
73ae111cf86f Uploaded
deepakjadmin
parents:
diff changeset
252 a SD file and generate a TSV text file NewSample.tsv, type:</p>
73ae111cf86f Uploaded
deepakjadmin
parents:
diff changeset
253 <div class="ExampleBox">
73ae111cf86f Uploaded
deepakjadmin
parents:
diff changeset
254 % ExtractFromSDFiles.pl -m commondatafields --outdelim tab -r NewSample
73ae111cf86f Uploaded
deepakjadmin
parents:
diff changeset
255 --output Text -o Sample.sdf</div>
73ae111cf86f Uploaded
deepakjadmin
parents:
diff changeset
256 <p>To retrieve MolId, ExtReg, and CompoundName data field from a SD file and generate a
73ae111cf86f Uploaded
deepakjadmin
parents:
diff changeset
257 CSV text file NewSample.csv, type:</p>
73ae111cf86f Uploaded
deepakjadmin
parents:
diff changeset
258 <div class="ExampleBox">
73ae111cf86f Uploaded
deepakjadmin
parents:
diff changeset
259 % ExtractFromSDFiles.pl -m datafields -d &quot;Mol_ID,MolWeight,
73ae111cf86f Uploaded
deepakjadmin
parents:
diff changeset
260 CompoundName&quot; -r NewSample --output Text -o Sample.sdf</div>
73ae111cf86f Uploaded
deepakjadmin
parents:
diff changeset
261 <p>To retrieve compounds from a SD which meet a specific set of criteria - MolWt &lt;= 450,
73ae111cf86f Uploaded
deepakjadmin
parents:
diff changeset
262 LogP &lt;= 5 and SumNO &lt; 10 - from a SD file and generate a new SD file NewSample.sdf,
73ae111cf86f Uploaded
deepakjadmin
parents:
diff changeset
263 type:</p>
73ae111cf86f Uploaded
deepakjadmin
parents:
diff changeset
264 <div class="ExampleBox">
73ae111cf86f Uploaded
deepakjadmin
parents:
diff changeset
265 % ExtractFromSDFiles.pl -m datafieldsbyvalue -d &quot;MolWt,450,le,LogP
73ae111cf86f Uploaded
deepakjadmin
parents:
diff changeset
266 ,5,le,SumNO,10&quot; -r NewSample -o Sample.sdf</div>
73ae111cf86f Uploaded
deepakjadmin
parents:
diff changeset
267 <p>To retrive compounds from a SD file with a specific set of values for MolID and
73ae111cf86f Uploaded
deepakjadmin
parents:
diff changeset
268 generate a new SD file NewSample.sdf, type:</p>
73ae111cf86f Uploaded
deepakjadmin
parents:
diff changeset
269 <div class="ExampleBox">
73ae111cf86f Uploaded
deepakjadmin
parents:
diff changeset
270 % ExtractFromSDFiles.pl -m datafieldbylist -d &quot;Mol_ID,159,4509,4619&quot;
73ae111cf86f Uploaded
deepakjadmin
parents:
diff changeset
271 -r NewSample -o Sample.sdf</div>
73ae111cf86f Uploaded
deepakjadmin
parents:
diff changeset
272 <p>To retrive compounds from a SD file with values for MolID not on a list of specified
73ae111cf86f Uploaded
deepakjadmin
parents:
diff changeset
273 values and generate a new SD file NewSample.sdf, type:</p>
73ae111cf86f Uploaded
deepakjadmin
parents:
diff changeset
274 <div class="ExampleBox">
73ae111cf86f Uploaded
deepakjadmin
parents:
diff changeset
275 % ExtractFromSDFiles.pl -m datafieldnotbylist -d &quot;Mol_ID,159,4509,4619&quot;
73ae111cf86f Uploaded
deepakjadmin
parents:
diff changeset
276 -r NewSample -o Sample.sdf</div>
73ae111cf86f Uploaded
deepakjadmin
parents:
diff changeset
277 <p>To retrive 10 random compounds from a SD file and generate a new SD file RandomSample.sdf, type:</p>
73ae111cf86f Uploaded
deepakjadmin
parents:
diff changeset
278 <div class="ExampleBox">
73ae111cf86f Uploaded
deepakjadmin
parents:
diff changeset
279 % ExtractFromSDFiles.pl -m randomcmpds -n 10 -r RandomSample
73ae111cf86f Uploaded
deepakjadmin
parents:
diff changeset
280 -o Sample.sdf</div>
73ae111cf86f Uploaded
deepakjadmin
parents:
diff changeset
281 <p>To retrive compound record number 10 from a SD file and generate a new SD file NewSample.sdf, type:</p>
73ae111cf86f Uploaded
deepakjadmin
parents:
diff changeset
282 <div class="ExampleBox">
73ae111cf86f Uploaded
deepakjadmin
parents:
diff changeset
283 % ExtractFromSDFiles.pl -m recordnum --record 10 -r NewSample
73ae111cf86f Uploaded
deepakjadmin
parents:
diff changeset
284 -o Sample.sdf</div>
73ae111cf86f Uploaded
deepakjadmin
parents:
diff changeset
285 <p>To retrive compound record numbers 10, 20 and 30 from a SD file and generate a new SD file
73ae111cf86f Uploaded
deepakjadmin
parents:
diff changeset
286 NewSample.sdf, type:</p>
73ae111cf86f Uploaded
deepakjadmin
parents:
diff changeset
287 <div class="ExampleBox">
73ae111cf86f Uploaded
deepakjadmin
parents:
diff changeset
288 % ExtractFromSDFiles.pl -m recordnums --record 10,20,30 -r NewSample
73ae111cf86f Uploaded
deepakjadmin
parents:
diff changeset
289 -o Sample.sdf</div>
73ae111cf86f Uploaded
deepakjadmin
parents:
diff changeset
290 <p>To retrive compound records between 10 to 20 from SD file and generate a new SD
73ae111cf86f Uploaded
deepakjadmin
parents:
diff changeset
291 file NewSample.sdf, type:</p>
73ae111cf86f Uploaded
deepakjadmin
parents:
diff changeset
292 <div class="ExampleBox">
73ae111cf86f Uploaded
deepakjadmin
parents:
diff changeset
293 % ExtractFromSDFiles.pl -m recordrange --record 10,20 -r NewSample
73ae111cf86f Uploaded
deepakjadmin
parents:
diff changeset
294 -o Sample.sdf</div>
73ae111cf86f Uploaded
deepakjadmin
parents:
diff changeset
295 <p>
73ae111cf86f Uploaded
deepakjadmin
parents:
diff changeset
296 </p>
73ae111cf86f Uploaded
deepakjadmin
parents:
diff changeset
297 <h2>AUTHOR</h2>
73ae111cf86f Uploaded
deepakjadmin
parents:
diff changeset
298 <p><a href="mailto:msud@san.rr.com">Manish Sud</a></p>
73ae111cf86f Uploaded
deepakjadmin
parents:
diff changeset
299 <p>
73ae111cf86f Uploaded
deepakjadmin
parents:
diff changeset
300 </p>
73ae111cf86f Uploaded
deepakjadmin
parents:
diff changeset
301 <h2>SEE ALSO</h2>
73ae111cf86f Uploaded
deepakjadmin
parents:
diff changeset
302 <p><a href="./FilterSDFiles.html">FilterSDFiles.pl</a>,&nbsp<a href="./InfoSDFiles.html">InfoSDFiles.pl</a>,&nbsp<a href="./SplitSDFiles.html">SplitSDFiles.pl</a>,&nbsp<a href="./MergeTextFilesWithSD.html">MergeTextFilesWithSD.pl</a>
73ae111cf86f Uploaded
deepakjadmin
parents:
diff changeset
303 </p>
73ae111cf86f Uploaded
deepakjadmin
parents:
diff changeset
304 <p>
73ae111cf86f Uploaded
deepakjadmin
parents:
diff changeset
305 </p>
73ae111cf86f Uploaded
deepakjadmin
parents:
diff changeset
306 <h2>COPYRIGHT</h2>
73ae111cf86f Uploaded
deepakjadmin
parents:
diff changeset
307 <p>Copyright (C) 2015 Manish Sud. All rights reserved.</p>
73ae111cf86f Uploaded
deepakjadmin
parents:
diff changeset
308 <p>This file is part of MayaChemTools.</p>
73ae111cf86f Uploaded
deepakjadmin
parents:
diff changeset
309 <p>MayaChemTools is free software; you can redistribute it and/or modify it under
73ae111cf86f Uploaded
deepakjadmin
parents:
diff changeset
310 the terms of the GNU Lesser General Public License as published by the Free
73ae111cf86f Uploaded
deepakjadmin
parents:
diff changeset
311 Software Foundation; either version 3 of the License, or (at your option)
73ae111cf86f Uploaded
deepakjadmin
parents:
diff changeset
312 any later version.</p>
73ae111cf86f Uploaded
deepakjadmin
parents:
diff changeset
313 <p>&nbsp</p><p>&nbsp</p><div class="DocNav">
73ae111cf86f Uploaded
deepakjadmin
parents:
diff changeset
314 <table width="100%" border=0 cellpadding=0 cellspacing=2>
73ae111cf86f Uploaded
deepakjadmin
parents:
diff changeset
315 <tr align="left" valign="top"><td width="33%" align="left"><a href="./ExtractFromPDBFiles.html" title="ExtractFromPDBFiles.html">Previous</a>&nbsp;&nbsp;<a href="./index.html" title="Table of Contents">TOC</a>&nbsp;&nbsp;<a href="./ExtractFromSequenceFiles.html" title="ExtractFromSequenceFiles.html">Next</a></td><td width="34%" align="middle"><strong>March 29, 2015</strong></td><td width="33%" align="right"><strong>ExtractFromSDFiles.pl</strong></td></tr>
73ae111cf86f Uploaded
deepakjadmin
parents:
diff changeset
316 </table>
73ae111cf86f Uploaded
deepakjadmin
parents:
diff changeset
317 </div>
73ae111cf86f Uploaded
deepakjadmin
parents:
diff changeset
318 <br />
73ae111cf86f Uploaded
deepakjadmin
parents:
diff changeset
319 <center>
73ae111cf86f Uploaded
deepakjadmin
parents:
diff changeset
320 <img src="../../images/h2o2.png">
73ae111cf86f Uploaded
deepakjadmin
parents:
diff changeset
321 </center>
73ae111cf86f Uploaded
deepakjadmin
parents:
diff changeset
322 </body>
73ae111cf86f Uploaded
deepakjadmin
parents:
diff changeset
323 </html>