The UC Davis library, in conjunction with UCSB, other partner organizations, and contributions from the general public, will create a publically 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 availabe. 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.
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
- Read the GettingStarted.md & digitizing_ava_boundaries.md files to familiarize yourself with the policies and procedures for this project.
- Fork this repository.
- Pick a boundary to work on:
- Check the Issues list to see which AVAs are available and claim the one you want to work on.
- When viewed online in GitHub, the avas.geojson file will show you a map of what's completed (complicated boundaries) and in need of work (triangles at the county's centroid). This is helpful for finding the general location of an AVA.
- Make a boundary
- Create a Pull Request
As of November 16, 2017, 83 AVAs in California were completed. 156 remain to be completed nation-wide.
UC Davis will contribute boundaries for the northern California AVAs (marked with the "UC Davis" label in the Issues list).
UC Santa Barbara completed boundaries for the southern California AVAs (marked with the "UC Santa Barbara" label in the Issues list) November 2017.
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.
| 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 | |||
| cfr_index 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 used to digitize the boundary | |
| last_revised | date | the last revision that applies to this boundary | |
| lcsh | text | (optional) Library of Congress Subject Heading | |
| 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.
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.
You can download single .geojson files (including the avas.geojson file that has all of the boundaries) by:
- On the Code tab, navigate to the file you would like to download, and click on the file name.
- Click the Download button, which will take you to a page that displays the text of the document.
- Right click anywhere on the page, and select "Save as..."
- 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
Version 1.0 will be released once all of the AVAs in California are completed. 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.
Vessela Ensberg (Program Director, Data Management Program)
Michele Tobias (GIS Data Curator, Data Management Program)
Quinn Hart (Digital Applications)
Axel Borg (Wine Librarian, Research Support Services)
David Michalski (Geography Librarian, Research Support Services)
Michael Colby (Librarian, Content Support Services)
Yao Fang (Student Employee, Data Management Program, beginning October 2017)
Amber Reyes (Student Employee, Data Management Program, from April - July 2017)
Consultants:
Jennifer Harbster (Librarian, Research Support Services)
Michael Wolfe (Scholarly Communications Officer)
Tom Brittnacher (Geospatial Data Curator)
Andrew Jessup (Collaboratory Services Specialist)
Maga Kim (Undergraduate; Collaboratory Staff)
Timothy Kwong (Undergraduate; Collaboratory Staff)
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.