Updated guide is now available here
This guide (V20151015) should help you describe and submit your artifacts for a review. It gradually evolves based on our past Artifact Evaluations and your feedback (see this presentation with an outcome of the past PPoPP/CGO'15 AE). It should also help you prepare your artifacts for a possible public release, if you plan to do so (for example as an auxiliary material in a Digital Library or on your personal web page).
Navigation:
- What to expect
- Preparing artifacts for submission
- If accepted
- Examples of accepted artifacts
- Methodology archive
- Extended artifact description
What to expect
We are trying to make artifact submission as simple as possible. You just need to pack your artifact (code and data) using any publicly avialable tool you prefer or arrange a remote access to machine with pre-installed software (exceptional cases when rare hardware or proprietary software is used).
Then, you need to prepare a small and informal guide for reviewers using our AE LaTeX template (see below) to explain what are your artifacts, how to access and use them, and what is the expected result (we currently discuss with the conference chairs and ACM to let you keep it as Appendix in your paper if your artifact passes evaluation).
At least two reviewers will follow your guide to replicate your results (for example, exact output match) or reproduce them (for example, varying performance numbers or scalability on a different machine), and will then send you a report with the following overall assessment of your artifact based on our reviewing guidelines:
- significantly exceeded expectations
- exceeded expectations
- met expectations
- fell below expectations
- significantly fell below expectations
Since our eventual goal is to promote artifact validation and sharing (rather than naming and shaming problematic artifacts), you will be able to address raised issues during the rebuttal. Furthermore, we allow a small amount of communication between reviewers and authors whenever there are installation/usage problems. In such cases, AE chairs will serve as a proxy to avoid revealing reviewers' identity (the review is blind, i.e. your identity is known to reviewers since your paper is already accepted, but not vice versa).
Preparing artifacts for submission
You just need to perform the following 4 steps to submit your artifact:-
Pack your artifact (code and data) or provide an easy access to them
using any publicly available and free tool you prefer or strictly require.
For example, you can use the following:- Virtual Box to pack all code and data including OS (typical images are around 2..3GB. we strongly recommend to avoid images larger than 10GB).
- Docker to pack only touched code and data during experiment.
- Standard zip or tar with all related code and data, particularly when artifact should be rebuilt on a reviewers machine (for example to have a non-virtualized access to a specific hardware).
- Private or public GIT or SVN.
- Arrange a remote access to machine with pre-installed software (exceptional cases when rare hardware or proprietary software is used or the VM image is too large)) - you will need to privately send the access information to the AE chairs. Also, please avoid making any changes to the remote machine during evaluation (unless explicitly agreed with AE chairs) - you can do it during rebuttal phase, if needed!
Note that after experiencing various sharing and reproducibility issues during past Artifact Evaluation, we started developing new and open-source technology which involves the community to solve them. If you are interested to check it out, we will be happy to help you use this technology or get your feedback to improve it for the future AE:- OCCAM Framework to enable open curation for computer architecture modeling.
- Collective Knowledge Framework (CK) to decompose ad-hoc experimental workflows, scripts and VM/Docker images into reusable and customizable components while using already installed and possibly proprietary tools, benchmarks and data sets (see example of PLDI'15 CLSmith artifact converted to CK format with live reproducible results; and interactive paper example with reusable benchmarks, data sets and CK plugins for autotuning and machine learning shared via GitHub). at CGO'16.
- Write a brief artifact abstract to informally describe your artifact including minimal hardware and software requirements, how it supports your paper, how it can be validated and what is the expected result. It will be used to select appropriate reviewers.
- Fill in and append AE template (download here) to the PDF of your accepted paper. Though it should be relatively intuitive, you can check out extra notes about this template based on our past AE experience.
- Submit artifact abstract and new PDF at this EasyChair website for the joint PPoPP/CGO 2016 AE.
If accepted
You can now add the following stamp to the final camera-ready version of your paper: While there are no strict formatting rules for the stamp, please add it anywhere close to the title. For example, see PPoPP'15 article together with this LaTeX example. You can change \hspace and \raisebox parameters to better fit stamp to your paper.We strongly encourage you to submit your AE appendix as an auxiliary material for Digital Library (while removing all unnecessary or confidential information) along with the final variant of your paper. This will help readers better understand what was evaluated. We currently discuss procedures with ACM DL colleagues - please stay tuned!
Though you are not obliged to publicly release your artifacts (in fact, it is sometimes impossible due to various limitations), we also strongly encourage you to share them with the community (even if they are not open-source). You can release them as an auxiliary material in Digital Libraries together with your AE appendix or use your institutional repository and various public services for code and data sharing.
Even accepted artifacts may have some unforeseen behavior and limitations discovered during evaluation. Now you have a chance to add related notes to your paper as a future work (if you wish)..
Note, that we are developing open-source Collective Knowledge framework to help researchers share their artifacts as unified, reusable and customizable components together with experimental workflows and interactive articles. If you are interested to know more, please check some online examples and recent DATE'16 paper.
A few examples of accepted artifacts from the past conferences, workshops and journals
- "Polymer: A NUMA-aware Graph-structured Analytics Framework", PPoPP 2015 (GitHub and personal web page)
- "A graph-based higher-order intermediate representation", CGO 2015 (GitHub)
- "MemorySanitizer: fast detector of uninitialized memory use in C++", CGO 2015 (added to LLVM)
- "Predicate RCU: an RCU for scalable concurrent updates", PPoPP 2015 (BitBucket)
- "Low-Overhead Software Transactional Memory with Progress Guarantees and Strong Semantics", PPoPP 2015 (SourceForge and Jikes RVM)
- "More than You Ever Wanted to Know about Synchronization", PPoPP 2015 (GitHub)
- "Roofline-aware DVFS for GPUs", ADAPT 2014 (ACM DL, Collective Knowledge repository)
- "Many-Core Compiler Fuzzing", PLDI 2015 (original artifact guide at personal web-page and reusable components in Collective Knowledge Format shared via GitHub with live results)