Package 'ConverTier2'

Title: Conversion of Tiered Assessment Responses to Polytomous Scores
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, Excel file processing, and a Shiny-based graphical user interface.
Authors: Bhilan Rhiyu Antama [aut, cre], Heni Setiyaningsih [aut], Edi Istiyono [aut]
Maintainer: Bhilan Rhiyu Antama <[email protected]>
License: MIT + file LICENSE
Version: 0.1.0
Built: 2026-11-11 23:56:07 UTC
Source: https://github.com/cran/ConverTier2

Help Index


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.


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(
  Jwb_1 = c(1, 1, 0),
  Als_1 = c(1, 0, 0),
  Jwb_2 = c(0, 1, 1),
  Als_2 = c(1, 0, 1)
)

validate_data(data, n_tier = 2)