From 086a78b431eaf913b89b6df73ceba129a39beb82 Mon Sep 17 00:00:00 2001 From: Alexander Puck Neuwirth Date: Thu, 6 Nov 2025 20:37:06 +0100 Subject: [PATCH 1/9] init paper --- paper/paper.bib | 0 paper/paper.md | 0 2 files changed, 0 insertions(+), 0 deletions(-) create mode 100644 paper/paper.bib create mode 100644 paper/paper.md diff --git a/paper/paper.bib b/paper/paper.bib new file mode 100644 index 0000000..e69de29 diff --git a/paper/paper.md b/paper/paper.md new file mode 100644 index 0000000..e69de29 From fbdfdd307c711ffb8524f45c9dcc469d84a53e36 Mon Sep 17 00:00:00 2001 From: Alexander Puck Neuwirth Date: Thu, 6 Nov 2025 20:51:18 +0100 Subject: [PATCH 2/9] Copy strucutre from vector --- paper/paper.bib | 55 +++++++++++++++++++++++++++++++++++++++++++++++++ 1 file changed, 55 insertions(+) diff --git a/paper/paper.bib b/paper/paper.bib index e69de29..1cfa87d 100644 --- a/paper/paper.bib +++ b/paper/paper.bib @@ -0,0 +1,55 @@ +--- +title: "pylhe: A Lightweight Python interface to read Les Houches Event files" +tags: + - python + - high energy physics +authors: + - name: Matthew Feickert + orcid: 0000-0003-4124-7862 + equal-contrib: true + affiliation: 1 + - name: Lukas Heinrich + orcid: 0000-0002-4048-7584 + equal-contrib: true + affiliation: 2 + - name: Eduardo Rodrigues + orcid: 0000-0003-2846-7625 + equal-contrib: true + affiliation: 3 + - name: Alexander Puck Neuwirth + orcid: 0000-0002-2484-1328 + equal-contrib: true + affiliation: "4, 5" + +affiliations: + - name: University of Wisconsin-Madison + index: 1 + - name: Technical University of Munich + index: 2 + - name: University of Liverpool + index: 3 + - name: University of Milan Bicocca + index: 4 + - name: INFN Milan Bicocca + index: 5 +date: 6 November 2025 +bibliography: paper.bib +--- + +# Summary + +... + +# Statement of need + +... + +## Impact + +... + +# Acknowledgements + +We would additionally like to thank the contributors of pylhe and the Scikit-HEP community for their support. + +# Reference From 520bf1fc50242cf0c780e62c27915719ee670c87 Mon Sep 17 00:00:00 2001 From: Alexander Puck Neuwirth Date: Thu, 6 Nov 2025 20:53:18 +0100 Subject: [PATCH 3/9] fix: mixup of files --- paper/paper.bib | 55 ------------------------------------------------- paper/paper.md | 55 +++++++++++++++++++++++++++++++++++++++++++++++++ 2 files changed, 55 insertions(+), 55 deletions(-) diff --git a/paper/paper.bib b/paper/paper.bib index 1cfa87d..e69de29 100644 --- a/paper/paper.bib +++ b/paper/paper.bib @@ -1,55 +0,0 @@ ---- -title: "pylhe: A Lightweight Python interface to read Les Houches Event files" -tags: - - python - - high energy physics -authors: - - name: Matthew Feickert - orcid: 0000-0003-4124-7862 - equal-contrib: true - affiliation: 1 - - name: Lukas Heinrich - orcid: 0000-0002-4048-7584 - equal-contrib: true - affiliation: 2 - - name: Eduardo Rodrigues - orcid: 0000-0003-2846-7625 - equal-contrib: true - affiliation: 3 - - name: Alexander Puck Neuwirth - orcid: 0000-0002-2484-1328 - equal-contrib: true - affiliation: "4, 5" - -affiliations: - - name: University of Wisconsin-Madison - index: 1 - - name: Technical University of Munich - index: 2 - - name: University of Liverpool - index: 3 - - name: University of Milan Bicocca - index: 4 - - name: INFN Milan Bicocca - index: 5 -date: 6 November 2025 -bibliography: paper.bib ---- - -# Summary - -... - -# Statement of need - -... - -## Impact - -... - -# Acknowledgements - -We would additionally like to thank the contributors of pylhe and the Scikit-HEP community for their support. - -# Reference diff --git a/paper/paper.md b/paper/paper.md index e69de29..1cfa87d 100644 --- a/paper/paper.md +++ b/paper/paper.md @@ -0,0 +1,55 @@ +--- +title: "pylhe: A Lightweight Python interface to read Les Houches Event files" +tags: + - python + - high energy physics +authors: + - name: Matthew Feickert + orcid: 0000-0003-4124-7862 + equal-contrib: true + affiliation: 1 + - name: Lukas Heinrich + orcid: 0000-0002-4048-7584 + equal-contrib: true + affiliation: 2 + - name: Eduardo Rodrigues + orcid: 0000-0003-2846-7625 + equal-contrib: true + affiliation: 3 + - name: Alexander Puck Neuwirth + orcid: 0000-0002-2484-1328 + equal-contrib: true + affiliation: "4, 5" + +affiliations: + - name: University of Wisconsin-Madison + index: 1 + - name: Technical University of Munich + index: 2 + - name: University of Liverpool + index: 3 + - name: University of Milan Bicocca + index: 4 + - name: INFN Milan Bicocca + index: 5 +date: 6 November 2025 +bibliography: paper.bib +--- + +# Summary + +... + +# Statement of need + +... + +## Impact + +... + +# Acknowledgements + +We would additionally like to thank the contributors of pylhe and the Scikit-HEP community for their support. + +# Reference From 0126fc4e6dd546e79f094a8507ae21efe0b114dd Mon Sep 17 00:00:00 2001 From: Alexander Puck Neuwirth Date: Thu, 6 Nov 2025 21:14:10 +0100 Subject: [PATCH 4/9] Some sentence --- paper/paper.bib | 37 +++++++++++++++++++++++++++++++++++++ paper/paper.md | 5 ++++- pyproject.toml | 1 + 3 files changed, 42 insertions(+), 1 deletion(-) diff --git a/paper/paper.bib b/paper/paper.bib index e69de29..7b89821 100644 --- a/paper/paper.bib +++ b/paper/paper.bib @@ -0,0 +1,37 @@ +@inproceedings{Boos:2001cv, + author = "Boos, E. and others", + title = "{Generic User Process Interface for Event Generators}", + booktitle = "{2nd Les Houches Workshop on Physics at TeV Colliders}", + eprint = "hep-ph/0109068", + archivePrefix = "arXiv", + reportNumber = "FERMILAB-CONF-01-496-T", + month = "9", + year = "2001" +} + +@article{Buckley:2019xhk, + author = {Buckley, Andy and Ilten, Philip and Konstantinov, Dmitri and L{\"o}nnblad, Leif and Monk, James and Pokorski, Witold and Przedzinski, Tomasz and Verbytskyi, Andrii}, + title = "{The HepMC3 event record library for Monte Carlo event generators}", + eprint = "1912.08005", + archivePrefix = "arXiv", + primaryClass = "hep-ph", + reportNumber = "MPP-2019-258, MCNET-19-27, LU-TP 19-58", + doi = "10.1016/j.cpc.2020.107310", + journal = "Comput. Phys. Commun.", + volume = "260", + pages = "107310", + year = "2021" +} + +@article{Alwall:2006yp, + author = "Alwall, J. and others", + title = "{A Standard format for Les Houches event files}", + eprint = "hep-ph/0609017", + archivePrefix = "arXiv", + reportNumber = "FERMILAB-PUB-06-337-T, CERN-LCGAPP-2006-03", + doi = "10.1016/j.cpc.2006.11.010", + journal = "Comput. Phys. Commun.", + volume = "176", + pages = "300--304", + year = "2007" +} diff --git a/paper/paper.md b/paper/paper.md index 1cfa87d..c51927e 100644 --- a/paper/paper.md +++ b/paper/paper.md @@ -32,12 +32,15 @@ affiliations: index: 4 - name: INFN Milan Bicocca index: 5 -date: 6 November 2025 +date: 6 November 2025 # APN TODO: update date bibliography: paper.bib --- # Summary + +Some history/introduction history of different formats. HEPEVT -> LHEF -> HepMC -> HDF5? (since its binary maybe in the future? Unlike hepmc/lhe no need to gzip!) +The format is used by major Monte Carlo event generators such as MadGraph, POWHEG, Sherpa, HERWIG, Pythia ... ... # Statement of need diff --git a/pyproject.toml b/pyproject.toml index b3a1639..bd62739 100644 --- a/pyproject.toml +++ b/pyproject.toml @@ -165,3 +165,4 @@ ignore = [ # https://github.com/codespell-project/codespell/issues/2801 # Ignore very long base64-like strings ignore-regex = '[A-Za-z0-9+/]{100,}' +skip = "*.bib" From 56384fd458724125798692b47b27edd26bc45ebe Mon Sep 17 00:00:00 2001 From: Alexander Puck Neuwirth Date: Thu, 6 Nov 2025 21:16:50 +0100 Subject: [PATCH 5/9] XML example explain --- paper/paper.md | 5 +++++ 1 file changed, 5 insertions(+) diff --git a/paper/paper.md b/paper/paper.md index c51927e..c913ef9 100644 --- a/paper/paper.md +++ b/paper/paper.md @@ -43,6 +43,11 @@ Some history/introduction history of different formats. HEPEVT -> LHEF -> HepMC The format is used by major Monte Carlo event generators such as MadGraph, POWHEG, Sherpa, HERWIG, Pythia ... ... +Format is XML-like where the free text is designed to be easily parsed in fortran + +```xml +``` + # Statement of need ... From 91b303bfaaaab67c33413e9b60d8fe3ed3e6cae5 Mon Sep 17 00:00:00 2001 From: Alexander Puck Neuwirth Date: Mon, 10 Nov 2025 19:25:58 +0100 Subject: [PATCH 6/9] put me first - remove equal-contrib - add correspinding author - bump date --- paper/paper.md | 29 +++++++++++++---------------- 1 file changed, 13 insertions(+), 16 deletions(-) diff --git a/paper/paper.md b/paper/paper.md index c913ef9..8353f9a 100644 --- a/paper/paper.md +++ b/paper/paper.md @@ -4,35 +4,32 @@ tags: - python - high energy physics authors: + - name: Alexander Puck Neuwirth^[Corresponding author.] + orcid: 0000-0002-2484-1328 + affiliation: "1, 2" - name: Matthew Feickert orcid: 0000-0003-4124-7862 - equal-contrib: true - affiliation: 1 + affiliation: 3 - name: Lukas Heinrich orcid: 0000-0002-4048-7584 - equal-contrib: true - affiliation: 2 + affiliation: 4 - name: Eduardo Rodrigues orcid: 0000-0003-2846-7625 - equal-contrib: true - affiliation: 3 - - name: Alexander Puck Neuwirth - orcid: 0000-0002-2484-1328 - equal-contrib: true - affiliation: "4, 5" + affiliation: 5 affiliations: - - name: University of Wisconsin-Madison + - name: University of Milan Bicocca index: 1 - - name: Technical University of Munich + - name: INFN Milan Bicocca index: 2 - - name: University of Liverpool + - name: University of Wisconsin-Madison index: 3 - - name: University of Milan Bicocca + - name: Technical University of Munich index: 4 - - name: INFN Milan Bicocca + - name: University of Liverpool index: 5 -date: 6 November 2025 # APN TODO: update date + +date: 10 November 2025 # APN TODO: update date bibliography: paper.bib --- From 274ee42364450447be864727e8f72882802ed3b6 Mon Sep 17 00:00:00 2001 From: Alexander Puck Neuwirth Date: Mon, 10 Nov 2025 19:27:27 +0100 Subject: [PATCH 7/9] update tags --- paper/paper.md | 3 ++- 1 file changed, 2 insertions(+), 1 deletion(-) diff --git a/paper/paper.md b/paper/paper.md index 8353f9a..453cde4 100644 --- a/paper/paper.md +++ b/paper/paper.md @@ -1,7 +1,8 @@ --- title: "pylhe: A Lightweight Python interface to read Les Houches Event files" tags: - - python + - Python + - physics - high energy physics authors: - name: Alexander Puck Neuwirth^[Corresponding author.] From aed69d6168d2c83c5422708c5274df6764545fa9 Mon Sep 17 00:00:00 2001 From: Alexander Puck Neuwirth Date: Mon, 10 Nov 2025 19:31:57 +0100 Subject: [PATCH 8/9] add joss ci --- .github/workflows/draft-pdf.yml | 24 ++++++++++++++++++++++++ 1 file changed, 24 insertions(+) create mode 100644 .github/workflows/draft-pdf.yml diff --git a/.github/workflows/draft-pdf.yml b/.github/workflows/draft-pdf.yml new file mode 100644 index 0000000..196d07a --- /dev/null +++ b/.github/workflows/draft-pdf.yml @@ -0,0 +1,24 @@ +name: Draft PDF +on: [push] + +jobs: + paper: + runs-on: ubuntu-latest + name: Paper Draft + steps: + - name: Checkout + uses: actions/checkout@v4 + - name: Build draft PDF + uses: openjournals/openjournals-draft-action@master + with: + journal: joss + # This should be the path to the paper within your repo. + paper-path: paper/paper.md + - name: Upload + uses: actions/upload-artifact@v4 + with: + name: paper + # This is the output path where Pandoc will write the compiled + # PDF. Note, this should be the same directory as the input + # paper.md + path: paper.pdf From c17e32db3dc088026fe1bf85fc8b5262e540f803 Mon Sep 17 00:00:00 2001 From: Alexander Puck Neuwirth Date: Mon, 10 Nov 2025 19:34:01 +0100 Subject: [PATCH 9/9] fix: loc --- .github/workflows/draft-pdf.yml | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/.github/workflows/draft-pdf.yml b/.github/workflows/draft-pdf.yml index 196d07a..b7053c0 100644 --- a/.github/workflows/draft-pdf.yml +++ b/.github/workflows/draft-pdf.yml @@ -21,4 +21,4 @@ jobs: # This is the output path where Pandoc will write the compiled # PDF. Note, this should be the same directory as the input # paper.md - path: paper.pdf + path: paper/paper.pdf