From c8d5f10e1a80bd025f6756b240ab647512988f02 Mon Sep 17 00:00:00 2001 From: Pyry Kantanen Date: Tue, 24 Jun 2025 15:49:23 +0300 Subject: [PATCH] Bump to 1.2.0 --- DESCRIPTION | 4 ++-- NEWS.md | 4 ++++ README.Rmd | 8 +++++--- README.md | 52 +++++++++++++++++++++++++++++++++++++++++++++------ inst/CITATION | 32 +++++++++++++++++++++++++------ 5 files changed, 83 insertions(+), 17 deletions(-) diff --git a/DESCRIPTION b/DESCRIPTION index eb8e920..18b0c13 100644 --- a/DESCRIPTION +++ b/DESCRIPTION @@ -1,8 +1,8 @@ Package: hetu Type: Package Title: Structural Handling of Finnish Personal Identity Codes -Version: 1.1.0 -Date: 2024-12-03 +Version: 1.2.0 +Date: 2025-06-24 Authors@R: c( person(given = "Pyry", diff --git a/NEWS.md b/NEWS.md index adb0afe..d9667e6 100644 --- a/NEWS.md +++ b/NEWS.md @@ -1,6 +1,10 @@ # *News* ========== +# hetu 1.2.0 (2025-06-24) + +* Edit package citation to include a reference to the joint article in R Journal describing the `hetu` and `sweidnumbr` packages + # hetu 1.1.0 (2024-12-03) * Add summary method and plot methods for data.frames produced by `hetu_diagnostic()` diff --git a/README.Rmd b/README.Rmd index 1dda55f..80093ae 100644 --- a/README.Rmd +++ b/README.Rmd @@ -96,9 +96,11 @@ vignette("hetu") ## Acknowledgements -**Kindly cite this work** as follows: [Pyry Kantanen](https://github.com/pitkant/), Måns Magnusson, Jussi Paananen, Leo Lahti. Pyry Kantanen, Mans Magnusson, Jussi Paananen and Leo Lahti (2024). hetu: Structural Handling of Finnish - Personal Identity Codes [Computer software]. R package version 1.1.0. DOI: - https://doi.org/10.32614/CRAN.package.hetu +**Kindly cite this work** as follows (citing the related paper strongly preferred but we encourage also citing software used in research): + +```{r, comment="", prompt=TRUE, highlight=FALSE} +print(citation("hetu"), bibtex=TRUE) +``` We are grateful to all [contributors](https://github.com/rOpenGov/hetu/graphs/contributors)! This project is part of [rOpenGov](https://ropengov.org). diff --git a/README.md b/README.md index 636f161..8e184a2 100644 --- a/README.md +++ b/README.md @@ -117,12 +117,52 @@ vignette("hetu") ## Acknowledgements -**Kindly cite this work** as follows: [Pyry -Kantanen](https://github.com/pitkant/), Måns Magnusson, Jussi Paananen, -Leo Lahti. Pyry Kantanen, Mans Magnusson, Jussi Paananen and Leo Lahti -(2024). hetu: Structural Handling of Finnish Personal Identity Codes -\[Computer software\]. R package version 1.1.0. DOI: - +**Kindly cite this work** as follows (citing the related paper strongly +preferred but we encourage also citing software used in research): + +``` text +> print(citation("hetu"), bibtex=TRUE) +To cite package ‘hetu’ in publications use: + + Kantanen P, Bülow E, Lahtinen A, Magnusson M, Paananen J, Lahti L + (2025). "Validating and Extracting Information from National + Identification Numbers in R: The Case of Finland and Sweden." _The R + Journal_, *16*, 4-14. ISSN 2073-4859, doi:10.32614/RJ-2024-023 + . + +A BibTeX entry for LaTeX users is + + @Article{RJ-2024-023, + title = {Validating and Extracting Information from National Identification Numbers in R: The Case of Finland and Sweden}, + author = {Pyry Kantanen and Erik B{\"u}low and Aleksi Lahtinen and M{\aa}ns Magnusson and Jussi Paananen and Leo Lahti}, + year = {2025}, + doi = {10.32614/RJ-2024-023}, + journal = {The R Journal}, + volume = {16}, + issue = {3}, + issn = {2073-4859}, + pages = {4-14}, + } + +We strongly recommend citing the software used in research, as per +FORCE11 Software citation principles: + + Pyry Kantanen, Måns Magnusson, Jussi Paananen and Leo Lahti (2025). + hetu: Structural Handling of Finnish Personal Identity Codes + [Computer software]. R package version 1.2.0. DOI: + https://doi.org/10.32614/CRAN.package.hetu + +A BibTeX entry for LaTeX users is + + @Misc{, + title = {hetu: Structural Handling of Finnish Personal Identity Codes}, + author = {Pyry Kantanen and M{\aa}ns Magnusson and Jussi Paananen and Leo Lahti}, + doi = {10.32614/CRAN.package.hetu}, + url = {https://github.com/rOpenGov/hetu}, + year = {2025}, + note = {R package version 1.2.0}, + } +``` We are grateful to all [contributors](https://github.com/rOpenGov/hetu/graphs/contributors)! diff --git a/inst/CITATION b/inst/CITATION index 464338a..7e66087 100644 --- a/inst/CITATION +++ b/inst/CITATION @@ -1,15 +1,37 @@ -citHeader("Kindly cite the hetu R package as follows:") - year <- sub("-.*", "", meta$Date) vers <- paste("R package version", meta$Version) +bibentry( + bibtype="article", + header="To cite package ‘hetu’ in publications use:", + key="RJ-2024-023", + title="Validating and Extracting Information from National Identification Numbers in R: The Case of Finland and Sweden", + author= + c( + person(given="Pyry", family="Kantanen"), + person(given="Erik", family="B{\\\"u}low"), + person(given="Aleksi", family="Lahtinen"), + person(given="M{\\aa}ns", family="Magnusson"), + person(given="Jussi", family="Paananen"), + person(given="Leo", family="Lahti") + ), + year=2025, + doi="10.32614/RJ-2024-023", + journal="The R Journal", + volume="16", + issue="3", + issn="2073-4859", + pages="4-14" +) + bibentry( bibtype="Misc", + header = "We strongly recommend citing the software used in research, as per FORCE11 Software citation principles:", title = "hetu: Structural Handling of Finnish Personal Identity Codes", author = c( person(given ="Pyry", family="Kantanen", email = "pyry.kantanen@gmail.com"), - person(given ="Mans", family="Magnusson"), + person(given ="M{\\aa}ns", family="Magnusson"), person(given ="Jussi", family="Paananen"), person(given ="Leo", family="Lahti")), doi = "10.32614/CRAN.package.hetu", @@ -19,11 +41,9 @@ bibentry( note = vers, textVersion = paste0( - "Pyry Kantanen, Mans Magnusson, Jussi Paananen and Leo Lahti (",year,"). ", + "Pyry Kantanen, Måns Magnusson, Jussi Paananen and Leo Lahti (",year,"). ", "hetu: Structural Handling of Finnish Personal Identity Codes [Computer software]. ", vers, ". DOI: https://doi.org/10.32614/CRAN.package.hetu" ) ) - -citFooter("\nMany thanks for all contributors!")