load_harx: Load and Process HAR Files with Header Selection

In HARplus: Enhanced R Package for 'GEMPACK' .har and .sl4 Files

Load and Process HAR Files with Header Selection

Description

Reads a GEMPACK HAR file and extracts structured data while maintaining compatibility with standard HAR formats. Provides flexibility in naming conventions and header selection.

Usage

load_harx(
  file_path,
  coefAsname = FALSE,
  lowercase = FALSE,
  select_header = NULL
)

Arguments

file_path	Character. The file path to the HAR file.
coefAsname	Logical. If TRUE, replaces four-letter headers with coefficient names when available. Default is FALSE.
lowercase	Logical. If TRUE, converts all variable names to lowercase. Default is FALSE.
select_header	Character vector. Specific headers to read; if NULL, all headers are read. Example: select_header = c("A", "E1").

Details

• Uses load_harplus() internally for efficient HAR file reading.

• Allows optional conversion of variable names to lowercase (lowercase = TRUE).

• Supports coefficient-based naming (coefAsname = TRUE).

• Enables selective header extraction via select_header = c("A", "E1").

• Returns structured data with explicit dimension names and sizes.

Value

A structured list containing:

• data: Extracted HAR variable data stored as matrices, arrays, or vectors.

• dimension_info: A list with:

  • dimension_string: A textual representation of dimensions (e.g., "REGCOMMYEAR").

  • dimension_names: The names of each dimension.

  • dimension_sizes: The size of each dimension.

Author(s)

Pattawee Puangchit

See Also

load_sl4x, get_data_by_var, get_data_by_dims

Examples

# Path to example files
har_path <- system.file("extdata", "TAR10-WEL.har", package = "HARplus")

# Basic loading
har_data <- load_harx(har_path)

# Load with coefficient names
har_data_coef <- load_harx(har_path, coefAsname = TRUE)

# Load with lowercase names
har_data_lower <- load_harx(har_path, lowercase = TRUE)

# Load specific headers
har_selected <- load_harx(har_path, select_header = c("A", "E1"))

# Load with multiple options
har_combined <- load_harx(har_path,
                         coefAsname = TRUE,
                         lowercase = TRUE,
                         select_header = c("A", "E1"))

HARplus documentation built on April 4, 2025, 4:14 a.m.