searchDomainArchitectures

Search for the domain architectures that match a given domain organisation, i.e. find the architectures, and how many proteins have them, that are built from a set of domains you specify. This is the inverse of getDomainArchitectures: instead of the architectures a single entry occurs in, you give two or more domain accessions and get every architecture containing them.

Arguments

Name

Type

Required

Description

domains

string

yes

Two or more domain accessions, Pfam (PFxxxxx) and/or InterPro (IPRxxxxxx), separated by commas or dashes, e.g. PF00051,PF00089 or IPR000001-IPR001254. When ordered is true they are read in N→C order.

ordered

boolean

no

Require the domains to occur in the given N→C order. Default false (any order).

exact

boolean

no

Match only architectures containing exactly these domains and no others. Default false (additional domains allowed).

pageSize

integer

no

Architectures per page. Default 20, max 100.

Returns

A JSON object echoing the query and listing the matching architectures:

{
  "query": "PF00051,PF00089",
  "ordered": true,
  "exact": true,
  "count": 1,
  "architectures": [
    {
      "ida": "PF00051:IPR000001-PF00089:IPR001254",
      "ida_id": "…",
      "unique_proteins": 1234,
      "representative": {
        "accession": "P00747",
        "length": 810,
        "domains": [ { "accession": "PF00051", "name": "Kringle" }, { "accession": "PF00089", "name": "Trypsin" } ]
      }
    }
  ]
}

count is the number of matching architectures (not proteins); unique_proteins is how many proteins share each one. A next cursor URL is included when more pages exist.

Note

A single very common domain matches a huge number of proteins and can time out server-side. This tool is meant for combinations of domains. To list the architectures one entry occurs in, use getDomainArchitectures instead.

Examples

  • domains="PF00051,PF00089": every architecture containing both the Kringle and Trypsin domains, in any order.

  • domains="PF00051,PF00089", ordered=true: only those where Kringle precedes Trypsin (N→C).

  • domains="PF00051,PF00089", ordered=true, exact=true: the single architecture that is exactly Kringle→Trypsin and nothing else.

  • domains="IPR000001-IPR001254": the same query written with InterPro accessions and a dash.