Annotations add information to structures: what a structure is, which residues form a domain or a binding site, or how residues are numbered in a standard scheme. Some are added by 3decision when a structure is registered. Others you add yourself, to keep your own knowledge next to the structures.
3decision has three kinds of annotations. They differ in what they describe: the whole structure, a protein sequence, or residues of one structure.
| Kind | Describes | Added by | Shown in |
|---|---|---|---|
| Structure annotations | The whole structure, as a label, a value and an optional URL. | You, with the API. 3decision adds only one: filename, the name of the file the structure was registered from. | Information Browser → Annotations |
| Sequence annotations | Residues or regions of a protein sequence. They apply to every structure of that protein. | 3decision, at registration of the UniProt sequence | Annotation Browser, linked to the 3D viewer |
| Structure residue annotations | Residues or regions of one structure. They apply only to that structure. | You, with the API. 3decision adds some for protein families. | Annotation Browser, linked to the 3D viewer |
A structure annotation has a label, a value and, optionally, a URL. For example, the label GDB ID with the value APP_1256. Use them to store information about the whole structure that 3decision doesn't know, such as its ID in an internal database.
Internal ID, the value also shows in the Structure Internal ID column of the search results and of the Workspace.To add or edit structure annotations, see Structure annotations in the API documentation.
Sequence annotations belong to a protein sequence, not to a structure. When a structure is registered, its chains are mapped to their sequences, and the annotations of those sequences become available on the structure. All structures of the same protein therefore show the same sequence annotations.
They come from:
For which annotations appear in each track, see Annotation tracks.
Structure residue annotations mark residues of one structure, for example the residues in contact with a ligand, oxidation sites, or an in-house numbering. They appear as User annotation tracks in the Annotation Browser, so you can select the residues in the 3D viewer.
To add them, see Structure residue annotations in the API documentation. For an example, see the tutorial Add antibody annotations.