sequence_db.read() -- read a database of sequences

chains_list = <str:1>	'$(LIB)/CHAINS_3.0_40_XN.cod'	file with sequences
seq_database_file = <str:1>	'$(LIB)/CHAINS_all.seq'	file with a list of sequence codes
seq_database_format = <str:1>	'PIR'	'PIR' 'FASTA' 'BINARY'; for READ/WRITE_SEQUENCE_DB
clean_sequences = <bool:1>	True	whether or not clean non-standard residues
minmax_db_seq_len = <int:2>	0 999999	minimal/maximal database sequence length

Description:

This command will read a database of sequences, either in the PIR, FASTA, or BINARY format.

If the format is PIR or FASTA:

• It is possible to clean all sequences of non-standard residue types by setting clean_sequences to True.

• Sequences shorter than minmax_db_seq_len[1] and longer than minmax_db_seq_len[2] are eliminated.

• Only sequences whose codes are listed in the chains_list file are read from the seq_database_file of sequences. If chains_list is all, all sequences in the seq_database_file file are read in, and there is no need for the chains_list file.

For the PIR and FASTA formats, make sure the order of sequences in the chains_list and seq_database_file is the same for faster access (there can of course be more sequences in the sequence file than there are sequence codes in the codes file).

Additionally, if the sequences are in 'PIR' format, then the protein type and resolution fields are stored in the database format. (see Section 4.9.1 for description of 'PIR' fields).

The protein type field is encoded in a single letter format. 'S' for sequence and 'X' for structures of any kind. This information is transferred to the profile arrays when using profile.build(). (See also profile.read()).

The resolution field is used to pick representatives from the clusters in sequence_db.filter().

None of the options above apply to the BINARY format, which, in return, is very fast (i.e., 3 seconds for 300 MB of 800,000 sequences in the TrEMBL database).

Example: See profile.build() command.