1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83 84 85 86 87 88 89 90 91 92 93 94 95 96 97 98 99 100 101 102 103 104 105 106 107 108 109 110 111 112 113 114 115 116 117 118 119 120 121 122 123 124 125 126 127 128 129 130 131 132 133 134 135 136 137 138 139 140 141 142 143 144 145 146 147 148 149 150 151 152 153 154 155 156 157 158 159 160 161 162 163 164 165 166 167 168 169 170 171 172 173 174 175 176 177 178 179 180 181 182 183 184 185 186 187 188 189 190 191 192 193 194 195 196 197 198 199 200 201 202 203 204 205 206 207 208 209 210 211 212 213 214 215 216 217 218 219 220 221 222 223 224 225 226 227 228 229 230 231 232 233 234 235 236 237 238 239 240 241 242 243 244 245 246 247 248 249 250 251 252 253 254 255 256 257 258 259 260 261 262 263 264 265 266 267 268 269 270 271
|
#!/usr/bin/env python
#
# parse_pdb_header.py
# parses header of PDB files into a python dictionary.
# emerged from the Columba database project www.columba-db.de.
#
# author: Kristian Rother
#
# license: same as BioPython, read LICENSE.TXT from current BioPython release.
#
# last modified: 9.2.2004
#
# Added some small changes: the whole PDB file is not read in anymore, but just
# until the first ATOM record (faster). I also split parse_pdb_header into
# parse_pdb_header and parse_pdb_header_list, because parse_pdb_header_list
# can be more easily reused in PDBParser.
#
# Thomas, 19/03/04
#
# Renamed some clearly private functions to _something (ie. parse_pdb_header_list
# is now _parse_pdb_header_list)
# Thomas 9/05/04
"""Parse the header of a PDB file."""
from __future__ import print_function
import re
from Bio import File
def _get_journal(inl):
# JRNL AUTH L.CHEN,M.DOI,F.S.MATHEWS,A.Y.CHISTOSERDOV, 2BBK 7
journal = ""
for l in inl:
if re.search("\AJRNL", l):
journal += l[19:72].lower()
journal = re.sub("\s\s+", " ", journal)
return journal
def _get_references(inl):
# REMARK 1 REFERENCE 1 1CSE 11
# REMARK 1 AUTH W.BODE,E.PAPAMOKOS,D.MUSIL 1CSE 12
references = []
actref = ""
for l in inl:
if re.search("\AREMARK 1", l):
if re.search("\AREMARK 1 REFERENCE", l):
if actref != "":
actref = re.sub("\s\s+", " ", actref)
if actref != " ":
references.append(actref)
actref = ""
else:
actref += l[19:72].lower()
if actref != "":
actref = re.sub("\s\s+", " ", actref)
if actref != " ":
references.append(actref)
return references
# bring dates to format: 1909-01-08
def _format_date(pdb_date):
"""Converts dates from DD-Mon-YY to YYYY-MM-DD format."""
date = ""
year = int(pdb_date[7:])
if year < 50:
century = 2000
else:
century = 1900
date = str(century + year) + "-"
all_months = ['xxx', 'Jan', 'Feb', 'Mar', 'Apr', 'May', 'Jun', 'Jul',
'Aug', 'Sep', 'Oct', 'Nov', 'Dec']
month = str(all_months.index(pdb_date[3:6]))
if len(month) == 1:
month = '0' + month
date = date + month + '-' + pdb_date[:2]
return date
def _chop_end_codes(line):
"""Chops lines ending with ' 1CSA 14' and the like."""
return re.sub("\s\s\s\s+[\w]{4}.\s+\d*\Z", "", line)
def _chop_end_misc(line):
"""Chops lines ending with ' 14-JUL-97 1CSA' and the like."""
return re.sub("\s\s\s\s+.*\Z", "", line)
def _nice_case(line):
"""Makes A Lowercase String With Capitals."""
l = line.lower()
s = ""
i = 0
nextCap = 1
while i < len(l):
c = l[i]
if c >= 'a' and c <= 'z' and nextCap:
c = c.upper()
nextCap = 0
elif c == ' ' or c == '.' or c == ',' or c == ';' or c == ':' or c == '\t' or\
c == '-' or c == '_':
nextCap = 1
s += c
i += 1
return s
def parse_pdb_header(infile):
"""
Returns the header lines of a pdb file as a dictionary.
Dictionary keys are: head, deposition_date, release_date, structure_method,
resolution, structure_reference, journal_reference, author and
compound.
"""
header = []
with File.as_handle(infile, 'r') as f:
for l in f:
record_type = l[0:6]
if record_type in ("ATOM ", "HETATM", "MODEL "):
break
else:
header.append(l)
return _parse_pdb_header_list(header)
def _parse_pdb_header_list(header):
# database fields
dict = {'name': "",
'head': '',
'deposition_date': "1909-01-08",
'release_date': "1909-01-08",
'structure_method': "unknown",
'resolution': 0.0,
'structure_reference': "unknown",
'journal_reference': "unknown",
'author': "",
'compound': {'1': {'misc': ''}}, 'source': {'1': {'misc': ''}}}
dict['structure_reference'] = _get_references(header)
dict['journal_reference'] = _get_journal(header)
comp_molid = "1"
src_molid = "1"
last_comp_key = "misc"
last_src_key = "misc"
for hh in header:
h = re.sub("[\s\n\r]*\Z", "", hh) # chop linebreaks off
# key=re.sub("\s.+\s*","",h)
key = h[:6].strip()
# tail=re.sub("\A\w+\s+\d*\s*","",h)
tail = h[10:].strip()
# print("%s:%s" % (key, tail)
# From here, all the keys from the header are being parsed
if key == "TITLE":
name = _chop_end_codes(tail).lower()
if 'name' in dict:
dict['name'] += " " + name
else:
dict['name'] = name
elif key == "HEADER":
rr = re.search("\d\d-\w\w\w-\d\d", tail)
if rr is not None:
dict['deposition_date'] = _format_date(_nice_case(rr.group()))
head = _chop_end_misc(tail).lower()
dict['head'] = head
elif key == "COMPND":
tt = re.sub("\;\s*\Z", "", _chop_end_codes(tail)).lower()
# look for E.C. numbers in COMPND lines
rec = re.search('\d+\.\d+\.\d+\.\d+', tt)
if rec:
dict['compound'][comp_molid]['ec_number'] = rec.group()
tt = re.sub("\((e\.c\.)*\d+\.\d+\.\d+\.\d+\)", "", tt)
tok = tt.split(":")
if len(tok) >= 2:
ckey = tok[0]
cval = re.sub("\A\s*", "", tok[1])
if ckey == 'mol_id':
dict['compound'][cval] = {'misc': ''}
comp_molid = cval
last_comp_key = "misc"
else:
dict['compound'][comp_molid][ckey] = cval
last_comp_key = ckey
else:
dict['compound'][comp_molid][last_comp_key] += tok[0] + " "
elif key == "SOURCE":
tt = re.sub("\;\s*\Z", "", _chop_end_codes(tail)).lower()
tok = tt.split(":")
# print(tok)
if len(tok) >= 2:
ckey = tok[0]
cval = re.sub("\A\s*", "", tok[1])
if ckey == 'mol_id':
dict['source'][cval] = {'misc': ''}
comp_molid = cval
last_src_key = "misc"
else:
dict['source'][comp_molid][ckey] = cval
last_src_key = ckey
else:
dict['source'][comp_molid][last_src_key] += tok[0] + " "
elif key == "KEYWDS":
kwd = _chop_end_codes(tail).lower()
if 'keywords' in dict:
dict['keywords'] += " " + kwd
else:
dict['keywords'] = kwd
elif key == "EXPDTA":
expd = _chop_end_codes(tail)
# chop junk at end of lines for some structures
expd = re.sub('\s\s\s\s\s\s\s.*\Z', '', expd)
# if re.search('\Anmr',expd,re.IGNORECASE): expd='nmr'
# if re.search('x-ray diffraction',expd,re.IGNORECASE): expd='x-ray diffraction'
dict['structure_method'] = expd.lower()
elif key == "CAVEAT":
# make Annotation entries out of these!!!
pass
elif key == "REVDAT":
rr = re.search("\d\d-\w\w\w-\d\d", tail)
if rr is not None:
dict['release_date'] = _format_date(_nice_case(rr.group()))
elif key == "JRNL":
# print("%s:%s" % (key, tail))
if 'journal' in dict:
dict['journal'] += tail
else:
dict['journal'] = tail
elif key == "AUTHOR":
auth = _nice_case(_chop_end_codes(tail))
if 'author' in dict:
dict['author'] += auth
else:
dict['author'] = auth
elif key == "REMARK":
if re.search("REMARK 2 RESOLUTION.", hh):
r = _chop_end_codes(re.sub("REMARK 2 RESOLUTION.", '', hh))
r = re.sub("\s+ANGSTROM.*", "", r)
try:
dict['resolution'] = float(r)
except:
# print('nonstandard resolution %r' % r)
dict['resolution'] = None
else:
# print(key)
pass
if dict['structure_method'] == 'unknown':
if dict['resolution'] > 0.0:
dict['structure_method'] = 'x-ray diffraction'
return dict
if __name__ == '__main__':
# Reads a PDB file passed as argument, parses its header, extracts
# some data and returns it as a dictionary.
import sys
filename = sys.argv[1]
with open(filename, 'r') as handle:
data_dict = parse_pdb_header(handle)
# print the dictionary
for k, y in data_dict.items():
print("-" * 40)
print(k)
print(y)
|