Learn R Programming

saros (version 1.6.1)

Semi-Automatic Reporting of Ordinary Surveys

Description

Offers a systematic way for conditional reporting of figures and tables for many (and bivariate combinations of) variables, typically from survey data. Contains interactive 'ggiraph'-based () plotting functions and data frame-based summary tables (bivariate significance tests, frequencies/proportions, unique open ended responses, etc) with many arguments for customization, and extensions possible. Uses a global options() system for neatly reducing redundant code. Also contains tools for immediate saving of objects and returning a hashed link to the object, useful for creating download links to high resolution images upon rendering in 'Quarto'. Suitable for highly customized reports, primarily intended for survey research.

Copy Link

Version

Install

install.packages('saros')

Monthly Downloads

248

Version

1.6.1

License

MIT + file LICENSE

Issues

Pull Requests

Stars

Forks

Repository

https://github.com/NIFU-NO/saros

Homepage

https://nifu-no.github.io/saros/

Maintainer

Stephan Daus

Last Published

January 28th, 2026

Functions in saros (1.6.1)

embed_cat_prop_plot

Embed Interactive Categorical Plot (DEPRECATED!)

get_colour_palette

Provide A Colour Set for A Number of Requested Colours

get_indep_col_name

Get the name of the independent variable column

Pull global plotting settings before displaying plot

Wrapper Function for ggplot2::ggsave()

fig_height_h_barchart2

Estimate figure height for a horizontal bar chart

get_makeme_types

Get all registered options for the type-argument in the makeme-function

get_data_label_opts

Get Valid Data Labels for Figures and Tables

get_data_display_column

Determine display column based on data availability

filter_crowd_data

Filter and Prepare Data for a Specific Crowd

Helper function to extract raw variable labels from the data

get_indep_labels

Get independent variable labels

global_settings_reset

Reset Global Options for saros-functions

Method for Creating Saros Contents

global_settings_get

Get Global Options for saros-functions

initialize_crowd_filtering

Initialize Crowd-Based Filtering Data Structures

fig_height_h_barchart

Estimate figure height for a horizontal bar chart

ex_survey: Mockup dataset of a survey.

Are All Colours in Vector Valid Colours

calculate_indep_category_order

Calculate independent variable ordering based on a specific category value

calculate_column_order

Calculate ordering based on a specific column value

Obtain range of N for a given data set and other settings.

process_output_results

Process Output Results

embed_cat_table

Embed Reactable Table (DEPRECATED!)

process_table_data

Process data with standard table operations

Obtain range of N for a given ggobj.

global_settings_set

Get Global Options for saros-functions

handle_crowd_columns

Handle Kept and Omitted Columns for Crowds

generate_data_summary

Generate Appropriate Data Summary Based on Variable Types

generate_crowd_output

Generate Output for a Specific Crowd

embed_chr_table_html

Interactive table of text data (DEPRECATED)

calculate_indep_column_order

Calculate independent variable ordering based on a specific column value

setup_table_data

Setup table data from dots

shift_labels_always_at

Shift labels_always_at

normalize_makeme_arguments

Normalize Multi-Choice Arguments to Single Values

Save data to a file and return a Markdown link

process_categorical_na

Process categorical data for showNA settings

get_fig_title_suffix_from_ggplot

Generate Figure Title Suffix with N Range and Optional Download Links

make_link.default

Save data to a file and return a Markdown link

Identify Suitable Font Given Background Hex Colour

evaluate_variable_selection

Evaluate Variable Selection

post_process_makeme_data

Post-process Makeme Data (Legacy)

get_dep_display_column

Determine display column for dependent variables in int_plot_html

Save data to a file and return a Markdown link

Provides a range (or single value) for N in a ggplot2-object from makeme()

Provides a range (or single value) for N in data, given dep and indep

get_target_categories

Get target categories for positional sorting

Provide A Colour Set for A Number of Requested Colours

get_standard_column_renamer

Get standard column renaming function

summarize_data_by_type

Summarize Data Based on Variable Types

validate_type_specific_constraints

Perform Type-Specific Validation Checks

summarize_cat_cat_data

Summarize a survey dataset for use in tables and graphs

process_indep_factor_levels

Process Independent Variable Factor Levels

Embed Interactive Plot of Various Kinds Using Tidyselect Syntax

process_main_question_and_suffixes

Process main question and extract suffixes

txt_from_cat_mesos_plots

Extract Text Summary from Categorical Mesos Plots

process_all_crowds

Process All Crowds and Generate Output

validate_single_dep_var

Validate single dependent variable requirement

set_factor_levels_from_order

Set factor levels based on order columns (for backward compatibility)

setup_and_validate_makeme_args

Setup and Validate Makeme Arguments

process_crowd_settings

Process Crowd Settings

Read tabular data from various formats

Write tabular data to various formats

Code-snippets copied and modified from tidytext-package https://github.com/juliasilge/tidytext/blob/main/R/reorder_within.R

Given Ordered Integer Vector, Return Requested Set.

process_crowd_data

Process Data for a Single Crowd

process_global_indep_categories

Process Independent Categories for Global Hiding Logic

process_binary_category_colors

Process Binary Category Colors

Apply string wrapping to variables (character or factor)

resolve_variable_overlaps

Resolve Variable Overlaps Between Dependent and Independent Variables

reorder_crowd_array

Reorder Crowd Array Based on Hide Settings

initialize_arguments

Validate and Initialize Arguments

rename_crowd_outputs

Rename Crowd Outputs

round_numeric_stats

Round numeric statistics

saros: Semi-Automatic Reporting of Ordinary Surveys

arrange_table_data

Arrange output data by prespecified orders

add_sorting_order_vars

Create sorting order variables for output dataframe

calculate_indep_proportion_order

Calculate independent variable ordering based on position categories

apply_final_arrangement

Apply final arrangement based on order columns

auto_detect_makeme_type

Auto-Detect Appropriate Output Type Based on Variable Types

add_category_order

Add response category ordering (only useful for long format cat-cat tables)

Add dependent variable ordering

calculate_proportion_order

Calculate proportion-based ordering for dependent variables

apply_label_wrapping

Apply label wrapping based on plot layout

apply_legacy_sorting_adjustments

Apply legacy sorting adjustments for special cases

calculate_multiple_category_order

Calculate ordering based on multiple category values

add_indep_order

Add independent variable category ordering

calculate_indep_sum_value_order

Calculate independent variable ordering based on multiple category values

arrange_with_order

Apply sorting with optional descending order

calculate_category_order

Calculate ordering based on a specific category value

calculate_sum_value_order

Calculate ordering based on .sum_value (for category-based sorting)

crowd_plots_as_tabset

Convert List of Plots to Quarto Tabset

detect_variable_types

Detect Variable Types for Dependent and Independent Variables

determine_variable_basis

Determine variable column basis