The EMBOSS index method is preferred over the older EMBLCD method. It allows for non-unique index terms e.g. non-unique IDs. It can also cope with files over 2Gb in size.

This method uses B+-tree indexes from the programs dbxflat (flatfiles - database native format files) or dbxfasta (FASTA format files). This can cope with all levels of access. Queries use the index files. Reading all entries uses the list of files in the [database].ent file and opens each in turn.

Supports queries by

(Not by key and org if the database was indexed by dbxfasta as these cannot be found in the FASTA format description line.)

The directory containing the sequence files and indexes to be read must be specified using the directory: attribute. If the indexes are in a directory other than the one containing the sequence files, then the index directory can be explicitly set using the indexdirectory: attribute.

The available fields should be specified using the fields: attribute if more than just the default ID name and Accession number fields have been indexed. As these indexes allow non-unique IDs then each of the fields may return a list of matches i.e. type query is used throughout.

For example:

DB mydb [
  type: N
  method: emboss
  format: embl
  fields: "sv des org key"
  directory: /data/embl
]

The EMBOSS B+-tree index files include the filenames indexed by dbxflat or dbxfasta. You can use the file: and exclude: attributes to create file-specific subsets from a single index.

Uses an EMBLCD index from the programs dbiflat (flatfiles - database native format files) or dbifasta (FASTA format files). This can cope with all levels of access. Queries use the index files. Reading all entries uses the list of files in the division.lkp file and opens each in turn.

Supports queries by

(Not by key and org if the database was indexed by dbifasta because there is no way to find these in the FASTA format description line.)

The directory containing the sequence files and indices to be read must be specified using the directory: attribute. If the indices are in a directory other than the one containing the sequence files, then the index directory can be explicitly set using the indexdirectory: attribute.

The available fields should be specified using the fields: attribute if more than just the default ID name and Accession number fields have been indexed. A wildcard search for unique fields (id or sv), or any search for acc, des, org or key is of type query and returns a list of entries. A search for a single id or sv is of type entry and will find the first match in the index and assume no other matches. The ID has to be unique in an EMBLCD database.

For example:

DB mydb [
  type: N
  method: emblcd
  format: embl
  fields: "sv des org key"
  directory: /data/embl
]

The EMBLCD index files include the filenames indexed by dbiflat or dbifasta. You can use the file: and exclude: attributes to create file-specific subsets from a single index. Use of the indexdir: attribute is common, allowing index files to be in a different directory from the source flat files.

This requires a local installation of SRS. This calls getz locally, using the -e switch to return whole entries in the original format. It is expected that getz is in the path.

Supports queries by

If the SRS server has a different name for this database than that specified as the DBNAME, then you must specify it using the dbalias: attribute.

EMBOSS expects the SRS local access program to be called getz, but you can explicitly override this using the app: attribute. This can be used to call getz using its explicit path, rather than relying on getz being in the path.

Database definitions using method: srs should also specify methodall: direct plus directory: and file: for reading all entries directly. This is much faster than using getz to read and format all entries (unless the database is very small).

For example:

DB mydb [
  type: N
  format: embl
  method: srs
  dbalias: embl
  fields: "sv des org key"

# define 'all' access method
  methodall: direct
  directory: /data/embl
  file: *.seq   
]

As SRS returns the results using getz -e; the format should match the format of the original data. For some formats this might be problematic (PIR for example). In that case you can consider using SRSFASTA although this will lose information that is not included in the FASTA format SRS output.

As for SRS, but uses:

to read the sequence in FASTA format. It is used for databases like dbEST.reports where EMBOSS does not understand the entry format but SRS can convert it to FASTA. As the database format is not understood by EMBOSS, a search of the entire database would be forced to use getz to convert each entry, which would be slow.

Supports queries by

If the SRS server has a different name for this database from that specified as the DBNAME, then you must specify it using the dbalias: attribute.

EMBOSS expects the SRS local access program to be called getz, but you can explicitly override this using the app: attribute. This can be used to call getz using its explicit path, rather than relying on getz being in the path.

