This directory contains a dump of the UCSC genome annotation database for
the Sep. 2011 (Broad CanFam3.1/canFam3) assembly of the dog genome
(canFam3, Broad CanFam3.1 (GCA_000002285.2)).
The annotations were generated by UCSC and collaborators worldwide.

For more information about this assembly, please note the NCBI resources:
    http://www.ncbi.nlm.nih.gov/genome/85
    http://www.ncbi.nlm.nih.gov/genome/assembly/317138
    http://www.ncbi.nlm.nih.gov/bioproject/13179

Files included in this directory (updated nightly):

  - *.sql files:  the MySQL commands used to create the tables

  - *.txt.gz files: the database tables in a tab-delimited format
    compressed with gzip.

To see descriptions of the tables underlying Genome Browser annotation
tracks, select the table in the Table Browser:
  http://genome.ucsc.edu/cgi-bin/hgTables?db=canFam3
and click the "describe table schema" button.  There is also a "view
table schema" link on the configuration page for each track.

---------------------------------------------------------------
If you plan to download a large file or multiple files from this 
directory, we recommend you use ftp rather than downloading the files 
via our website. To do so, ftp to hgdownload.cse.ucsc.edu, then go to 
the directory goldenPath/canFam3/database/. To download multiple 
files, use the "mget" command:

    mget <filename1> <filename2> ...
    - or -
    mget -a (to download all the files in the directory) 

Alternate methods to ftp access.

Using an rsync command to download the entire directory:
    rsync -avzP rsync://hgdownload.cse.ucsc.edu/goldenPath/canFam3/database/ .
For a single file, e.g. gc5BaseBw.txt.gz
    rsync -avzP 
        rsync://hgdownload.cse.ucsc.edu/goldenPath/canFam3/database/gc5BaseBw.txt.gz .

Or with wget, all files:
    wget --timestamping 
        'ftp://hgdownload.cse.ucsc.edu/goldenPath/canFam3/database/*'
With wget, a single file: 
    wget --timestamping 
        'ftp://hgdownload.cse.ucsc.edu/goldenPath/canFam3/database/gc5BaseBw.txt.gz' 
        -O gc5BaseBw.txt.gz

Please note that some files contents, such as this example gc5BaseBw.txt.gz,
will point to the data being hosted in another /gbdb/ location, which
refers to ftp://hgdownload.cse.ucsc.edu/gbdb/

To uncompress the *.txt.gz files:
    gunzip <table>.txt.gz
The tables can be loaded directly from the .txt.gz compressed file.
It is not necessary to uncompress them to load into a database,
as shown in the example below.

To load one of the tables directly into your local mirror database,
for example the table chromInfo:
## create table from the sql definition
$ hgsql canFam3 < chromInfo.sql
## load data from the txt.gz file
$ zcat chromInfo.txt.gz | hgsql canFam3 --local-infile=1 
        -e 'LOAD DATA LOCAL INFILE "/dev/stdin" INTO TABLE chromInfo;'

------------------------------------------------------------------
All the files and tables in this directory are freely usable for any purpose.

The dog genome sequence is made freely available by the Dog Genome Sequencing
Project. Please cite the following publication when using these data:

Lindblad-Toh K, et al. Genome sequence, comparative analysis and haplotype
structure of the domestic dog. Nature. 2005 Dec 8;438:803-19.
------------------------------------------------------------------