Guidance on how to deposit data at the AEA Data and Code Repository
Start the deposit process
Go to the AEA Data and Code Repository, and start the process:
Most deposits will also need to provide the following metadata elements. In some cases, it may not make sense to fill out (for instance, a laboratory experiment may have no meaningful “geographic coverage”). These elements contribute to better inclusion in search engines.
The following elements are suggested for certain types of data, and may not apply to all types of data.
Start by providing the metadata (descriptors) for the data and code you are uploading.
Describe the project
- The title should be “
Data and Code for: [Title of article]”
- The authors should be those who compiled the data and code. This may differ (if necessary) from the article.
- The summary might be short. It can include the abstract of the article itself. It does not need to include information on the related article (which has its own field).
- Identify any funding sources here - the information can be queried by some funders, and can assist with your award reporting.
Scope of project section
To fill out the required metadata elements Subject Terms, JEL Classification, and Manuscript Number, open the “Scope of Project” section:
Click on each + to open the related section:
- Authors MUST provide additional subject terms (keywords). You do not need to repeat JEL codes.
- Authors MUST provide JEL codes (under “Scope of Project”)
- Authors MUST provide the Manuscript Number, (your Scholar One tracking number as assigned by the editorial office, e.g., “AER-2019-0000”) as this will allow us to properly connect the repository with the manuscript.
- Where appropriate, authors are REQUIRED to define
- the geographical scope(s)
- the time period(s)
- the universe(s)
- data type(s)
- Most fields are repeatable, please enter as many values as needed. For instance, if subsets of the data cover different periods (e.g.,
2004-2019). Just click “add value” next to the time period field for each time period.
- This information can also be provided when only code is made available.
- When only code is produced, authors should choose
data type = program source code:
- Methodology is particularly relevant for survey or experimental data:
- response rates, sampling rates, etc.
- We ENCOURAGE all authors to define
- the unit of observation (e.g. individual, firm, establishment, county, country)
- The AEA editorial office will provide an entry for this field that links back to the published manuscript - authors do not need to add any reference to the manuscript anywhere in the deposit form (other than the Manuscript Number)
- Authors are encouraged to link back to working papers or related publications that have or will use this (same!) data.
- If code is derived from or continues to be updated on a Git repository (Github, Gitlab, Bitbucket, etc.), authors can link to it here.
- Future functionality will automatically list articles (including articles by third parties) that cite the data.
Checklist for Uploading
Once the metadata is completed, authors can upload files.
Upload files in the way you expect the files to be organized in order to run the code.
- If the UNCOMPRESSED contents of the deposit (the UNZIPPED size of the ZIP file) are larger than 30GB, please send an email to the AEA Data Editor to request an increase in the quota. Reasonable requests will be authorized. Size of the deposit is never a reason not to provide materials, as we have found solutions for every single case so far.
- If you have more than 1,000 files in your deposit, talk to us before uploading.
- The Import functionality can handle ZIP files, but cannot handle other compression formats (RAR,7z, etc.). Please convert to ZIP before importing.
- It is possible to IMPORT a ZIP file (do NOT upload a ZIP file - no ZIP files should be visible in the deposit). Replicators will be downloading a ZIP file that preserves the directory structure.
- Please upload the README (in PDF or TXT) as the very first file - ensuring that it can be found easily by browsers of the archive.
- It is OK to upload Markdown or Word documents in addition to, but not instead of the PDF or TXT version
- Please upload the README to the root of the repository - any data and code can be in subdirectories, but it is easier to find the README if it is not in subdirectories.
- There should be no duplicate README files in the repository
Your deposit should have
- no redundant directories: the first thing you should see is the README and any subdirectories
- there should be no ZIP files!
- the structure should be as you last ran the code
[NOTE] The AEA staff will not re-arrange or otherwise restructure your deposit in any way. What you see in the deposit interface is what others will see once it is published.
You should see something like this:
LICENSE.txt is optional if you want to adopt one of the standard openICPSR licenses upon publication. See our licensing guidance for other options).
Submitting to the Data Editor
Once you are satisfied that all data files are present, are complete, and all metadata is satisfactory, including all required elements filled out, you should submit the deposit, by changing the status of the deposit:
Choose “Submit to AEA” under “Change Status”.
Should you have forgotten something, you can “recall” the submission.
Citing Your Deposit
At present (2020), the openICPSR repository does not display the Digital Object Identifier (DOI) that will be associated with your deposit. However, it can be deduced easily.
- Each openICPSR project has a number (e.g., “109622”), that might show up on the right panel:
- if the openICPSR project has not been published, then the DOI will be “http://doi.org/10.3886/E” + number + “V1” (e.g. http://doi.org/10.3886/E109622V1)
- if the project has already been published before, and you are updating it, then the “V1” will be incremented. See our FAQ
- You should then cite your deposit as follows (see AEA Sample References):
|Romer, Christina D., and David H. Romer. 2010. “Replication data for: The Macroeconomic Effects of Tax Changes: Estimates Based on a New Measure of Fiscal Shocks.” American Economic Association [publisher], Inter-university Consortium for Political and Social Research [distributor]. https://doi.org/10.3886/E112357V1.
Give it a try:
Ready to submit manuscript
Once you have completed the deposit, you are now ready to submit the manuscript native files, together with the Data and Code Availability Form, as per the journal’s guidelines (AER guidelines here).