Skip to contents

Launch a single-page PTI Shiny app

launch_pti_onepage.Rd

Starts a stand-alone PTI app with one page – the weights input, the calculated index, and the leaflet map living together in either a two-column or a box layout. Use this for a focused viewer when no compare or explorer tabs are needed; for the multi-tab experience use [launch_pti()].

Usage

launch_pti_onepage(
  shp_dta,
  inp_dta,
  ui_type = c("twocol", "box"),
  app_name = NULL,
  show_waiter = TRUE,
  show_adm_levels = NULL,
  wt_dwnld_options = c("data", "weights", "shapes", "metadata"),
  map_dwnld_options = c("shapes", "metadata"),
  shapes_path = NULL,
  mtdtpdf_path = NULL,
  map_height = "calc(100vh)",
  dt_style = "zoom:1; height: calc(95vh - 250px);",
  ...
)

Arguments

shp_dta

Named list of `sf` tibbles, one per admin level (e.g. the bundled [ukr_shp]). Each element must carry the `adminNPcod` / `adminNName` / `geometry` columns.

inp_dta

Named list of metadata tibbles in the package format (e.g. the bundled [ukr_mtdt_full]); typically built by [fct_template_reader()].

ui_type

Character. Either `"twocol"` (default) for the side-by-side weights / map layout or `"box"` for the boxed layout. Only the first element is used.

app_name

Character or `NULL`. Title shown in the browser tab and used as the waiter spinner label.

show_waiter

Logical. If `TRUE` (default) a loading spinner covers the page until the first map render completes.

show_adm_levels

Optional character vector restricting which admin levels appear in the level selector. `NULL` (default) shows every level present in `shp_dta`.

wt_dwnld_options

Character vector of weights-tab download buttons to expose. Subset of `c("data", "weights", "shapes", "metadata")`.

map_dwnld_options

Character vector of map-tab download buttons. Subset of `c("shapes", "metadata")`. Forced to `NULL` when `ui_type = "box"`.

shapes_path, mtdtpdf_path

Character or `NULL`. Filesystem paths served by the download handlers. When `shapes_path` is `NULL` (the default), `shp_dta` is auto-written to a tempfile so the "Download shapes" button serves the in-memory data as an `.rds`. When `mtdtpdf_path` is `NULL` (the default), the metadata PDF link is disabled (no in-memory equivalent to materialize). To serve a specific source file, pass the path explicitly.

map_height, dt_style

CSS strings forwarded to the map container and the weights DataTable respectively.

...

Additional arguments forwarded to [mod_ptipage_newsrv()] and to [golem::with_golem_options()].

Value

A [shiny::shinyApp()] object wrapped in [golem::with_golem_options()]. Called primarily for its side effect of starting the Shiny app.

See also

Other pti-launch: create_new_pti(), launch_pti()

Examples

if (FALSE) { # \dontrun{
launch_pti_onepage(shp_dta = rwa_shp, inp_dta = rwa_mtdt_full)

launch_pti_onepage(shp_dta = rwa_shp,
                   inp_dta = rwa_mtdt_full,
                   ui_type = "box",
                   show_waiter = FALSE)
} # }