Fields marked with an asterisk are required. All other fields are optional. If N/A, leave the field blank.

Primary fields

Video tutorial: Create a dataset on the Ag Data Commons

  • Title​* ​: Enter a descriptive dataset title as you want it to appear; include dates, locations, and specific metrics that make your dataset unique. If the data is from a Primary Article Citation (see below), use the naming convention "Data from: title of article"

  • Description​* ​: A rich free text description that provides as much explanation as possible about the dataset: how and why it was generated, and how it should (or should not) be used. This can be modified from article text (e.g. Abstract, Methods, Objectives), but should focus on characterizing the data, not the journal article.
    Please provide explanations for all acronyms and abbreviations. Get more guidance on filling out the Description field.

  • Summary: A shorter description of the dataset, usually no more than a sentence or two. This information will appear in the main dataset list as a teaser line under the Title to briefly communicate the contents and purpose of your dataset. (Note: You can toggle between the Summary and Description boxes by clicking the "Edit Summary" and "Hide Summary" links - both boxes will not be visible in the submission form at the same time.)

  • Author *​:

    • Name *​: Enter the Last name, First name, Middle initial followed by a period (e.g. Doe, John A.) of all persons involved in the data collection. Authors can be different from those listed in a primary/related article (or presented in a different order); multiple allowed.

    • Identifier Kind: Select from the drop-down list to select the unique author identifier kind, if applicable. For example, ORCID, ResearcherID, etc.

      • Visit the ORCID registration page to search for any existing accounts under your name and to create a new account if you do not already have one. Your ORCID iD connects with your ORCID Record that can contain links to your research activities, affiliations, awards, other versions of your name, and more. You control this content and who can see it. The search bar is at the very top of the page. Make sure you do not have an existing account before creating another one.
    • Identifier: Enter the unique author identifier here, if applicable. For example, an ORCID identifier should be entered as 1234-5678-9123-4567.

  • Dataset DOI (digital object identifier)​: DOI for the dataset, not the journal article that may be referencing it. If a DOI does not already exist and you are uploading data directly to the Ag Data Commons (as opposed to linking to externally hosted data), the Ag Data Commons will obtain one for you. See our section on opting out of this option if you do not want a DOI created for your dataset.

  • ISO Topic​: High-level subject categorization, also referred to as ISO Topic Categories. Select one or more from the drop-down list; multiple allowed.

  • Product Type​: This field automatically defaults to Dataset. However, it may be changed to better describe the main or most important part of the dataset's actual content

    • Acceptable content includes: Dataset, Database, Photograph collection, Presentation, Software tool, Computer model, Animations/Simulations, Figures/Plots, Genome/Genetics Data, Interactive Data Maps, Multimedia, Numeric Data, and Still Images or Photos.

Purpose & Methods

Video tutorial: Filling out the Purpose and Methods section of the Ag Data Commons data submission form

  • Intended Use​: Explain the intended use and benefits of the dataset. What purpose do you expect the data to serve? For example, precipitation data may be collected to study patterns of groundwater recharge, to validate watershed models, etc; Life-cycle assessment (LCA) data may be intended for a wide range of impacts in private or public use and/or for product comparisons, etc.

  • Use Limitations​: Explain the limitations regarding the dataset's usability. For example, estimates may be biased over water, equipment may have malfunctioned during a specified time, granularity may mean it is unsuitable for certain kinds of analysis.

  • Equipment or software used: ​Name the equipment and software used to collect and process the data. Provide make and model, name and version number, and a stable URL for each tool used to collect and process the data.

Geographic Information

Video tutorial: Filling out the Geographic section of the Ag Data Commons data submission form

  • State or Territory​: Select as many as are applicable from the drop-down list of states; multiple allowed.

  • Spatial Description​: This free text can be an address, city, state, region, or other spatial description. Geonames are recommended but not required.

  • Global Map​: You may also use the interactive map (projected in WGS84) to indicate where your data were collected. See the left side of the map for buttons to manipulate data input. These features can be used exclusively or in combination to enter multiple points, polygons, or bounding boxes to a single record if applicable.

    • The + and - enable you to zoom in or out, depending on the level of geographic detail you wish to represent. If you have global data, you may zoom out as much as necessary to indicate data were collected across multiple countries.

    • Select the third button on the left to enter one or more polygons

    • Select the fourth button to enter one or more bounding boxes

    • Select the fifth button to drop one or more points on the map

    • Select the tabs at the top of the map to enter data in other ways. The GeoJSON tab enables you to enter raw GeoJSON data. GeoJSON is a technical standard that will appeal to GIS enthusiasts. See DCAT spatial/geographical coverage for more info.

    • Select the last tab on the right, Points, to manually input one or more points in decimal degrees. This is recommended if you know the exact point where data were collected. You can find the exact coordinates of an address or location at a variety of sites, including http://www.gps-coordinates.net/