Database definitions need to specify methodall: direct plus directory: and file: to read all entries directly. This is much faster than using getz to read and format all entries.

For example:

DB mydb [
  type: N
  format: fasta
  method: srsfasta
  dbalias: embl
  fields: "sv des org key"

# define 'all' access method
  methodall: direct
  directory: /data/embl
  file: *.seq 
]

Uses a defined SRS WWW server to read a single entry. This can be useful, for example, to get the GenBank version of an EMBL entry. Wildcard entry names are not recommended because SRS servers are not intended to return large numbers of entries.

Supports queries by

If the SRS server has a different name for this database from that specified as the DBNAME, then you must specify it using the dbalias: attribute.

The remote SRS web server must be specified using the url: attribute.

Database definitions should define this as methodentry or methodquery to avoid returning the entire database. Failure to do so could lead to a request to return the entire database. Although an SRS web server can cope with this, EMBOSS would then have to keep the entire web page in memory before stripping out HTML tags in order to read the first entry.

For example:

DB mydb [
  type:        "N"
  format:      "embl"
  methodquery: "srswww"
  dbalias:     "embl"
  fields:      "sv des org key"
  url:         "http://srs.redbrick.ac.uk/srsbin/cgi-bin/wgetz"

# define 'all' access method
  methodall: "direct"
  directory: "/data/embl"
  file:      "*.seq" 
]

Various database definitions for remote retrieval of sequences over the web via SRS are shown below:

DB embl [  
type:    "N" 
method:  "srswww" 
format:  "embl" 
release: "EBI"
url:     "http://srs.ebi.ac.uk/srsbin/cgi-bin/wgetz"
comment: "EMBL from the EBI" ]

DB em [  
type:    "N" 
method:  "srswww" 
format:  "embl" 
release: "EBI"
url:     "http://srs.ebi.ac.uk/srsbin/cgi-bin/wgetz"
dbalias: "EMBL"
comment: "EMBL from the EBI" ]

DB uniprot [  
type:    "P" 
method:  "srswww" 
format:  "swiss" 
release: "EBI"
url:     "http://srs.ebi.ac.uk/srsbin/cgi-bin/wgetz"
comment: "UNIPROT from the EBI" ]

DB uni [  
type:    "P" 
method:  "srswww" 
format:  "swiss"
release: "EBI"
url:     "http://srs.ebi.ac.uk/srsbin/cgi-bin/wgetz"
dbalias: "UNIPROT"
comment: "UNIPROT from the EBI" ]

Uses an EMBLCD index from the program dbiblast to access databases in BLAST format. The BLAST database can be DNA or protein, produced by formatdb, pressdb or setdb, with or without the original FASTA format file. This can cope with all levels of access. Queries use the index files, reading all entries uses the list of files in the division.lkp file and opens each in turn.

Supports queries by

(Not by key and org as there is no way to find these in the BLAST database description line).

The directory containing the BLAST index files (*.nin, *.pin, *.nhr, *.nsq, *.phr, pin, psq, etc,) and the index files produced by dbiblast must be specified using the directory: attribute. If the dbiblast indices are in a directory other than the one containing the BLAST index files, then the dbiblast index directory can be explicitly set using the indexdirectory: attribute. The available fields should be specified using the fields: attribute if more than just the default ID name and Accession number fields have been indexed.

A wildcard search for unique fields (id or sv), or any search for acc, des, org or key is type 'query' and returns a list of entries. A search for a single id or sv is of type 'entry' and will find the first match in the index and assume no other matches. The ID has to be unique in an EMBLCD database.

For example:

DB mydb [
  type: N
  format: embl
  method: blast
  fields: "sv des"
  directory: /data/embl
]

Uses a B+-tree index from the program dbxgcg to access a database reformatted for GCG 8, 9 or 10 by GCG programs such as embltogcg. As only the .ref and .seq files are used, any "GCG" distribution of the databases can be used with dbxgcg without the need to create GCG-specific index files. This can cope with all levels of access. Queries use the index files. Reading all entries uses the list of files in the [database].ent index files and open each in turn.

