hetu

Finnish personal identification number (henkilotunnus / hetu) R package

https://github.com/ropengov/hetu

Keywords

Keywords from Contributors

Repository

Finnish personal identification number (henkilotunnus / hetu) R package

README.Rmd

---
output: github_document
---
  
```{r, echo = FALSE}
knitr::opts_chunk$set(
  collapse = TRUE,
  comment = "#>",
  fig.path = "README-"
)
```




[![rOG-badge](https://ropengov.github.io/rogtemplate/reference/figures/ropengov-badge.svg)](https://ropengov.org/)
[![R build status](https://github.com/rOpenGov/hetu/workflows/R-CMD-check/badge.svg)](https://github.com/rOpenGov/hetu/actions)
[![codecov](https://codecov.io/gh/rOpenGov/hetu/branch/master/graph/badge.svg)](https://app.codecov.io/gh/rOpenGov/hetu)
[![Downloads](http://cranlogs.r-pkg.org/badges/grand-total/hetu)](https://cran.r-project.org/package=hetu)
[![Downloads](http://cranlogs.r-pkg.org/badges/hetu)](https://cran.r-project.org/package=hetu)
[![Watch on GitHub][github-watch-badge]][github-watch]
[![Star on GitHub][github-star-badge]][github-star]
[![cran version](http://www.r-pkg.org/badges/version/hetu)](https://CRAN.R-project.org/package=hetu)




# hetu - Structural Handling of Finnish Personal Identity Numbers 

### Introduction 

`hetu` is an R package for structural handling of identification codes used in Finland, most importantly Finnish flavour of national identification numbers, the Finnish personal identity codes (in Finnish: henkilötunnus (hetu), in Swedish: personbeteckning). Some functions can also be used with Finnish Business ID numbers (in Finnish: yritys- ja yhteisötunnus (y-tunnus), in Swedish: företags- och organisationsnummer (FO-nummer)) and Finnish Unique Identification Numbers (FINUID, in Finnish: sähköinen asiointitunnus (SATU), in Swedish: elektronisk kommunikationskod).

The syntax in this package aims to be, when convenient, similar with another package specializing in national identification numbers: the [sweidnumbr](https://github.com/rOpenGov/sweidnumbr) R package for working with Swedish personal identity numbers and corporation identity numbers.

### Installation

Install stable version from CRAN:

```{r install_stable, eval = FALSE}
install.packages(hetu)
```

Alternatively, use `devtools` package to install the latest development version from GitHub:

```{r install_dev, eval = FALSE}
devtools::install_github("rOpenGov/hetu")
```

Development version can be also installed using the
[r-universe](https://ropengov.r-universe.dev):

```{r, eval=FALSE}
# Enable this universe
options(repos = c(
  ropengov = "https://ropengov.r-universe.dev",
  CRAN = "https://cloud.r-project.org"
))
install.packages("hetu")
```

### Loading the package and accessing the tutorial

Loading the package in R command line:

```{r load_library, eval = TRUE}
library(hetu)
```

A simple example of printing a table containing data from 2 imaginary personal identity codes:

```{r hetu_printout, eval = TRUE}
example_hetu <- c("010101-0101", "111111-111C")
hetu(example_hetu)
```

The package can also be used to check the validity of Finnish Business IDs (Yritys- ja Yhteisötunnus, or Y-tunnus for short):

```{r bid_printout, eval = TRUE}
example_ytunnus <- c("5996039-9", "5619117-6", "6095515-9")
bid_ctrl(example_ytunnus)
```

A tutorial is included with the package and can be viewed with vignette-function:

```{r vignette, eval = FALSE}
vignette("hetu")
```

## Contributing

  * [Submit suggestions and bug reports](https://github.com/ropengov/hetu/issues) (provide the output of `sessionInfo()` and `packageVersion("hetu")` and preferably provide a [reproducible example](http://adv-r.had.co.nz/Reproducibility.html))
  * [Send a pull request](https://github.com/rOpenGov/hetu/pulls)
  * [Star us on the Github page](https://github.com/ropengov/hetu/)
  * [See our website](https://ropengov.org/community/) for additional contact information

## Acknowledgements

**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). 

[github-watch-badge]: https://img.shields.io/github/watchers/ropengov/hetu.svg?style=social
[github-watch]: https://github.com/ropengov/hetu/watchers
[github-star-badge]: https://img.shields.io/github/stars/ropengov/hetu.svg?style=social
[github-star]: https://github.com/ropengov/hetu/stargazers

Owner

Citation (CITATION.cff)

# -----------------------------------------------------------
# CITATION file created with {cffr} R package, v0.1.1
# See also: https://docs.ropensci.org/cffr/
# -----------------------------------------------------------
 
cff-version: 1.2.0
message: 'To cite package "hetu" in publications use:'
type: software
license: BSD-2-Clause
title: 'hetu: Structural Handling of Finnish Personal Identity Numbers'
version: 1.0.4.9000
abstract: Structural handling of Finnish identity numbers (persons and companies);
  extract information, check ID validity and diagnostics.
authors:
- family-names: Kantanen
  given-names: Pyry
  email: pyry.kantanen@gmail.com
  orcid: https://orcid.org/0000-0003-2853-2765
- family-names: Magnusson
  given-names: Mans
- family-names: Paananen
  given-names: Jussi
- family-names: Lahti
  given-names: Leo
  orcid: https://orcid.org/0000-0001-5537-637X
preferred-citation:
  type: generic
  title: 'hetu: Finnish personal ID number data toolkit for R'
  authors:
  - family-names: Kantanen
    given-names: Pyry
    email: pyry.kantanen@gmail.com
  - family-names: Magnusson
    given-names: Mans
  - family-names: Paananen
    given-names: Jussi
  - family-names: Lahti
    given-names: Leo
repository: https://CRAN.R-project.org/package=hetu
repository-code: https://github.com/ropengov/hetu
url: https://ropengov.github.io/hetu
contact:
- family-names: Kantanen
  given-names: Pyry
  email: pyry.kantanen@gmail.com
  orcid: https://orcid.org/0000-0003-2853-2765
keywords:
- ropengov
- r-package
- cran
- r
- rstats

GitHub Events

Committers

Last synced: 6 months ago

Issues and Pull Requests

Last synced: 6 months ago

Packages