Temporal Information

Video tutorial: Filling out the Temporal section of the Ag Data Commons data submission form

  • Temporal Coverage​: The span of time during which data were collected. Add temporal coverage in one of the following formats (start date/end date; if data collection is ongoing, leave the end date blank):

  • Frequency​: The frequency with which dataset is published e.g. None, Daily, Weekly, Monthly, Annually, Continuously, Irregularly, Decennial - R/P10Y, Quadrennial - R/P4Y, Bimonthly - R/P2M, etc. For example, data with a publish frequency repeating once every 10 years would be designated Decennial - R/P10Y. See DCAT frequency for more info.

Citations

Video tutorial: Filling out the Citations section of the Ag Data Commons data submission form

  • Primary Article

    • Full Citation: ​Enter the full bibliographic citation, in APA, to a published article that directly describes this dataset (i.e. a data paper). Leave blank if there is no primary article connected to this dataset.

    • Article DOI: ​Enter the article’s DOI (just the number itself, not as a full URL, and excluding the prefix “doi:”). For example, "10.123/ABC/123"

    • PubAg AGID: ​If the article is in PubAg, enter the AGID here. When you navigate to an article in PubAg, the URL will look like this: https://pubag.nal.usda.gov/catalog/61025 . The AGID is the string of numbers following “/catalog/”. Leave blank if not applicable.

  • Methods Citation

    • Full Citation: ​Enter the full bibliographic citation, in APA, to a published article that describes the procedures for data assembly in greater detail; multiple allowed.

    • Article DOI: ​Enter the article’s DOI (just the number itself, not as a full URL, and excluding the prefix “doi:”). For example, "10.123/ABC/123"

    • PubAg AGID: ​If the article is in PubAg, enter the AGID here. When you navigate to an article in PubAg, the URL will look like this: https://pubag.nal.usda.gov/catalog/61025 . The AGID is the string of numbers following “/catalog/”. Leave blank if not applicable.

  • Related Article

    • Full Citation: ​Enter the full bibliographic citation, in APA, to a published article that is related to this dataset. Use your discretion to list only the most useful and relevant one(s); multiple allowed.

    • Article DOI: ​Enter the article’s DOI (just the number itself, not as a full URL, and excluding the prefix “doi:”). For example, "10.123/ABC/123"

    • PubAg AGID: ​If the article is in PubAg, enter the AGID here. When you navigate to an article in PubAg, the URL will look like this: https://pubag.nal.usda.gov/catalog/61025 . The AGID is the string of numbers following “id=” Leave blank if not applicable.

  • Preferred Dataset Citation​: If you have a specifically formatted citation for this dataset that you want others to use, enter it here. This will ensure your dataset is cited to your satisfaction if/when it is re-used. If this field is left blank, a standard dataset citation will be constructed for you.

  • Metadata Sources: ​If you are using metadata that has already been prepared for this dataset, indicate your sources of metadata here.

Related Content

Video tutorial: Filling out the Related Content section of the Ag Data Commons data submission form

  • Is Part Of​: Is this dataset part of a larger dataset on the Ag Data Commons? If so, type the first letters of the container dataset’s title, then select from the autocomplete suggestions.

  • Cites other datasets

    • Full Citation​: Provide the full citation(s) for datasets that were used to construct this one. This is particularly relevant for datasets that are aggregations or adaptations of other data.

    • DOI or other link​: Provide the cited dataset's DOI as a full URL, e.g. "http://dx.doi.org/10.123/ABC/123". If there is no DOI, provide another link to the dataset.

  • Related To​: Provide a name and URL to a resource that provides additional context to the dataset, e.g. a project website, manual, or data documentation. This field is not to denote relationship among datasets, but relationships among the dataset and non-dataset resources; multiple allowed.

Contact