Supports queries by

The directory containing the sequence files and indexes to be read must be specified using the directory: attribute. If the indexes are in a directory other than the one containing the sequence files, then the index directory can be explicitly set using the indexdirectory: attribute. The available fields should be specified using the fields: attribute if more than just the default ID name and Accession number fields have been indexed.

As the B+-tree indexes allow duplicate keys then all queries may return a list of entries i.e. type query is used throughout.

For example:

DB mydb [
  type:      "N"
  format:    "embl"
  method:    "embossgcg"
  fields:    "sv des org key"
  directory: "/data/gcg/gcgembl"
]

You can use the file: and exclude: attributes to create file-specific subsets from a single index.

Uses an EMBLCD index from the program dbigcg to access a database reformatted for GCG 8, 9 or 10 by GCG programs such as embltogcg. As only the .ref and .seq files are used, any "GCG" distribution of the databases can be used with dbigcg without the need to create GCG-specific index files. This can cope with all levels of access. Queries use the index files. Reading all entries uses the list of files in the division.lkp index files and open each in turn.

Supports queries by

The directory containing the sequence files and indices to be read must be specified using the directory: attribute. If the indices are in a directory other than the one containing the sequence files, then the index directory can be explicitly set using the indexdirectory: attribute. The available fields should be specified using the fields: attribute if more than just the default ID name and Accession number fields have been indexed.

A wildcard search for unique fields (id or sv), or any search for acc, des, org or key is type query and returns a list of entries. A search for a single id or sv is of type entry and will find the first match in the index and assume no other matches. The ID has to be unique in an EMBLCD database.

For example:

DB mydb [
  type:      "N"
  format:    "embl"
  method:    "gcg"
  fields:    "sv des org key"
  directory: "/data/gcg/gcgembl"
]

You can use the file: and exclude: attributes to create file-specific subsets from a single index.

Opens database flat file(s) and returns each entry sequentially.

This method assumes there is no indexing done on the data, so it can only process all entries - you should explicitly set up other methods for entry and query access to the same database if these are required. It is possible to access a database with the direct: method and an ID or field in the USA, but EMBOSS will read the entire database to look for matching entries if no other method is specified.

The directory containing the sequence files to be read must be specified using the directory: attribute. The files to be read must be specified using the file: attribute. You may use the exclude: attribute to exclude some selected files from consideration.

EMBL can be defined as *.dat to avoid adding the explicit filenames e.g. est18, hum3, htg2.

If the file format supports additional fields, they can be included in the definition as fields: to allow their use in USAs.

For example:

DB mydb [
  type: N
  format: embl
  methodall: direct
  directory: /data/embl
  file: *.dat
]

Uses any other Web server (for example the EBI's emblfetch or swissfetch queries) to return an entry.

The remote web server's URL must be specified using the url: attribute. This URL is expected to contain one or more instances of the character pair '%s' - each of these pairs are replaced by the value of the ID name when this database is accessed. Any HTML formatting will be stripped from the resulting web page. For example:

DB mydb [
  type: N
  format: embl
  methodentry: url
  url: "http://server.commercial.com/cgi-bin/getseq?%s&format=embl"
]

Run an external application or a simple script which returns one/more/all entries. The application can be in the user's path or have an explicit path provided. EXTERNAL is the same thing as APP, but it is obsolete and its use is discouraged.

The database definition must have app: defined to specify the application command.

The database and entry name will be appended to the application command as

Both ID and Accession number can be used to specify the entry. Alternatively, if the app: attribute value contains the character pair '%s', it is replaced by the value of the ID name or Accession number when this database is accessed. You can also use GCG's typedata as an external application, to save reindexing a GCG database.

This could be a good way to search a set of databases, for example to get the first entry from SwissNew, SwissProt, TrEmbl and TrEmblNew with the ID, accession number or PID as the entryname.

For example:

DB mydb [
  type:   "N"
  format: "embl"
  method: "app"
  app:    "/usr/local/bin/accessdb -db embl -query %s"
]