AGCoL

  NCBI

Download Convert files General

  Go to top


       UA BIO5        SyMAP
Home
  
Download   Docs          System
Guide
  
Input   Parameters          User
Guide
  
Queries

NCBI supplies FASTA formatted files for genome sequence and GFF3 formatted files for the annotation, where FASTA and GFF3 files are the input to SyMAP. Though they can be loaded directly into SyMAP, it is better to convert them.

Download
Convert files
   Options
   Scaffolds
                  
General
   Load files into SyMAP
   Editing the script
   What the ConvertNCBI script does

Reasons to convert files

  1. The NCBI name for a chromosome or scaffold are long and crowd the interface. Convert uses "ChrN" instead for chromosomes only (where the 'Chr' prefix can be removed on load); when scaffolds are included it uses the prefixes 'C' for chromosome and 's' for scaffold.
  2. Only the 'protein-coding' genes are processed.
  3. Only the set of exons from the 1st mRNA are saved in the new GFF file.
  4. Gene attributes of output GFF file:
    ID from the input gene attributes.
    Name from the input gene attributes (if it is not equal ID).
    desc is the gene description; if it does not exist, then it uses the 1st mRNA product. Symbols (e.g. %3B) are replaced with the correct character.
    rnaID is equal to the first mRNA ID. Following the ID is (n), where n=the number of mRNAs for the gene.
    proteinID (optional) is equal the 1st CDS protein-id of the 1st mRNA.
  5. It has an option to produce a hard masked sequence.
If there are problems converting the NCBI file(s), then symap will have problems loading the original NCBI files. NCBI formats are not totally consistent, so this may not take everything into account; check your files with the xToSymap Summarize function. See Tested genomes and editing the script.

The following instructions will use Brassica oleracea (wild cabbage) as an example.

Download

Go to NCBI.
  1. As shown in Fig 1:
    1. Select Genome from the pull-down at the top.
    2. Enter you genome name followed by Search.
    or, go to All RefSeq and select your genome.
  2. As shown in Fig 2:
    1. From the list of files, select the Assembly you want.
    2. Select Download Package. As shown, a window will popup with options.
    3. Select the RefSeq1 format with the FASTA and GFF files.
    4. Select Download. By default, a file called ncbi_dataset.zip will be downloaded.
1xToSymap Convert NCBI does NOT work with Genbank files, only RefSeq.


Fig 1. Search the NCBI site.

 


Fig 2. Select the RefSeq genome FASTA and GFF files.

Convert files

Options Scaffolds Go to top
  1. Go to the symap_5/data/seq directory.
  2. Make a subdirectory for your species (see Project directory), move ncbi_dataset.zip to it, and unzip it, e.g.
    symap_5/data/seq> mkdir cabb
    symap_5/data/seq> cd cabb
    symap_5/data/seq/cabb> mv ~/Download/ncbi_dataset.zip .
    symap_5/data/seq/cabb> unzip ncbi_dataset.zip
    Archive:  ncbi_dataset.zip
      inflating: README.md
      inflating: ncbi_dataset/data/data_summary.tsv
      inflating: ncbi_dataset/data/assembly_data_report.jsonl
      inflating: ncbi_dataset/data/GCF_000695525.1/GCF_000695525.1_BOL_genomic.fna
      inflating: ncbi_dataset/data/GCF_000695525.1/genomic.gff
      inflating: ncbi_dataset/data/dataset_catalog.json
    
  3. Start the xToSymap program, select the appropriate options (described below), then select Convert. The FASTA file must end in ".fna" and the annotation file must end in ".gff" (the NCBI defaults).
The program will output statistics to the terminal and a log file, e.g. log. The results in the cabb directory is as follows:
symap_5/data/seq/cabb> ls -hlG
total 264008
-rw-------@ 1 cari  staff   1.6K Jul 23  2024 README.md
drwxr-xr-x  4 cari  staff   128B Jul 23 09:54 annotation/
drwxr-xr-x@ 3 cari  staff    96B Jul 23 08:19 ncbi_dataset/
-rw-r--r--@ 1 cari  staff   126M Jul 23 07:11 ncbi_dataset.zip
drwxr-xr-x  3 cari  staff    96B Jul 23 09:54 sequence/
You may remove everything but annotation/ and sequence/. However, you may want to keep the original data/seq/cabb/ncbi_dataset.

Options

OptionDescriptionDefault
Hard Mask NCBI genome sequences are typically soft-masked, where this option changes it to hard masked Leave as soft-mask
Include scaffold1 Scaffolds will be included in FASTA and GFF. See section Scaffolds No scaffolds
Include Mt/Pt Mt/Pt chromosomes will be included in FASTA and GFF. Only the first occurrence will be included. No Mt/Pt
Only prefix2Only sequences with the specified prefix will be processed. None
Protein-id A new attribute called proteinID= will be the value of the protein-id of the 1st CDS for the 1st mRNA of the gene. This can be searched using the Queries Do not include
Verbose Print extra info, see log. No print
1You may use Include scaffold, and then limit the input on the symap Load by setting
  Minimal length in the project's Parameters.
