NCA_fetch_state {ruminate}

Fetch ruminate State

Description

Merges default app options with the changes made in the UI

Usage

NCA_fetch_state(
  id,
  input,
  session,
  FM_yaml_file,
  MOD_yaml_file,
  id_ASM,
  id_UD,
  id_DW,
  react_state
)

Arguments

id

Shiny module ID

input

Shiny input variable

session

Shiny session variable

FM_yaml_file

App configuration file with FM as main section.

MOD_yaml_file

Module configuration file with MC as main section.

id_ASM

ID string for the app state management module used to save and load app states

id_UD

ID string for the upload data module used to save and load app states

id_DW

ID string for the data wrangling module used to save and load app states

react_state

Variable passed to server to allow reaction outside of module (NULL)

Value

list containing the current state of the app including default values from the yaml file as well as any changes made by the user. The list has the following structure:

• yaml: Full contents of the supplied yaml file.

• MC: Module components of the yaml file.

• NCA:

  • ana_cntr: Analysis counter.

  • anas: List of analyses: Each analysis has the following structure:

    • ana_dsview: Dataset view/ID (name from DSV) selected as a data source for this analysis.

    • ana_scenario: Analysis scenario selected in the UI

    • checksum: checksum of the analysis (used to detect changes in the analysis).

    • code: Code to generate analysis from start to finish or error messages if code generation/analysis failed.

    • code_components: List containing the different components from code

    • col_conc: Column from ana_dsview containing the concentration data.

    • col_dose: Column from ana_dsview containing the dose amount.

    • col_dur: Column from ana_dsview containing the infusion duration or N/A if unused.

    • col_group: Columns from ana_dsview containing other grouping variables.

    • col_id: Column from ana_dsview containing the subject IDs.

    • col_ntime: Column from ana_dsview containing the nominal time values

    • col_route: Column from ana_dsview containing the dosing route.

    • col_time: Column from ana_dsview containing the time values.

    • id: Character id (ana_idx).

    • idx: Numeric id (1).

    • include_units: Boolean variable indicating in units should included in the analysis.

    • interval_range: Vector with the first element representing he beginning of the interval and the second element containing the end of the interval.

    • intervals: List of the intervals to include.

    • isgood: Current status of the analysis.

    • key: Analysis key acts as a title/caption (user editable)

    • msgs: Messages generated when checking configuration and analysis options.

    • nca_config: List of NCA configuration options for this analysis.

    • nca_object_name: Prefix for NCA objects associated with this analyis.

    • nca_parameters: NCA parameters selected for calculation in the UI.

    • notes: Analysis notes (user editable)

    • objs: List of names and values for objects created with generated code.

    • sampling: Sampling method either "sparse" or "serial"

    • units_amt: Amount units.

    • units_conc: Concentration units.

    • units_dose: Dosing units.

    • units_time: Time units.

  • current_ana: Currently selected analysis (list name element from anas).

  • DSV: Available data source views (see FM_fetch_ds)

  • checksum: This is an MD5 sum of the module (checksum of the analysis checksums).

  • nca_config: List of PKNCA configuration options for this analysis.

  • nca_parameters: List with two elements

    • choices: List consisting of "Common Parameters" and "Other" (used for grouping in the UI). Each of these is a list of text parameter names with a value of the PKNCA parameter name.

    • summary: Summary table with the following columns:

      • parameter: PKNCA Paramter name.

      • text: Name used in text output.

      • md: Name used markdown output.

      • latex: Name used in latex output.

      • description: Verbose textual description of the parameter.

  • ui: Current value of form elements in the UI.

  • ui_ana_map: Map between UI element names and analysis in the object you get from NCA_fetch_current_ana

  • ui_ids: Vector of UI elements for the module.

  • ui_hold: List of hold elements to disable updates before a full ui referesh is complete.

• MOD_TYPE: Character data containing the type of module "NCA"

• id: Character data containing the module id module in the session variable.

• FM_yaml_file: App configuration file with FM as main section.

• MOD_yaml_file: Module configuration file with MC as main section.

Examples

library(ruminate)
# Module IDs                                                                   
id     = "NCA"                                                                 
id_UD  = "UD"                                                                  
id_DW  = "DW"                                                                  
id_ASM = "ASM"                                                                 
# We need session and input variables to be define                             
 sess_res = NCA_test_mksession(session=list(),                                 
      id     = id,                                                             
      id_UD  = id_UD,                                                          
      id_DW  = id_DW,                                                          
      id_ASM = id_ASM,
      full_session=FALSE)
                                                                               
# Extracting the session and input variables                                   
session      = sess_res$session                                                
input        = sess_res$input                                                  
react_state  = list()                                                          
                                                                               
# We also need configuration files                                             
FM_yaml_file  = system.file(package = "formods",  "templates", "formods.yaml") 
MOD_yaml_file = system.file(package = "ruminate", "templates", "NCA.yaml")     
                                                                               
# Getting the current module state                                             
state = NCA_fetch_state(id             = id,                                   
                       input           = input,                                
                       session         = session,                              
                       FM_yaml_file    = FM_yaml_file,                         
                       MOD_yaml_file   = MOD_yaml_file,                        
                       id_ASM          = id_ASM,                               
                       id_UD           = id_UD,                                
                       id_DW           = id_DW,                                
                       react_state     = react_state)                          
                                                                               
# Pulls out the active analysis                                                
current_ana = NCA_fetch_current_ana(state)

# This will get the dataset associated with this analysis
ds = NCA_fetch_ana_ds(state, current_ana)

# After making changes you can update those in the state
state = NCA_set_current_ana(state, current_ana)

# You can use this to check the current analysis
current_ana = NCA_process_current_ana(state)

# This will pull out the code for the module
fc_res = NCA_fetch_code(state)

# This will use patterns defined for the site to detect
# columns. In this example we are detecting the id column:
id_col = NCA_find_col(
  patterns = state[["MC"]][["detect_col"]][["id"]],
  dscols   = names(ds$DS))

# This creates a new analysis
state = NCA_new_ana(state)