Package {ConverTier2}


Type: Package
Title: Conversion of Tiered Assessment Responses to Polytomous Scores
Version: 0.1.1
Description: Provides tools for converting binary responses from tiered assessment instruments into polytomous item scores based on user-defined scoring rules. The package supports scoring rule parsing, data validation, tiered response conversion, and Excel file processing. It also provides a bilingual Indonesian and English graphical user interface using 'shiny', along with downloadable 'Excel' templates and example datasets.
License: MIT + file LICENSE
Encoding: UTF-8
Imports: readxl, shiny, stats, writexl
Suggests: DT, openxlsx, shinyjs, shinythemes, testthat (≥ 3.0.0)
Config/testthat/edition: 3
Config/roxygen2/version: 8.1.1
NeedsCompilation: no
Packaged: 2026-11-15 11:12:04 UTC; Bhilan
Author: Bhilan Rhiyu Antama [aut, cre], Heni Setiyaningsih [aut], Edi Istiyono [aut]
Maintainer: Bhilan Rhiyu Antama <bhilanrhiyuantama@gmail.com>
Repository: CRAN
Date/Publication: 2026-11-16 09:30:15 UTC

ConverTier2: Conversion of Tiered Assessment Responses to Polytomous Scores

Description

ConverTier2 provides tools for converting binary responses from tiered assessment instruments into polytomous item scores based on user-defined scoring rules. The package supports scoring-rule parsing, data validation, tiered response conversion, Excel file processing, a bilingual Indonesian- English Shiny application, and Excel template/example-data generation.

Author(s)

Bhilan Rhiyu Antama bhilanrhiyuantama@gmail.com

Heni Setiyaningsih

Edi Istiyono


Convert Tiered Assessment Excel File

Description

Reads an Excel file containing binary tier responses, validates the data, converts the responses into item scores, and optionally writes the result to a new Excel file.

Usage

convert_file(input, output = NULL, rules, n_tier)

Arguments

input

Path to the input Excel file.

output

Path to the output Excel file. If NULL, the result is returned without writing a file.

rules

A named numeric vector containing scoring rules.

n_tier

Number of tiers in each item.

Value

A data frame containing the converted item scores.


Convert Tiered Responses to Scores

Description

Converts binary responses from a tiered assessment into item scores using user-defined scoring rules.

Usage

convert_tier(data, rules, n_tier)

Arguments

data

A data frame containing binary tier responses.

rules

A named numeric vector containing scoring rules.

n_tier

Number of tiers in each item.

Value

A data frame containing item scores.


Create Example Tiered-Response Data

Description

Creates reproducible example data containing binary responses (0 and 1). The default data contain 10 respondents and 10 items.

Usage

create_example_data(n_items = 10, n_tier = 2, n_respondents = 10)

Arguments

n_items

Number of items. Defaults to 10.

n_tier

Number of response tiers per item. Must be a positive integer.

n_respondents

Number of respondents. Defaults to 10.

Value

A data frame containing binary responses arranged by item and tier.


Create an Empty Tiered-Response Data Template

Description

Creates an empty data frame with columns arranged by item and tier. The default template contains 10 items.

Usage

create_template_data(n_items = 10, n_tier = 2)

Arguments

n_items

Number of items. Defaults to 10.

n_tier

Number of response tiers per item. Must be a positive integer.

Value

An empty data frame with one column for each item-tier combination.


Launch ConverTier2 Shiny Application

Description

Launches the graphical user interface for ConverTier2.

Usage

launch_app()

Value

This function launches the Shiny application and does not return a value.


Parse Tier Scoring Rules

Description

Converts text-based scoring rules into a named numeric vector.

Usage

parse_rules(text)

Arguments

text

Character string containing one scoring rule per line.

Value

A named numeric vector containing scoring rules.

Examples

rules <- parse_rules("
11 = 4
10 = 3
01 = 2
00 = 1
")

rules


Validate Tiered Assessment Data

Description

Checks whether a data frame is suitable for tiered binary response conversion.

Usage

validate_data(data, n_tier)

Arguments

data

A data frame containing binary tier responses.

n_tier

Number of tiers in each item.

Value

Invisibly returns TRUE if the data are valid.

Examples

data <- data.frame(
  Tier1_Item1 = c(1, 1, 0),
  Tier2_Item1 = c(1, 0, 0),
  Tier1_Item2 = c(0, 1, 1),
  Tier2_Item2 = c(1, 0, 1)
)

validate_data(data, n_tier = 2)