Skip to content

elistockwell/ava

 
 

Repository files navigation

American Viticultural Areas (AVA) Project

The UC Davis library, in conjunction with UCSB, Virginia Tech, other partner organizations, and contributions from the general public, will create a publicly accessible version American Viticultural Areas boundaries. Using the text descriptions from the ATPF Code of regulations, we will build this data from the official descriptions. These data will be made freely available. This dataset will provide wine researchers with an important tool as they examine the scientific, economic and historical aspects of viticulture.

Anyone can contribute to this project.

Project Rationale

All wine sold is marked by a geographic location specifying where the grapes that make the wine were grown. Sometimes these geographical markers, or appellations, are shaped by political boundaries, but more often or not a wine’s geography is marked by a designated grape-grown region. In the United States, grape-growing regions are called American Viticultural Areas (AVAs) and their boundaries are established by the Alcohol and Tobacco Tax and Trade Bureau (TTB) under the Department of the Treasury. Today, there are 142 AVAs in California, for example, each recognized for its distinctive topographical, climatic, and/or historic and cultural features. Some are as well-known as the Napa Valley AVA established in 1981, and others as new the Malibu Coast AVA established in 2014.

These designations are extremely important to the development of both the wine industry and wine research. They provide the standard geographical category for those seeking to evaluate and compare wine aesthetics, wine production and marketing data, and the science related to different wine-growing environments.

While the AVAs are widely used in industry and research, there is no freely available, open-access geographical information dataset demarcating the boundaries of these regions in California (or in other States). GIS representations of the official AVA boundaries delineated in the US Code of Federal Regulations are incomplete, and those that are available are restricted and expensive to use. By developing a cooperative project aimed at making AVAs boundaries available as an open GIS dataset, we will extend to researchers and industry a tool that will allow them to better visualize, publicize, and compare their data.

The AVA Project seeks to empower the study of wine regions and facilitate research into emerging environmental questions, while enabling greater insight into this important sector of the California’s economy and culture.

For information of American Viticulture Areas: TTB: https://www.ttb.gov/wine/ava.shtml Wine Institute: https://www.wineinstitute.org/resources/avas

How Can You Contribute?

Read the GettingStarted.md, digitizing_ava_boundaries.md, and quality control procedure.md files to familiarize yourself with the policies and procedures for this project.

The project will now shift to creating historical boundaries and to quality control and we welcome contributions to both of these efforts.

Progress

As of March 20, 2020, California's boundaries are complete and have undergone our quality control procedure. We feel that the current data for California is of high quality and suitable for use in academic research, however, please submit an Issue if you find additional areas of concern in the dataset so we can address them.

All the remaining AVA boundaries outside of California have been completed, as of May 11,2020, and we are beginning quality control procedures on these data.

New AVAs that were approved by the TTB between June and October 2020 are in the process of being added to our dataset.

UC Davis

UC Davis completed boundaries for the northern California, Arizona, and Colorado AVAs. Issues marked with the "UC Davis" label are designated for UC Davis to work on. They will continue adding AVAs moving east across the county.

UC Santa Barbara

UC Santa Barbara completed boundaries for the southern California AVAs (marked with the "UC Santa Barbara" label in the Issues list) November 2017 and have subsequently contributed many boundaries in Oregon and Washigton.

Virginia Tech

Virginia Tech plans to complete boundaries in and around Virginia. These boundaries are marked with the "Virginia Tech" label in the Issues list.

Additional Partnerships

University entities (departments, labs, research groups, etc.) or other organizations interested in becoming project partners should contact us. We're happy to discuss new partnerships in building this and similar datasets! A partnership is not necessary, however, to contribute.

Attribute Data Definitions

identifier type description example
ava_id text an identification string prescribed in the Issue for each AVA leona_valley
name text the legal name given to the AVA Leona Valley
aka text (optional) other names, including historical names, and terms used for the AVA
created date YYYY-MM-DD format; the date of the first publication creating the AVA 2017-06-01
removed date (optional) the date the AVA designation was removed from an area
county text the county, or list of counties separated by a comma, in which the AVA exists Los Angeles, Ventura
state text the state, or list of states separated by a comma, using the two-letter postal abbreviation, in which the AVA exists CA, NV
within text (if applicable) used for smaller AVAs that fit inside of larger AVAs; the larger AVA that this AVA sits inside
contains text (if applicable) used for larger AVAs that contain smaller AVAs; the smaller AVAs that fit inside this AVA
petitioner text the name of the person who initiated the petition and their affiliation separated by a comma Jane Smith, Smith Family Wineries
cfr_author text the name of the TTB employee that authored the proposed and/or final rules in the Federal Register; typically found near the end of the document Bob Jones
cfr_index decimal number the number code that indicates where the final rule document can be found; typically, it is in the section heading of the CFR entry online 9.212
cfr_revision_history text the string of text citing the documents that currently apply to this boundary definition [T.D. TTB-71, 73 FR 64202, Oct. 29, 2008]
approved_maps text the approved maps listed for the boundary defintion (1) Ritter Ridge, Calif., 1958; Photorevised 1974; (2) Sleepy Valley, CA, 1995; (3) Del Sur, CA, 1995; and (4) Lake Hughes, CA, 1995.
boundary_description text the official boundary description
used_maps text the maps the digitizer used to digitize the boundary
valid_start date the date this boundary revision began (applies only if there were revisions to the boundary)
valid_end date the last date this revision was valid (applies only if there were revisions to the boundary)
lcsh text (optional) Library of Congress Subject Heading; Generally UCD Library staff has filled these in and will add them as new subject headings are approved
sameas text (optional) linked data URIs for terms that are identical to this AVA

