Package: stepssurvey 0.1.0

stepssurvey: Analyse WHO STEPS Survey Data

Provides a complete analysis pipeline for the WHO STEPwise Approach to NCD Risk Factor Surveillance (STEPS) as described in Riley et al. (2016) <doi:10.2105/AJPH.2015.302962>. Imports raw survey data ('CSV', 'Excel', 'Stata', 'SPSS'), applies WHO-standard cleaning and recoding, sets up complex survey designs, computes all standard NCD indicators (tobacco, alcohol, diet, physical activity, anthropometry, blood pressure, biochemical), and generates publication-ready tables, visualisations, and 'Word'/'HTML' reports (fact sheet, data book, country report).

Authors:Abhijit Pakhare [aut, cre], Ankur Joshi [aut], Lena Charlette [aut], WHO STEPS R Pipeline Contributors [ctb]

stepssurvey_0.1.0.tar.gz
stepssurvey_0.1.0.zip(r-4.7)stepssurvey_0.1.0.zip(r-4.6)stepssurvey_0.1.0.zip(r-4.5)
stepssurvey_0.1.0.tgz(r-4.6-any)stepssurvey_0.1.0.tgz(r-4.5-any)
stepssurvey_0.1.0.tar.gz(r-4.7-any)stepssurvey_0.1.0.tar.gz(r-4.6-any)
stepssurvey_0.1.0.tgz(r-4.6-emscripten)
manual.pdf |manual.html✨
DESCRIPTION |NEWS
card.svg |card.png
stepssurvey/json (API)

# Install 'stepssurvey' in R:
install.packages('stepssurvey', repos = c('https://drpakhare.r-universe.dev', 'https://cloud.r-project.org'))

Bug tracker:https://github.com/drpakhare/stepssurvey/issues

On CRAN:

Conda:

4.20 score 10 scripts 544 downloads 42 exports 108 dependencies

Last updated from:dcac8e28d8. Checks:9 OK. Indexed: yes.

TargetResultTimeFilesSyslog
linux-devel-x86_64OK177
source / vignettesOK247
linux-release-x86_64OK185
macos-release-arm64OK116
macos-oldrel-arm64OK136
windows-develOK121
windows-releaseOK121
windows-oldrelOK120
wasm-releaseOK136

Exports:build_all_tablesbuild_forest_plotbuild_radar_plotbuild_steps_plotsbuild_steps_tablesbuild_tableclean_steps_datacompute_alcohol_indicatorscompute_all_indicatorscompute_all_tablescompute_anthropometry_indicatorscompute_biochemical_indicatorscompute_bp_indicatorscompute_diet_pa_indicatorscompute_tablecompute_tobacco_indicatorsdetect_coldetect_steps_columnsgenerate_test_dataget_registry_by_sectionget_registry_by_stepimport_steps_datalist_registry_sectionsplot_completenessplot_digit_preferenceplot_weightsread_column_mappingrecode_ynrender_country_reportrender_data_bookrender_fact_sheetrun_apprun_steps_pipelinesave_steps_plotssetup_survey_designsteps_colorssteps_configsteps_data_qualitysteps_table_registrysvymnsvyproptheme_steps

Dependencies:askpassbase64encbitbit64bslibcachemcellrangerclicliprcommonmarkcpp11crayoncrosstalkdata.tableDBIdigestdplyrDTevaluatefarverfastmapflextablefontawesomefontBitstreamVerafontLiberationfontquiverforcatsfsgdtoolsgenericsggplot2gluegtablehavenhighrhmshtmltoolshtmlwidgetshttpuvisobandjanitorjquerylibjsonliteknitrlabelinglaterlatticelazyevallifecyclelubridatemagrittrMatrixmemoisemimeminqamitoolsnumDerivofficeropensslotelpatchworkpillarpkgconfigprettyunitsprogresspromisespurrrR6raggrappdirsRColorBrewerRcppRcppArmadilloreadrreadxlrematchrlangrmarkdownS7sassscalesshinysnakecasesourcetoolsstringistringrsurveysurvivalsyssystemfontstextshapingtibbletidyrtidyselecttimechangetinytextzdbutf8uuidvctrsviridisLitevroomwithrxfunxml2xtableyamlzip

Analysing WHO STEPS Survey Data with stepssurvey
Introduction | What this guide covers | Installation | The pipeline at a glance | Step 1: Generate or import data | Using the built-in test data generator | Importing real STEPS data | Step 2: Auto-detect STEPS variables | Version 3.1 vs 3.2 variable codes | Column mapping for non-standard datasets | Step 3: Clean and derive indicators | What the cleaning step does | Configurable indicator thresholds | Step 3b: Data quality diagnostics | Step 4: Set up the survey design | Step 5: Compute indicators | All indicators at once | Domain-specific functions | Custom weighted estimates | Step 6: Build publication-ready tables | Summary tables (Both Sexes only) | Detailed WHO 3-panel tables (Men | Women | Both Sexes) | Step 7: Create visualisations | Overview chart | Sex-stratified dashboard | Age-stratified trends | Forest plot | Risk profile radar chart | Saving plots | WHO STEPS colour palette and theme | Step 8: Generate Word reports | What each report contains | One-command pipeline | Working with real STEPS data | Preparing your data file | Handling custom variable names | Adjusting age range | Complete worked example | Interactive Shiny app | WHO standard definitions used | FAQ | Further resources | Session info
Rendered fromstepssurvey-guide.Rmdusingknitr::rmarkdown

