• Language: en

Files Generated by Gen Script

This section discusses how the Gen Script saves files to disk, you can see an example in Generate a Two Compartment PopPK Data Set. After running a gen script, named ‘my_gen_script.pyml’, using the command:-

$ popy_run my_gen_script.pyml

the output folder ‘my_gen_script.pyml_output’ will be created as follows:-

my_gen_script.pyml_output/
    gen/
    sim/
    sum/

where

  • gen contains the results of running the Gen Script
  • sim contains the results of running Sim Script to create smoother profile curves and
  • sum is a html summary of the generated data.

The Gen Script also creates a log file my_gen_script.pyml.run.main.log that stores the output to the command prompt.

Gen Folder Output

The gen folder has the following contents:-

builtin_gen_example_gen.pyml_output/
    gen/
        _temp/
        clean_sol/
        noisy_sol/
        compartment_diagram.dot
        compartment_diagram.svg
        dupe_covars_data.csv
        synthetic_data.csv

Here ‘_temp’ is a temporary folder used by PoPy. The file ‘dupe_covars_data.csv’ is an intermediate file.

A compartment diagram is created in .svg format. The .dot file is the Graphviz file, used to create the .svg file. You can see an example compartment diagram in Fig. 42.

The ‘clean_sol’ folder contains a solution with no noise added. The ‘noisy_sol’ contains as solution with measurement noise added. For example the ‘noisy_sol’ folder contains these files:-

builtin_gen_example_gen.pyml_output/
    gen/
        noisy_sol/
            fx_params.csv
            mx_params.csv
            rx_params.csv
            solution.pyml
            sx_params.csv
            synthetic_data.csv

Here the key file is ‘synthetic_data.csv’, which is the full synthetic data file generated for this population. The other files represent intermediate variables for each time point, see Files Generated by Sim Script for more information.

Note the ‘synthetic_data.csv’ file is also output to this location, for easier access:-

builtin_gen_example_gen.pyml_output/
    gen/
        synthetic_data.csv

It is the main data file created by the Gen Script.

Naming of child scripts

Each child script file name is based on the following entry, in the parent Gen Script:-

DESCRIPTION: {name: <gen_name>}

This naming convention for output folders and generated scripts is followed by all Script File Formats in PoPy.

Gen Sim Folder Output

The Gen Script creates the following Sim Script:-

my_gen_script.pyml_output/
    sim/
        <gen_name>_sim.pyml

This Sim Script plots smooth PK curves to visualise the f[X] parameters sampled by the Gen Script. See Files Generated by Sim Script for more details.

Gen Sum Folder Output

The Gen Script creates the following GenSum Script:-

my_gen_script.pyml_output/
    sum/
        <gen_name>_gensum.pyml

The GenSum Script creates html output that summaries the gen and sim folders. See Files Generated by Gensum Script for more details.

Back to Top