emblread - Read data from EMBL file

Syntax

EMBLData = emblread(File) EMBLSeq = emblread (File, 'SequenceOnly', SequenceOnlyValue)

Arguments

File

Either of the following:

String specifying a file name, a path and file name, or a URL pointing to a file. The referenced file is an EMBL-formatted file.
MATLAB character array that contains the text of an EMBL-formatted file

SequenceOnlyValue Controls the reading of only the sequence without the metadata. Choices are true or false (default).

Return Values

`EMBLData`	MATLAB structure with fields corresponding to EMBL data.
`EMBLSeq`	MATLAB character string representing the sequence.

Description

EMBLData = emblread(File) reads data from File, an EMBL-formatted file, and creates EMBLData, a MATLAB structure with fields corresponding to the EMBL two-character line type code. Each line type code is stored as a separate element in the structure.

EMBLData contains the following fields.

Field
`Identification.EntryName`
`Identification.Version`
`Identification.Topology`
`Identification.Molecule`
`Identification.DataClass`
`Identification.Division`
`Identification.SequenceLength`
`Accession`
`SequenceVersion`
`DateCreated`
`DateUpdated`
`Description`
`Keyword`
`OrganismSpecies`
`OrganismClassification`
`Organelle`
`Reference{#}.Number`
`Reference{#}.Comment`
`Reference{#}.Position`
`Reference{#}.MedLine`
`Reference{#}.PubMed`
`Reference{#}.Group`
`Reference{#}.Authors`
`Reference{#}.Title`
`Reference{#}.Location`
`DatabaseCrossReference`
`Comments`
`Assembly`
`Feature`
`Basecount.BP`
`Basecount.A`
`Basecount.C`
`Basecount.G`
`Basecount.T`
`Basecount.Other`
`Sequence`

Note Topology information was not included in EMBL flat files before release 87 of the database. When reading a file created before release 87, EMBLREAD returns an empty Identification.Topology field.

Note The entry name is no longer displayed in the ID line of EMBL flat files in release 87. When reading a file created in release 87, EMBLREAD returns the accession number in the Identification.EntryName field.

EMBLSeq = emblread (File, 'SequenceOnly', SequenceOnlyValue) controls the reading of only the sequence without the metadata. Choices are true or false (default).

Examples

Retrieve sequence information from the Web, save to a file, and then read back into the MATLAB software.

Use the getembl function and ToFile property to retrieve sequence information from the Web and save to an EMBL-formatted file.
```
getembl('X00558','ToFile','rat_protein.txt');
```

Read data from the EMBL-formatted file and create a MATLAB structure.

EMBLData = emblread('rat_protein.txt')

EMBLData = 

            Identification: [1x1 struct]
                 Accession: 'X00558'
           SequenceVersion: 'X00558.1'
               DateCreated: '13-JUN-1985 (Rel. 06, Created)'
               DateUpdated: [1x46 char]
               Description: [1x75 char]
                   Keyword: [1x75 char]
           OrganismSpecies: [1x75 char]
    OrganismClassification: [3x75 char]
                 Organelle: ''
                 Reference: {[1x1 struct]}
    DatabaseCrossReference: ''
                  Comments: ''
                  Assembly: ''
                   Feature: [23x75 char]
                 BaseCount: [1x1 struct]
                  Sequence: [1x877 char]