2For situations needing Only prefix, see exceptions.

Rules: There are variations in the text associated with the FASTA ">" header lines. The rules used by this script are as follows:

  1. If Only prefix is not blank, sequences are filtered out if the seqid does not start with the prefix. Then all the following apply to the non-filtered sequences:
     
  2. Chromosomes: The name starts with 'NC_'.
    • The exception is that Mt/Pt chromosomes will not be output unless Include Mt/Pt is selected.
      Mt/Pt: header line contains the word 'mitochondrion', 'mitochondrial', 'plastid' or 'chloroplast'.
    • Chromosomes are always output unless Only prefix is set, and the prefix does not match.
    • Output Seqid: If the ">" line contains "chromosome N", where N={number, X, Y or roman numeral}, than this number is used prefixed by 'Chr' or 'C' (if scaffolds are included).
      Otherwise, the word following 'chromosome' is used (e.g. C1).

  3. Scaffolds: The name starts with 'NW_' or 'NT_'.
    • They will only be output if Include scaffold is selected.
    • Output Seqid: 'Scaf' followed by a consecutive number.

  4. Unknown: All other ">" entries are considered "unknown".
    • They will only be output if Only prefix matches.
    • Output Seqid: 'Unk' followed by a consecutive number.
See Summarize to help determine how to set the options for your input.

Scaffolds

By default, the Convert option creates the genomic.fna file with only the chromosomes. However, you can have it also include scaffolds by selecting Include Scaffolds; see log for convert summary of cabbage.

This will include all chromosomes (assigned prefix 'C') and scaffolds (assigned prefix 's') in the genomic.fna file. Beware, there can be many tiny scaffolds. If they all aligned in SyMAP, it causes the display to be very cluttered. Hence, it is best to just align the largest ones (e.g. the longest 30); merge them if possible, then try the smaller ones. You should set the following SyMAP project's Parameters:

  1. Group prefix needs to be blank as there will be no common prefix.
  2. Minimum length should be set to only load the largest scaffolds.
    Calculate the length using the xToSymap Lengths.

General

Load files into SyMAP Editing the script What the ConvertNCBI script does Go to top

Load files into SyMAP

The above scenario puts the files in the default SyMAP directories. When you start up SyMAP, you will see your projects listed on the left of the panel (e.g as shown for demos).
  1. Check the projects you want to load, which will cause them to be shown on the right of the symap window.
  2. For the project you want to load, open the project's Parameters window to enter the appropriate values.
  3. Then select Load Project.

Editing the script

The NCBI FASTA files are not consistent in their header lines. Hence, the parsing could be incorrect. They may also not be consistent in the GFF files, but I have not found one. Anyway, if it is not parsing the FASTA file correctly, edit the program as described here.

What the ConvertNCBI script does

The script scripts/ConvertNCBI.java executes the same code as the xToSymap NCBI Convert.

FASTA: Reads the file ending in '.fna.gz' (or '.fna') and writes a new file called sequence/genomic.fna with the following changes:

  1. Sequences must start with the "NC_", "NW_" or "NT_" names, or have the word "chromosome" or "scaffold" in their ">" header line in order to be copied. Scaffolds are only processed if the Include scaffolds is selected.

  2. The header line is replaced with ">ChrN", where N comes from the header line "chromosome N", e.g. "chromosome 1", etc.
    For example: >NC_029256.1 Oryza sativa Japonica Group cultivar Nipponbare chromosome 1
    is replaced with: Chr1 NC_029256.1

  3. Gaps of >30,000 are written to the annotation/gap.gff file (this value can be changed in the xToSymap interface).

  4. If Hard mask is selected, all lower case bases are changed to 'N'.

GFF: Reads the file ending in 'gff.gz' (or .gff) and writes the file annotation/anno.gff. The gff3 format has 9 columns, where the first is the 'seqid', the third is the 'type' (e.g. feature 'gene'), the last column is a semicolon-delimited keyword=value attribute list. The input file is processed as follows:

  1. The type=gene with attribute gene-biotype=protein-coding are processed. The gene line is written to the anno.gff file with the following changes:
    1. The first column 'seqid' is replace with the 'ChrN' value assigned when reading the '.fna' file.
    2. A subset of the attributes are written:
      • ID and Name from the input gene attributes.
      • desc is the gene description; if this does not exist, then it is the 1st mRNA product.
      • rnaID is equal to the first mRNA ID.
      • proteinID (optional) is equal the 1st CDS protein-id for the 1st mRNA.
  2. The first type=mRNA line for a gene is written to the anno.gff file followed by its type=exon, where they each are written with the new seqid and a subset of the attributes. The mRNA ID is saved as an gene attribute (rnaID=) to indicate which exons were saved.
     
  3. If Protein-id is selected, then the attribute protein_id= from the first type=CDS of the 1st mRNA for the gene is extracted.
Go to top

Email Comments To: symap@agcol.arizona.edu