stwunsch/aod2nanoaodoutreachtool

Tool to convert CMS AOD data format to NanoAOD format for the purpose of education and outreach

Tool to convert AOD to NanoAOD

Tool to convert AOD to NanoAOD file format for the purpose of education and outreach

Description

The tool can be used to read events from CMS AOD files and convert them to a reduced NanoAOD data format. Note that the tool is published for the documentation of the related datasets below and may need significant experiment-specific knowledge to be used.

Setup CMSSW

In case CMSSW is set up outside of the CMS Open Data VM or of the CMS Open Data docker container, source the following script.

source /cvmfs/cms.cern.ch/cmsset_default.sh

And check-out the appropriate CMSSW release using following call.

cmsrel CMSSW_5_3_32

Build module

cd CMSSW_5_3_32/src
cmsenv
mkdir workspace
cd workspace
git clone git://github.com/cms-opendata-analyses/AOD2NanoAODOutreachTool -b v1.2 AOD2NanoAOD
cd AOD2NanoAOD
scram b -j8

Test configuration locally

cmsRun configs/simulation_cfg.py
cmsRun configs/data_cfg.py

Example scripts for batch system submission

You can use the following script to submit to any HTCondor batch system.

./submit_jobs.sh /path/to/job/directory

You can merge the job files with the following script.

./merge_jobs.py /path/to/job/outputs

Test workflows

This repository contains two GitHub action workflows, which run the test workflow on the CMS open data container using GitHub free resources.

• The workflow in main.yml runs a test job in a docker container. The run commands are passed in commands.sh.
• The workflow in main_argo.yml sets up a minikube environment and runs a workflow defined with argo workflow engine. The workflow definition and run commands are in argo-workflow.yaml.

The output is returned as a GitHub artifact. The workflows are triggered by a pull request.