{"_id":"5739b2e2d5b6db0e00729d50","__v":7,"parentDoc":null,"project":"5735936aafab441700723a50","user":"573592b84b0ab120000b7d44","version":{"_id":"5735936aafab441700723a53","__v":12,"project":"5735936aafab441700723a50","createdAt":"2016-05-13T08:42:18.615Z","releaseDate":"2016-05-13T08:42:18.615Z","categories":["5735936aafab441700723a54","5735a32931a73b1700887c94","5735b55beceb872200abbc6c","5735b56eb667601700d3bd6f","5735b9ba4b0ab120000b7dd4","5735b9c94b0ab120000b7dd5","5735cb131f16241700c8a0f7","5735e5c4e4824c3400aa1f21","5735e5d9e4824c3400aa1f23","5735e5f2ec67f6290013ac72","573ecfe0804f901700a9dfc7","573f276c7eeb8b190094ca7d"],"is_deprecated":false,"is_hidden":false,"is_beta":false,"is_stable":false,"codename":"","version_clean":"1.0.0","version":"1.0"},"category":{"_id":"5735e5d9e4824c3400aa1f23","__v":0,"version":"5735936aafab441700723a53","project":"5735936aafab441700723a50","sync":{"url":"","isSync":false},"reference":false,"createdAt":"2016-05-13T14:34:01.858Z","from_sync":false,"order":9,"slug":"configuration-options-core-import","title":"Configuration Options (Core Import)"},"updates":[],"next":{"pages":[],"description":""},"createdAt":"2016-05-16T11:45:38.331Z","link_external":false,"link_url":"","githubsync":"","sync_unique":"","hidden":false,"api":{"results":{"codes":[]},"settings":"","auth":"required","params":[],"url":""},"isReference":false,"order":8,"body":"```\n[GENE_DESCRIPTIONS]\n  GFF = [ 1 DAUGHTER->product /(.+)/ ]\n[TRANSCRIPT_DESCRIPTIONS]\n  GFF = [ 1 SELF->product /(.+)/ ]\n```\nDescriptions are displayed in the Ensembl website and included in the search index (optional [Step 2.8](doc:step-28-generate-search-index)).  Each set of descriptions may be sourced from any number of files, in which case the first number in the value array indicates the priority accorded to descriptions from that source.  Descriptions from sources with lower numbers will overwrite those from sources with higher numbers.  If set to 1 this priority flag will also cause any existing descriptions in the database for the current gene/transcript to be overwritten.\n\n``_DESCRIPTIONS`` from files other than ``.gff`` must be linked to the correct feature by [[_STABLE_IDS]](doc:stable-ids-core) (where linking files by ``_STABLE_IDS`` is described in more detail):\n\n```\n[FILES]\n  GFF = [ gff http://example.com/gene_models.gff3.gz ]\n  PROTEIN = [ fa http://example.com/proteins.fa.gz ]\n  ANNOTATION = [ tsv http://example.com/annotations.txt.gz ]\n[GENE_STABLE_IDS]\n  GFF = [ gene->Name /(.+)/ ]\n  PROTEIN = [ DISPLAY_ID /(.+)-PA/ ]  \n  ANNOTATION = [ FIELD_1 /(.+)/ ]\n[GENE_DESCRIPTIONS]\n  GFF = [ 1 DAUGHTER->product /(.+)/ ]\n  PROTEIN = [ 2 DESCRIPTION /(.+)/ ]  \n  ANNOTATION = [ 3 FIELD_2 /(.+)/ ]  \n\n```\n\n- the ``ANNOTATION`` file has the lowest priority (``3``) and descriptions from ``FIELD_2`` in this file will only be used if no corresponding description is found in either of the other files\n- the ``PROTEIN`` file has priority ``2`` so descriptions from the second part of the ``fasta`` headers will be used in preference to descriptions in the ``ANNOTATION`` file unless a description exists in the ``GFF`` file\n- the ``GFF `` file has priority ``1`` so descriptions from this file will be used in preference to those from the other files and if a description already exists for this gene in the database, it will be overwritten by this new value.\n- reducing all the priorities by 1 would retain the same behaviour with the exception that existing descriptions in the database would not be overwritten.","excerpt":"","slug":"_descriptions-core","type":"basic","title":"[_DESCRIPTIONS]"}
``` [GENE_DESCRIPTIONS] GFF = [ 1 DAUGHTER->product /(.+)/ ] [TRANSCRIPT_DESCRIPTIONS] GFF = [ 1 SELF->product /(.+)/ ] ``` Descriptions are displayed in the Ensembl website and included in the search index (optional [Step 2.8](doc:step-28-generate-search-index)). Each set of descriptions may be sourced from any number of files, in which case the first number in the value array indicates the priority accorded to descriptions from that source. Descriptions from sources with lower numbers will overwrite those from sources with higher numbers. If set to 1 this priority flag will also cause any existing descriptions in the database for the current gene/transcript to be overwritten. ``_DESCRIPTIONS`` from files other than ``.gff`` must be linked to the correct feature by [[_STABLE_IDS]](doc:stable-ids-core) (where linking files by ``_STABLE_IDS`` is described in more detail): ``` [FILES] GFF = [ gff http://example.com/gene_models.gff3.gz ] PROTEIN = [ fa http://example.com/proteins.fa.gz ] ANNOTATION = [ tsv http://example.com/annotations.txt.gz ] [GENE_STABLE_IDS] GFF = [ gene->Name /(.+)/ ] PROTEIN = [ DISPLAY_ID /(.+)-PA/ ] ANNOTATION = [ FIELD_1 /(.+)/ ] [GENE_DESCRIPTIONS] GFF = [ 1 DAUGHTER->product /(.+)/ ] PROTEIN = [ 2 DESCRIPTION /(.+)/ ] ANNOTATION = [ 3 FIELD_2 /(.+)/ ] ``` - the ``ANNOTATION`` file has the lowest priority (``3``) and descriptions from ``FIELD_2`` in this file will only be used if no corresponding description is found in either of the other files - the ``PROTEIN`` file has priority ``2`` so descriptions from the second part of the ``fasta`` headers will be used in preference to descriptions in the ``ANNOTATION`` file unless a description exists in the ``GFF`` file - the ``GFF `` file has priority ``1`` so descriptions from this file will be used in preference to those from the other files and if a description already exists for this gene in the database, it will be overwritten by this new value. - reducing all the priorities by 1 would retain the same behaviour with the exception that existing descriptions in the database would not be overwritten.