declared

https://github.com/dusadrian/declared

Last synced: 10 months ago · JSON representation

Repository

Basic Info

Host: GitHub
Owner: dusadrian
License: gpl-3.0
Language: R
Default Branch: main
Size: 4.33 MB

Statistics

Stars: 6
Watchers: 1
Forks: 2
Open Issues: 0
Releases: 0

Created about 5 years ago · Last pushed about 1 year ago

Metadata Files

Readme Changelog Contributing Funding License Codemeta

README.Rmd

---
output: github_document
---



```{r, include = FALSE}
knitr::opts_chunk$set(
  collapse = TRUE,
  comment = "#>",
  fig.path = "man/figures/README-",
  out.width = "100%"
)
```

# declared


[![Lifecycle: experimental](https://img.shields.io/badge/lifecycle-experimental-orange.svg)](https://lifecycle.r-lib.org/articles/stages.html#experimental)
[![CRAN status](https://www.r-pkg.org/badges/version/declared)](https://CRAN.R-project.org/package=declared)
[![AppVeyor build status](https://ci.appveyor.com/api/projects/status/github/dusadrian/declared?branch=main&svg=true)](https://ci.appveyor.com/project/dusadrian/declared)
[![Codecov test coverage](https://codecov.io/gh/dusadrian/declared/branch/main/graph/badge.svg)](https://app.codecov.io/gh/dusadrian/declared?branch=main)


The goal of `declared` is to improve the functionality of imported social science
microdata, particularly labelled data. While there are excellent packages
available for these purposes, such as [haven](https://haven.tidyverse.org/) and
[labelled](http://larmarange.github.io/labelled/), they have some fundamental
design features that run, in some situations, against the user's expectations.
This has a lot to do with the treatment of declared missing values, that are
instrumental for the social sciences. The aim of `declared` is to offer an
alternative class, `declared()`{.R}, whilst ensuring as much compatibility as
possible with these popular packages.

## Installation

You can install the development version of declared using this command:

``` r
install.packages("declared", repos = "dusadrian.r-universe.dev")
```

## Example

```{r}
library(haven)
x1 <- labelled_spss(
  x = c(1:5, -91),
  labels = c("Missing" = -91),
  na_value = -91
)

print(x1)

mean(x1)
```

Instead of using the `labelled::labelled()`{.R} class or its inherited version
in `haven`, the `declared` package offers a similar class that behaves more as
it is expected--because it interprets certain "missing" values `NA` codes as
existing, declared missing values.

```{r example}
library(declared)
x2 <- declared(
  x = c(1:5, -91),
  labels = c("Missing" = -91),
  na_value = -91
)

print(x2)

mean(x2)
```

Owner

Name: Adrian Dușa
Login: dusadrian
Kind: user
Location: Bucharest, Romania
Company: University of Bucharest

Website: https://adriandusa.eu
Repositories: 7
Profile: https://github.com/dusadrian

Sociologist, and R enthusiast

CodeMeta (codemeta.json)

{
  "@context": "https://doi.org/10.5063/schema/codemeta-2.0",
  "@type": "SoftwareSourceCode",
  "identifier": "declared",
  "description": "A set of functions to declare labels and missing values, coupled with associated functions to create (weighted) tables of frequencies and various other summary measures. Some of the base functions have been rewritten to make use of the specific information about the missing values, most importantly to distinguish between empty and declared missing values. Some functions have similar functionality with the corresponding ones from packages \"haven\" and \"labelled\". The aim is to ensure as much compatibility as possible with these packages, while offering an alternative in the objects of class \"declared\".",
  "name": "declared: Functions for Declared Missing Values",
  "codeRepository": "https://github.com/dusadrian/declared",
  "issueTracker": "https://github.com/dusadrian/declared/issues",
  "license": "https://spdx.org/licenses/GPL-3.0",
  "version": "0.17.8",
  "programmingLanguage": {
    "@type": "ComputerLanguage",
    "name": "R",
    "url": "https://r-project.org"
  },
  "runtimePlatform": "R version 4.2.1 (2022-06-23)",
  "provider": {
    "@id": "https://cran.r-project.org",
    "@type": "Organization",
    "name": "Comprehensive R Archive Network (CRAN)",
    "url": "https://cran.r-project.org"
  },
  "author": [
    {
      "@type": "Person",
      "givenName": "Adrian",
      "familyName": "Dusa",
      "email": "dusa.adrian@unibuc.ro",
      "@id": "https://orcid.org/0000-0002-3525-9253"
    }
  ],
  "contributor": [
    {
      "@type": "Person",
      "givenName": "Daniel",
      "familyName": "Antal",
      "email": "daniel.antal@dataobservatory.eu",
      "@id": "https://orcid.org/0000-0001-7513-6760"
    }
  ],
  "copyrightHolder": [
    {
      "@type": "Person",
      "givenName": "Adrian",
      "familyName": "Dusa",
      "email": "dusa.adrian@unibuc.ro",
      "@id": "https://orcid.org/0000-0002-3525-9253"
    }
  ],
  "maintainer": [
    {
      "@type": "Person",
      "givenName": "Adrian",
      "familyName": "Dusa",
      "email": "dusa.adrian@unibuc.ro",
      "@id": "https://orcid.org/0000-0002-3525-9253"
    }
  ],
  "softwareSuggestions": [
    {
      "@type": "SoftwareApplication",
      "identifier": "covr",
      "name": "covr",
      "provider": {
        "@id": "https://cran.r-project.org",
        "@type": "Organization",
        "name": "Comprehensive R Archive Network (CRAN)",
        "url": "https://cran.r-project.org"
      },
      "sameAs": "https://CRAN.R-project.org/package=covr"
    },
    {
      "@type": "SoftwareApplication",
      "identifier": "haven",
      "name": "haven",
      "provider": {
        "@id": "https://cran.r-project.org",
        "@type": "Organization",
        "name": "Comprehensive R Archive Network (CRAN)",
        "url": "https://cran.r-project.org"
      },
      "sameAs": "https://CRAN.R-project.org/package=haven"
    },
    {
      "@type": "SoftwareApplication",
      "identifier": "knitr",
      "name": "knitr",
      "provider": {
        "@id": "https://cran.r-project.org",
        "@type": "Organization",
        "name": "Comprehensive R Archive Network (CRAN)",
        "url": "https://cran.r-project.org"
      },
      "sameAs": "https://CRAN.R-project.org/package=knitr"
    },
    {
      "@type": "SoftwareApplication",
      "identifier": "labelled",
      "name": "labelled",
      "provider": {
        "@id": "https://cran.r-project.org",
        "@type": "Organization",
        "name": "Comprehensive R Archive Network (CRAN)",
        "url": "https://cran.r-project.org"
      },
      "sameAs": "https://CRAN.R-project.org/package=labelled"
    },
    {
      "@type": "SoftwareApplication",
      "identifier": "pillar",
      "name": "pillar",
      "provider": {
        "@id": "https://cran.r-project.org",
        "@type": "Organization",
        "name": "Comprehensive R Archive Network (CRAN)",
        "url": "https://cran.r-project.org"
      },
      "sameAs": "https://CRAN.R-project.org/package=pillar"
    },
    {
      "@type": "SoftwareApplication",
      "identifier": "rmarkdown",
      "name": "rmarkdown",
      "provider": {
        "@id": "https://cran.r-project.org",
        "@type": "Organization",
        "name": "Comprehensive R Archive Network (CRAN)",
        "url": "https://cran.r-project.org"
      },
      "sameAs": "https://CRAN.R-project.org/package=rmarkdown"
    },
    {
      "@type": "SoftwareApplication",
      "identifier": "spelling",
      "name": "spelling",
      "provider": {
        "@id": "https://cran.r-project.org",
        "@type": "Organization",
        "name": "Comprehensive R Archive Network (CRAN)",
        "url": "https://cran.r-project.org"
      },
      "sameAs": "https://CRAN.R-project.org/package=spelling"
    },
    {
      "@type": "SoftwareApplication",
      "identifier": "testthat",
      "name": "testthat",
      "version": ">= 3.0.0",
      "provider": {
        "@id": "https://cran.r-project.org",
        "@type": "Organization",
        "name": "Comprehensive R Archive Network (CRAN)",
        "url": "https://cran.r-project.org"
      },
      "sameAs": "https://CRAN.R-project.org/package=testthat"
    },
    {
      "@type": "SoftwareApplication",
      "identifier": "tibble",
      "name": "tibble",
      "provider": {
        "@id": "https://cran.r-project.org",
        "@type": "Organization",
        "name": "Comprehensive R Archive Network (CRAN)",
        "url": "https://cran.r-project.org"
      },
      "sameAs": "https://CRAN.R-project.org/package=tibble"
    },
    {
      "@type": "SoftwareApplication",
      "identifier": "vctrs",
      "name": "vctrs",
      "provider": {
        "@id": "https://cran.r-project.org",
        "@type": "Organization",
        "name": "Comprehensive R Archive Network (CRAN)",
        "url": "https://cran.r-project.org"
      },
      "sameAs": "https://CRAN.R-project.org/package=vctrs"
    },
    {
      "@type": "SoftwareApplication",
      "identifier": "vroom",
      "name": "vroom",
      "provider": {
        "@id": "https://cran.r-project.org",
        "@type": "Organization",
        "name": "Comprehensive R Archive Network (CRAN)",
        "url": "https://cran.r-project.org"
      },
      "sameAs": "https://CRAN.R-project.org/package=vroom"
    }
  ],
  "softwareRequirements": {
    "SystemRequirements": null
  },
  "fileSize": "344.41KB",
  "releaseNotes": "https://github.com/dusadrian/declared/blob/master/NEWS.md",
  "readme": "https://github.com/dusadrian/declared/blob/main/README.md",
  "contIntegration": [
    "https://ci.appveyor.com/project/dusadrian/declared",
    "https://app.codecov.io/gh/dusadrian/declared?branch=main"
  ],
  "developmentStatus": "https://lifecycle.r-lib.org/articles/stages.html#experimental",
  "relatedLink": "https://CRAN.R-project.org/package=declared"
}

GitHub Events

Total

Watch event: 1
Push event: 7

Last Year

Watch event: 1
Push event: 7

Committers

Last synced: over 2 years ago

All Time

Total Commits: 294
Total Committers: 2
Avg Commits per committer: 147.0
Development Distribution Score (DDS): 0.02

Past Year

Commits: 71
Committers: 2
Avg Commits per committer: 35.5
Development Distribution Score (DDS): 0.028

Top Committers

Name	Email	Commits
Adrian Dusa	d**n@g**m	288
Daniel Antal	a****l	6

Issues and Pull Requests

Last synced: almost 2 years ago

All Time

Total issues: 6
Total pull requests: 4
Average time to close issues: about 24 hours
Average time to close pull requests: about 6 hours
Total issue authors: 4
Total pull request authors: 2
Average comments per issue: 3.5
Average comments per pull request: 0.5
Merged pull requests: 4
Bot issues: 0
Bot pull requests: 0

Past Year

Issues: 3
Pull requests: 1
Average time to close issues: about 14 hours
Average time to close pull requests: about 17 hours
Issue authors: 1
Pull request authors: 1
Average comments per issue: 3.0
Average comments per pull request: 1.0
Merged pull requests: 1
Bot issues: 0
Bot pull requests: 0

View more stats

Top Authors

Issue Authors

khusmann (3)
rpruim (1)
antaldaniel (1)
SarahGoslee-USDA (1)

Pull Request Authors

antaldaniel (3)
khusmann (2)

Top Labels

Issue Labels

Pull Request Labels

Packages

Total packages: 1
Total downloads:
- cran 1,350 last-month

Total dependent packages: 2
Total dependent repositories: 5
Total versions: 20
Total maintainers: 1

cran.r-project.org: declared

Functions for Declared Missing Values

Homepage: https://github.com/dusadrian/declared
Documentation: http://cran.r-project.org/web/packages/declared/declared.pdf
License: GPL (≥ 3)
Latest release: 0.25
published almost 2 years ago

Versions: 20
Dependent Packages: 2
Dependent Repositories: 5
Downloads: 1,350 Last month

Rankings

Dependent repos count: 13.0%

Dependent packages count: 13.6%

Average: 18.3%

Downloads: 18.4%

Forks count: 21.0%

Stargazers count: 25.5%

Maintainers (1)

dusa.adrian@unibuc.ro

Last synced: 10 months ago

ecosyste.ms

Data

Tools

Indexes

Applications

Experiments

Open Source Science

declared

Science Score: 26.0%

Repository

Basic Info

Statistics

Metadata Files

README.Rmd

Owner

CodeMeta (codemeta.json)

GitHub Events

Total

Last Year

Committers

All Time

Past Year

Top Committers

Issues and Pull Requests

All Time

Past Year

Top Authors

Issue Authors

Pull Request Authors

Top Labels

Issue Labels

Pull Request Labels

Packages

cran.r-project.org: declared

Rankings

Maintainers (1)

Dependencies