|
1
|
1 NAME
|
|
|
2 InfoPDBFiles.pl - List information about PDB files
|
|
|
3
|
|
|
4 SYNOPSIS
|
|
|
5 InfoPDBFiles.pl PDBFile(s) PDB(s)...
|
|
|
6
|
|
|
7 InfoPDBFiles.pl [-a, --all] [-b, --BoundingBox] [-c, --count
|
|
|
8 "RecordType, [RecordType,...]" | All] [--chains] [-d, --detail
|
|
|
9 infolevel] [-e, --experiment] [-f, --frequency] [-h, --help] [--header]
|
|
|
10 [m, --MasterCheck] [--residues] [--ResiduesMode InChains | All | Both]
|
|
|
11 [--ResidueNumbers] [-w, --WorkingDir dirname] PDBFile(s)...
|
|
|
12
|
|
|
13 DESCRIPTION
|
|
|
14 List information about contents of *PDBFile(s)*: number of each record
|
|
|
15 type, number of chains, count and percent distribution of residues in
|
|
|
16 each chain, bounding box and so on. Multiple PDBFile names are separated
|
|
|
17 by spaces. The valid file extension is *.pdb*. All other file name
|
|
|
18 extensions are ignored during the wild card expansion. All the PDB files
|
|
|
19 in a current directory can be specified either by **.pdb* or the current
|
|
|
20 directory name.
|
|
|
21
|
|
|
22 In PDB files containing data for multiple models, all ATOM/HETAM records
|
|
|
23 for chains after the first model are ignored.
|
|
|
24
|
|
|
25 OPTIONS
|
|
|
26 -a, --all
|
|
|
27 List all the available information.
|
|
|
28
|
|
|
29 -b, --BoundingBox
|
|
|
30 List min/max XYZ coordiates of ATOM/HETATM records.
|
|
|
31
|
|
|
32 -c, --count *RecordType,[RecordType,...]|All*
|
|
|
33 Types of PDB records to count in *PDBFile(s)*. You can specify a
|
|
|
34 list of any valid PDB record type or count all record types found in
|
|
|
35 the files. Possible values: Comma delimited list of valid
|
|
|
36 *RecordTypes* or *All*. Default: *ATOM,HETATM*. And this is also
|
|
|
37 default behavior.
|
|
|
38
|
|
|
39 The list of valid PDB record types includes: *HEADER, OBSLTE, TITLE,
|
|
|
40 CAVEAT, COMPND, SOURCE, KEYWDS, EXPDTA, AUTHOR, REVDAT, SPRSDE, JRN,
|
|
|
41 REMARK, DBRE, SEQADV, SEQRES, MODRES, HET, HETNAM, HETSYN, FORMUL,
|
|
|
42 HELIX, SHEET, TURN, SSBOND, LINK, HYDBND, SLTBRG, CISPEP, SITE,
|
|
|
43 CRYST1, ORIGX1, ORIGX2, ORIGX3, SCALE1, SCALE2, SCALE3, MTRIX1
|
|
|
44 MTRIX2 MTRIX3, TVECT, MODEL, ATOM, SIGATM, ANISOU, SIGUIJ, TER,
|
|
|
45 HETATM, ENDMDL, CONECT, MASTER, END*.
|
|
|
46
|
|
|
47 --chains
|
|
|
48 Count number of chains.
|
|
|
49
|
|
|
50 -d, --detail *infolevel*
|
|
|
51 Level of information to print about PDB during various options.
|
|
|
52 Default: *1*. Possible values: *1, 2 or 3*.
|
|
|
53
|
|
|
54 -e, --experiment
|
|
|
55 List experimental technique information along with any applicable
|
|
|
56 resolution.
|
|
|
57
|
|
|
58 -f, --frequency
|
|
|
59 List distribution of residues: report count and percent of residues
|
|
|
60 in individual chains and across all the chains, or for all the
|
|
|
61 residues in the file. The value of option --residuesmode determines
|
|
|
62 how residues are counted and what is listed. The list is sorted by
|
|
|
63 frequency in descending order. By default, only residue count values
|
|
|
64 are reported. To list percent distribution of residues, specify -d,
|
|
|
65 --detail value of *2* or higher.
|
|
|
66
|
|
|
67 -h, --help
|
|
|
68 Print this help message.
|
|
|
69
|
|
|
70 --header
|
|
|
71 List header information.
|
|
|
72
|
|
|
73 m, --MasterCheck
|
|
|
74 Check master record by explicitly counting the number of REMARK,
|
|
|
75 HET, HELIX, SHEET, TURN, SITE, ORIGX, SCALE, MTRIX, ATOM, HETATM,
|
|
|
76 TER, CONECT and SEQRES records and comparing their values against
|
|
|
77 contents of master record.
|
|
|
78
|
|
|
79 --residues
|
|
|
80 Count residues in *PDBFile(s)*. This is also default behavior.
|
|
|
81
|
|
|
82 By default, only residue count values are reported. To list percent
|
|
|
83 distribution of residues, specify -d, --detail value of *2* or
|
|
|
84 higher.
|
|
|
85
|
|
|
86 --ResiduesMode <InChains | All | Both>
|
|
|
87 Specify how to count residues in *PDBFile(s)*: Count residue in each
|
|
|
88 chain and across all the chains, list count iof all the residues in
|
|
|
89 the file, or list both. Possible values: *InChains, All, or Both*.
|
|
|
90 Default: *Both*.
|
|
|
91
|
|
|
92 --ResidueNumbers
|
|
|
93 List information about ATOM residue numbers in each chain before TER
|
|
|
94 record: start and end residue number; gaps in residue numbers
|
|
|
95 corresponding to non-sequential residue numbers; residue numbers not
|
|
|
96 in ascending order.
|
|
|
97
|
|
|
98 -w, --WorkingDir *dirname*
|
|
|
99 Location of working directory. Default: current directory.
|
|
|
100
|
|
|
101 EXAMPLES
|
|
|
102 To list total number of records and number of chain(s) residues in PDB
|
|
|
103 files, type:
|
|
|
104
|
|
|
105 % InfoPDBFiles.pl Sample1.pdb
|
|
|
106 % InfoPDBFiles.pl Sample2.pdb
|
|
|
107
|
|
|
108 To list all available information for PDB file Sample2.pdb, type:
|
|
|
109
|
|
|
110 % InfoPDBFiles.pl -a Sample2.pdb
|
|
|
111
|
|
|
112 To list all available information for PDB file Sample2.pdb with all
|
|
|
113 available details, type:
|
|
|
114
|
|
|
115 % InfoPDBFiles.pl -a -d Sample2.pdb
|
|
|
116
|
|
|
117 To count ATOM and HETATM records in Sample2.pdb file, type:
|
|
|
118
|
|
|
119 % InfoPDBFiles.pl -c "ATOM,HETATM" Sample2.pdb
|
|
|
120
|
|
|
121 To list distribution of residues in chains across the whole PDB file
|
|
|
122 Sample2.pdb along with percent distribution, type
|
|
|
123
|
|
|
124 % InfoPDBFiles.pl --frequency -d 2 Sample2.pdb
|
|
|
125
|
|
|
126 To list distribution of residues only across chains in PDB file
|
|
|
127 Sample2.pdb along with percent distribution, type
|
|
|
128
|
|
|
129 % InfoPDBFiles.pl --frequency -d 2 --ResiduesMode InChains Sample2.pdb
|
|
|
130
|
|
|
131 To list min/max coordinates of the bounding box which encompasses the
|
|
|
132 structure in Sample1.pdb file, type:
|
|
|
133
|
|
|
134 % InfoPDBFiles.pl -b Sample1.pdb
|
|
|
135
|
|
|
136 AUTHOR
|
|
|
137 Manish Sud <msud@san.rr.com>
|
|
|
138
|
|
|
139 SEE ALSO
|
|
|
140 ExtractFromPDBFiles.pl, InfoAminoAcids.pl, InfoNucleicAcids.pl,
|
|
|
141 InfoSequenceFiles.pl, ModifyPDBFiles.pl
|
|
|
142
|
|
|
143 COPYRIGHT
|
|
|
144 Copyright (C) 2015 Manish Sud. All rights reserved.
|
|
|
145
|
|
|
146 This file is part of MayaChemTools.
|
|
|
147
|
|
|
148 MayaChemTools is free software; you can redistribute it and/or modify it
|
|
|
149 under the terms of the GNU Lesser General Public License as published by
|
|
|
150 the Free Software Foundation; either version 3 of the License, or (at
|
|
|
151 your option) any later version.
|
|
|
152
|