Note: Contributors using QGIS 2.18.10 or older with GDAL 2.2.0 should fill in any blanks in their attribute table with N/A due to a known issue with how unset values are handled. A more permanent fix is in the works. Contributors using QGIS 3.0 have not experienced this issue and it is now the version we recommend.

How can you access the data?

Download the whole repository

You can use the green download button on the Code tab of this repository to download all of the files in this repository or you can fork this repository. Finished states are available for download in the AVAs By State folder.

Download just the AVAs file or individual AVA boundaries

You can download single .geojson files (including the avas.geojson file that has all of the boundaries) by:

  1. On the Code tab, navigate to the file you would like to download, and click on the file name.
  2. Click the Download button, which will take you to a page that displays the text of the document.
  3. Right click anywhere on the page, and select "Save as..."
  4. Save the file where you would like to keep it. You may need to remove an additional .txt extension that may get automatically added to the file name. You file extension should be .geojson

What is the long-term plan for this data?

Version 1.0 will be released once all of the AVAs in California are completed and proofed for quality. The data will be offered as a fixed set of boundaries (no longer updated) here on our GitHub site but also in the UC Davis Library Digital Asset Management System. Work will continue on additional AVA boundaries. Definitions for additional versions will depend on partnerships and resource availability.

UC Davis DataLab & Library Project Team:

Michele Tobias (Geospatial Data Specialist, DataLab, Data & Digital Scholarship)

Vessela Ensberg (Online Strategies)

Quinn Hart (Digital Applications)

Axel Borg (Wine Librarian, Research Support Services)

David Michalski (Geography Librarian, Research Support Services)

Michael Colby (Librarian, Content Support Services)

Amber Reyes (Student Employee, Data Management Program, from April - July 2017)

Yao Fang (Student Employee, Data Management Program, from October 2017 - June 2018)

Soo Min Hur (Student Employee, Data Management Program, November 2018 - June 2019)

David Li (Student Employee, DataLab, starting October 2019)

Consultants:

Jennifer Harbster (Librarian, Research Support Services)

Michael Wolfe (Scholarly Communications Officer)

UCSB Library Project Team:

Tom Brittnacher (Geospatial Data Curator)

Andrew Jessup (Collaboratory Services Specialist)

Maga Kim (Undergraduate; Collaboratory Staff)

Timothy Kwong (Undergraduate; Collaboratory Staff)

Virginia Tech Project Team:

Peter Sforza (Director, Center for Geospatial Information Technology)

Eric West (Geospatial Analyst, Center for Geospatial Information Technology)

Other Contributors

Alex Mandel (UC Davis Center for Spatial Sciences)

Grant Miller-Francisco

Kyle W. Smith

ouwxmaniac

Arielle Rose (Intern, UC Davis Center for Spatial Sciences)

Sierra Mabanta (Intern, UC Davis Center for Spatial Sciences)

Brian Lee (UC Davis Economics Alumni)

Innisfree McKinnon (Assistant Professor, University of Wisconsin, Stout)

Daniel O'Brien (Intern, UC Davis Center for Spatial Sciences)

Anna Gard (Intern, UC Davis Center for Spatial Sciences)

Alexenia Aldape (UC Davis Alumni & Intern, UC Davis Center for Spatial Sciences)

Steve De Long

Arturo P. Rios

Awards, Publications, & Projects Using Our Data

2018 Sautter Award - Silver - for Innovation in Information Technologies, awarded by the University of California Office of the President.

Myles, C.C., M.M. Tobias, & I. McKinnon. 2020. “‘A big fish in a small pond’: How Arizona wine country was made” in Agritourism, Wine Tourism, Craft Beer Tourism: Local Responses to peripherality through tourism niches. Maria Giulia Pezzi (GSSI), Alessandra Faggian (GSSI), Neil Reid (University of Toledo, OH), eds.

Cantu, et al. 2021. Investigating the impact of regionality on the sensorial and chemical aging characteristics of Pinot noir grown throughout the U.S. West coast.. Food Chemistry 337(2021).

Bizou Wine's "Mapping Our Wines"

Have you used the AVA project in your work? Please let us know! mmtobias [at] ucdavis.edu

License

The licence for this data is Creative Commons CC0. We encourage citation of this dataset when it is used in academic works.

Disclaimer

The American Viticulture Areas (AVA) Project data is provided for educational purposes only. Data and materials may not be accurate or complete, and are provided as-is, without warranties of any kind. Please note that while every effort was made to digitize the data from the maps designated in the official descriptions of the boundaries from the Alcohol and Tobacco Tax and Trade Bureau, some substitutions were made and are noted in the attribute table.

About

American Viticultural Areas

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Languages

  • R 100.0%