From 67cc086cc93827e0c48a95b2d0296a16ec5dbfa0 Mon Sep 17 00:00:00 2001 From: Henrik Andersson Date: Sun, 3 Dec 2023 12:03:12 +0100 Subject: [PATCH 1/3] Skeleton of JOSS paper --- .github/workflows/draft-pdf.yml | 23 ++++++ joss/example.md | 119 ++++++++++++++++++++++++++++++++ joss/paper.md | 35 ++++++++++ 3 files changed, 177 insertions(+) create mode 100644 .github/workflows/draft-pdf.yml create mode 100644 joss/example.md create mode 100644 joss/paper.md diff --git a/.github/workflows/draft-pdf.yml b/.github/workflows/draft-pdf.yml new file mode 100644 index 000000000..f24d0d071 --- /dev/null +++ b/.github/workflows/draft-pdf.yml @@ -0,0 +1,23 @@ +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: joss/paper.md + - name: Upload + uses: actions/upload-artifact@v1 + 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: joss/paper.pdf \ No newline at end of file diff --git a/joss/example.md b/joss/example.md new file mode 100644 index 000000000..657f416a7 --- /dev/null +++ b/joss/example.md @@ -0,0 +1,119 @@ +--- +title: 'Gala: A Python package for galactic dynamics' +tags: + - Python + - astronomy + - dynamics + - galactic dynamics + - milky way +authors: + - name: Adrian M. Price-Whelan + orcid: 0000-0000-0000-0000 + equal-contrib: true + affiliation: "1, 2" # (Multiple affiliations must be quoted) + - name: Author Without ORCID + equal-contrib: true # (This is how you can denote equal contributions between multiple authors) + affiliation: 2 + - name: Author with no affiliation + corresponding: true # (This is how to denote the corresponding author) + affiliation: 3 + - given-names: Ludwig + dropping-particle: van + surname: Beethoven + affiliation: 3 +affiliations: + - name: Lyman Spitzer, Jr. Fellow, Princeton University, USA + index: 1 + - name: Institution Name, Country + index: 2 + - name: Independent Researcher, Country + index: 3 +date: 13 August 2017 +bibliography: paper.bib + +# Optional fields if submitting to a AAS journal too, see this blog post: +# https://blog.joss.theoj.org/2018/12/a-new-collaboration-with-aas-publishing +aas-doi: 10.3847/xxxxx <- update this with the DOI from AAS once you know it. +aas-journal: Astrophysical Journal <- The name of the AAS journal. +--- + +# Summary + +The forces on stars, galaxies, and dark matter under external gravitational +fields lead to the dynamical evolution of structures in the universe. The orbits +of these bodies are therefore key to understanding the formation, history, and +future state of galaxies. The field of "galactic dynamics," which aims to model +the gravitating components of galaxies to study their structure and evolution, +is now well-established, commonly taught, and frequently used in astronomy. +Aside from toy problems and demonstrations, the majority of problems require +efficient numerical tools, many of which require the same base code (e.g., for +performing numerical orbit integration). + +# Statement of need + +`Gala` is an Astropy-affiliated Python package for galactic dynamics. Python +enables wrapping low-level languages (e.g., C) for speed without losing +flexibility or ease-of-use in the user-interface. The API for `Gala` was +designed to provide a class-based and user-friendly interface to fast (C or +Cython-optimized) implementations of common operations such as gravitational +potential and force evaluation, orbit integration, dynamical transformations, +and chaos indicators for nonlinear dynamics. `Gala` also relies heavily on and +interfaces well with the implementations of physical units and astronomical +coordinate systems in the `Astropy` package [@astropy] (`astropy.units` and +`astropy.coordinates`). + +`Gala` was designed to be used by both astronomical researchers and by +students in courses on gravitational dynamics or astronomy. It has already been +used in a number of scientific publications [@Pearson:2017] and has also been +used in graduate courses on Galactic dynamics to, e.g., provide interactive +visualizations of textbook material [@Binney:2008]. The combination of speed, +design, and support for Astropy functionality in `Gala` will enable exciting +scientific explorations of forthcoming data releases from the *Gaia* mission +[@gaia] by students and experts alike. + +# Mathematics + +Single dollars ($) are required for inline mathematics e.g. $f(x) = e^{\pi/x}$ + +Double dollars make self-standing equations: + +$$\Theta(x) = \left\{\begin{array}{l} +0\textrm{ if } x < 0\cr +1\textrm{ else} +\end{array}\right.$$ + +You can also use plain \LaTeX for equations +\begin{equation}\label{eq:fourier} +\hat f(\omega) = \int_{-\infty}^{\infty} f(x) e^{i\omega x} dx +\end{equation} +and refer to \autoref{eq:fourier} from text. + +# Citations + +Citations to entries in paper.bib should be in +[rMarkdown](http://rmarkdown.rstudio.com/authoring_bibliographies_and_citations.html) +format. + +If you want to cite a software repository URL (e.g. something on GitHub without a preferred +citation) then you can do it with the example BibTeX entry below for @fidgit. + +For a quick reference, the following citation commands can be used: +- `@author:2001` -> "Author et al. (2001)" +- `[@author:2001]` -> "(Author et al., 2001)" +- `[@author1:2001; @author2:2001]` -> "(Author1 et al., 2001; Author2 et al., 2002)" + +# Figures + +Figures can be included like this: +![Caption for example figure.\label{fig:example}](figure.png) +and referenced from text using \autoref{fig:example}. + +Figure sizes can be customized by adding an optional second parameter: +![Caption for example figure.](figure.png){ width=20% } + +# Acknowledgements + +We acknowledge contributions from Brigitta Sipocz, Syrtis Major, and Semyeong +Oh, and support from Kathryn Johnston during the genesis of this project. + +# References \ No newline at end of file diff --git a/joss/paper.md b/joss/paper.md new file mode 100644 index 000000000..25c71a5ca --- /dev/null +++ b/joss/paper.md @@ -0,0 +1,35 @@ +--- +title: "`modelskill` : A Python package for model skill assessment" +tags: + - "Python" + - "model skill assessment" + - "model evaluation" + - "model validation" +authors: + - name: Jesper Sandvig Mariegaard + orcid: 0009-0000-0118-3302 + affiliation: "1" + - name: Henrik Andersson + orcid: 0000-0003-1752-8584 + affiliation: "1" + - name: Daniel Caichac + orcid: 0000-0000-0000-0000 + affiliation: "1" +affiliations: + - name: DHI + index: 1 +date: 1 January 2024 +--- + +# Summary + +'`modelskill`' is a Python package for model skill assessment. It is designed to be used in conjunction with the MIKE FM modelling software, but can also be used for other modelling software. The package is designed to be easy to use and to provide a wide range of functionality for model skill assessment. The package is open source and available on GitHub. + +# Statement of need + +Quantifying the skill of a model is an important part of the modelling workflow. The skill of a model can be assessed in many different ways, and there are many different metrics that can be used. The '`modelskill`' package provides a wide range of functionality for model skill assessment, including many different metrics and plots. + +The package is designed to be easy to use to encourage modelers to use it. +Many of the functions are designed to be used with a single line of code. +For speficic use cases, the evaluation can be easily be extended with custom metrics and configurable plots. + From 188fd6962dbfeab2f608e04a04e7415e8a2fb2c7 Mon Sep 17 00:00:00 2001 From: Henrik Andersson Date: Sun, 3 Dec 2023 12:07:15 +0100 Subject: [PATCH 2/3] Name action --- .github/workflows/draft-pdf.yml | 2 ++ 1 file changed, 2 insertions(+) diff --git a/.github/workflows/draft-pdf.yml b/.github/workflows/draft-pdf.yml index f24d0d071..1b7d16675 100644 --- a/.github/workflows/draft-pdf.yml +++ b/.github/workflows/draft-pdf.yml @@ -1,3 +1,5 @@ +name: Paper Draft + on: [push] jobs: From ea2e3cc74a79bf99163ad437e881b87aaa5072d0 Mon Sep 17 00:00:00 2001 From: Henrik Andersson Date: Sun, 3 Dec 2023 12:10:27 +0100 Subject: [PATCH 3/3] Authors --- joss/paper.md | 3 +++ 1 file changed, 3 insertions(+) diff --git a/joss/paper.md b/joss/paper.md index 25c71a5ca..df19e58b4 100644 --- a/joss/paper.md +++ b/joss/paper.md @@ -15,6 +15,9 @@ authors: - name: Daniel Caichac orcid: 0000-0000-0000-0000 affiliation: "1" + - name: Ryan Walter Murray + orcid: 0000-0000-0000-0000 + affiliation: "1" affiliations: - name: DHI index: 1