Last update: 2026-05-06
Started: 2026-04-06

Preparing STEPS Data for Analysis
Introduction | Supported file formats | Minimum required variables | Essential (required) | Strongly recommended | Step 1: Behavioural risk factors | Step 2: Physical measurements | Step 3: Biochemical measurements | Health history (H-codes) | How auto-detection works | Common data issues and solutions | Issue: Sex coded as numeric without labels | Issue: Yes/No variables coded inconsistently | Issue: Glucose values in mg/dL instead of mmol/L | Issue: Multiple datasets for different STEPS steps | Issue: Missing sampling weights | Issue: Variables detected as wrong type | Pre-flight checklist | Quick diagnostic script | Further reading
Rendered fromdata-preparation.Rmdusingknitr::rmarkdown

Last update: 2026-05-06
Started: 2026-04-06

Validation Against WHO Official Fact Sheets
Acknowledgements | Overview | Validation criteria | Indicators compared | Results summary | Detailed results by country | Moldova 2021 | Mongolia 2019 | Georgia 2016 | Afghanistan 2018 | Algeria 2016 | Ukraine 2019 | Ecuador 2018 | Cabo Verde 2020 | Bahamas 2019 | Analysis of mismatches | Key methodological alignments | Running the validation yourself | Reproducibility notes | References
Rendered fromvalidation.Rmdusingknitr::rmarkdown

Last update: 2026-05-06
Started: 2026-04-30

Interactive Analysis with the Shiny App
Overview | Launching the app | Tab 1: Data & Settings | Uploading a data file | Using demo data | Column overrides | Survey settings | Tab 2: Clean | Tab 3: Design | Tab 4: Indicators | Tab 5: Visualise | Available charts | Tab 6: Reports | What happens when you click Generate | Two reports | Summary Report | Detailed Data Book | Additional downloads | Tips and troubleshooting | The app shows an error on upload | Charts don't display or show "figure margins too large" | Physical Activity shows "not available" | Some tables are empty in the Data Book | Can I customise the report templates? | Comparison: Shiny app vs R scripting
Rendered fromshiny-walkthrough.Rmdusingknitr::rmarkdown

Last update: 2026-04-06
Started: 2026-04-06

Readme and manuals

Help Manual

Help pageTopics
stepssurvey: Analyse WHO STEPS Survey Datastepssurvey-package stepssurvey
Build all tables from computed resultsbuild_all_tables
Build forest plot of key indicators with 95% CIsbuild_forest_plot
Build radar / spider chart of NCD risk factor profilebuild_radar_plot
Build publication-ready STEPS visualizationsbuild_steps_plots
Build survey-weighted tables for STEPS indicatorsbuild_steps_tables
Build a formatted table from a computed resultbuild_table
Clean and recode WHO STEPS dataclean_steps_data
Compute Alcohol Use Indicatorscompute_alcohol_indicators
Compute All STEPS Indicatorscompute_all_indicators
Compute all tables from the registrycompute_all_tables
Compute Anthropometry Indicatorscompute_anthropometry_indicators
Compute Biochemical Indicatorscompute_biochemical_indicators
Compute Blood Pressure Indicatorscompute_bp_indicators
Compute Diet and Physical Activity Indicatorscompute_diet_pa_indicators
Generic Compute Engine for WHO STEPS Tablescompute_engine
Compute a single table from a registry entrycompute_table
Compute Tobacco Use Indicatorscompute_tobacco_indicators
Detect a STEPS column by aliasdetect_col
Auto-detect all standard STEPS columnsdetect_steps_columns
Generate simulated STEPS test datagenerate_test_data
Get table registry entries by sectionget_registry_by_section
Get table registry entries by stepget_registry_by_step
Import raw STEPS survey dataimport_steps_data
List all available sections in the registrylist_registry_sections
Plot completeness heatmap across STEPS domainsplot_completeness
Plot digit preference histogram for a physical measurementplot_digit_preference
Plot sampling weight distributionplot_weights
Read a column mapping fileread_column_mapping
Render STEPS Country Reportrender_country_report
Render STEPS Data Book reportrender_data_book
Render STEPS Fact Sheet reportrender_fact_sheet
Launch the stepssurvey Shiny Applicationrun_app
Run the complete STEPS analysis pipelinerun_steps_pipeline
Save STEPS plots to PNG filessave_steps_plots
Set up survey designs for STEPS data (one per Step)setup_survey_design
WHO STEPS colour palettesteps_colors
Create STEPS analysis configurationsteps_config
Data Quality Diagnostics for WHO STEPS Datasteps_data_quality
WHO STEPS Data Book Table Registrysteps_table_registry
Weighted mean estimation with 95% CIsvymn
Weighted proportion estimation with 95% CIsvyprop
Generic Table Builder for WHO STEPS Data Booktable_builder
WHO STEPS ggplot2 themetheme_steps