Video tutorial: Filling out the Contact information section of the Ag Data Commons data submission form

  • Contact Name​: Enter a long-term contact person for the dataset. This can be different from the dataset author/originator e.g. a data curator or administrator. See Project Open Data for more info. Format as Last name, First name.

  • Contact Email​: Contact person’s email address.

  • Reviewer​: Name of person other than author who has reviewed and approved the data (not the metadata); multiple allowed.

  • Publisher​: Publisher of the dataset. This will be displayed in the dataset citation Ag Data Commons suggests to users of your data and is required to obtain a DOI. The field will default to “Ag Data Commons” unless you change it.

Keywords

Video tutorial: Filling out the Keywords section of the Ag Data Commons data submission form

  • User-supplied Tags​: Free text keywords to facilitate discovery of the dataset. This field is not part of a controlled vocabulary, and is intended to capture meaningful tags to support search and browse; multiple allowed.

  • Program​: Choose from the hierarchy to select a program designation, if applicable. These programs are specific to the National Agricultural Library.

Administrative

Video tutorial: Filling out the Administrative section of the Ag Data Commons data submission form

  • License​: Enter the license assigned to this dataset; for federally generated data, this should be a Public Domain dedication such as CC Zero (Creative Commons CC Zero) or US Public Domain. Unsure which license to choose? Walk through the following questions to help determine the right one. The following is based on the latest guidance from the Federal CIO council.

    1. Are all the data owners federal employees who generated the data as part of their work?

      • If YES, then the license recommendation is CC Zero (Creative Commons CC Zero).

      • If YES, but you are concerned about international public domain, then the license recommendation is US Public Domain.

      • If NO, see #2.

    2. If all data owners are not federal government employees, were the data generated under a grant, collaborative agreement, or other contract agreement?

      • If YES, check the terms of that agreement for a “rights in data” or related clause. Use the licensing information specified there.

      • If YES, but no specific license is mentioned in your agreement, see #3.

    3. If your licensing agreement allows non-federal data owners to choose a license, the license recommendation is CC Zero (preferred), CC BY (Creative Commons Attribution), or CC BY SA (Creative Commons Attribution-ShareAlike). License definitions and additional information can be found at http://opendefinition.org/licenses/ or https://creativecommons.org/licenses/

      • If more restrictive licensing is requested by non-federal data owners, then the data are unsuitable for the Ag Data Commons. We host and support open data to facilitate sharing and reuse.
    4. If your data was generated with no US federal funding, then they are unsuitable for the Ag Data Commons at this time. As the Ag Data Commons grows, we may consider expanding to include data from externally funded researchers. If you have questions or need assistance, email us at NAL_ADC_Curator@nal.usda.gov.

Video tutorial: Choosing a license for your data on the Ag Data Commons

  • Public Access Level: ​Enter the degree to which this dataset could be made publicly available, regardless of whether it has been. See Project Open Data for more info.

  • Bureau Code​: Please specify one or more bureau codes. For example USDA-Agricultural Research Service (ARS) funded research should be “005:18”. See Project Open Data for more info.

  • Program Code​: Please specify one or more program codes. ARS and National Institute of Food and Agriculture (NIFA) funded research should be “005:037 - Research and Education”. See Project Open Data for more info.

  • Funding Source(s)​: Indicate all sources of funding for the dataset. Include the institution name and project number, if available; multiple allowed. If this is an ARS or NIFA funded project, put the CRIS number in the Project or grant number field.

  • ARIS Log Number: ​This only applies to datasets created by Agricultural Research Service employees. Enter the ARIS log number, if applicable.

  • Resources: allows you to attach resources to your dataset that are already uploaded to other datasets

    • This feature is useful if your data is part of a larger program that uses the same documentation or data dictionary
    • Begin typing the name of the resource, and choose the correct one from the list
    • The resources must be exactly the same among all your datasets. If you make a change to one, it changes on every dataset that this resource is uploaded to because it is the same file.
    • If you need to make customizations in the title or description or any other part of the resource, it is best to skip this section and upload the resource directly to this dataset with your customizations
  • Highlight Image​: This image should be an informative and attractive picture or graphic, and may be used to accompany your dataset. Files must be less than 4 GB, and in one of the following file types: .png .gif .jpg or .jpeg. Ag Data Commons curators reserve final approval for all image selections.

  • Revision log message: Provide an explanation of the changes you are making. This will help other authors understand your motivations.

  • Moderation state: Set the moderation state for this content - this is one place content authors can submit their draft for review.

Video tutorial: Submit your dataset for review on the Ag Data Commons