OpenPBEE · hgp297 · Feb 18, 2026 · Feb 19, 2026 · Feb 19, 2026 · Feb 24, 2026
diff --git a/README.md b/README.md
@@ -40,6 +40,8 @@ You should see the command help output with available options.
 
 An assessment can be run directly from the command line, or as imported within a Python workflow. If `simulated_inputs.json` does not exist, it will be created using default inputs within `src/atc138/data`. Various assessment options can be overridden by placing them in file `optional_inputs.json` file within the input directory. This file can be customized for each assessment if desired and will be set as default values if not specified.
 
+If `simulated_inputs.json` exists, the input builder will not re-run unless `--force_rebuild` is used in the CLI command.
+
 ### Running from the command line
 
 With the input directory containing the necessary inputs, perform an assessment by running:
@@ -67,6 +69,24 @@ output_dir = './examples/ICSB/output'
 driver.run_analysis(example_dir, output_dir, seed=985)
 ```
 
+If `simulated_inputs.json` exists, the input builder will not re-run unless the argument `force_rebuild=True` is used for `driver.run_analysis`.
+
+### Plotting outputs
+
+Several basic plotting tools are provided in `plotters/`, which can be used after an analysis generates results. This is run with
+
+```python
+from plotters.main_plot_functionality import plot_results
+output_dir = './examples/ICSB/output'
+plot_results(output_dir, p_gantt=50) # plot median realization
+```
+
+which will plot:
+- Component and system-level breakdowns of hinderance to reoccupancy and functional status per day
+- Distribution of realizations achieving reoccupancy and functional status per day
+- Mean and per-realization breakdown of recovery trajectories
+- Gantt chart of impeding factors, repair work, number of workers, and recovery status of building per day for the realization with  `p_gantt`-th percentile of functional recovery day. 
+
 ## Example Inputs
 Four example inputs are provided to help illustrate both the construction of the inputs file and the implementation. These files are located in the `examples/` directory and can be run through the assessment by setting the variable names accordingly above.
 
@@ -135,7 +155,6 @@ The file(s) listed below contain data that is optional for the assessment. If th
 The Python file listed below defines additional assessment inputs based on set of default values. Place this file in the input directory of your analysis.
  - **optional_inputs.json**: Defines default variables for the impedance_options, repair_time_options, functionality_options, and regional_impact variables listed in the inputs schema.
 
-<!-- How does a user modify the static tables (now data) without touching the original data files? -->
 
 ### Static Data
 The csv tables listed below contain default component, damage state, system, and tenant function attributes that can be used to populate the required assessment inputs according to the methodology. These are located in the _data_ directory. To override the static data with custom versions, copy modified sheets and place them in the input directory.
@@ -145,3 +164,29 @@ The csv tables listed below contain default component, damage state, system, and
  - **tenant_function_requirements.csv**: Default tenant requirements for function for various occupancy classes.
  - **systems.csv**: Attributes of each default ssytem considered in the method.
  - **temp_repair_class.csv**: Attributes of each temprary repair class considered in the method.
+
+## Building from Pelicun outputs
+This conversion module is compatible with PBE Application version ~=4.4 and pelicun~=3.5. To build and rebuild raw ATC-138 input files from Pelicun outputs, ensure that simulated_inputs.json does not currently exist in the model directory. Then, the following Pelicun files are required as input:
+ - **CMP_QNT.csv**: component sheet
+ - **DL_summary.csv**: summary of damage and loss, to read in irreparable cases
+ - **DMG_sample.csv**: damage sample of all realizations
+ - **DV_repair_sample.csv**: decision variable sample of all realizations. The legacy name **DV_bldg_repair_sample.csv** is supported as a fallback name.
+ - **general_inputs.json**: egress, occupancy, dimensions, ratio of engineering cost as a fraction of total repair cost. Number of elevators or stairs per story can also be explicitly specified here if it is desired to override the quantity in CMP_QNT.
+ - **input.json**: JSON file with number of stories, replacement cost, plan area
+ - **side_damage_ratio.csv** (optional): CSV of size num_reals x 2, specifies the damage distributed to each side for cladding components. This fraction is constant across the height of the building. Column 1 is the fraction of damaged components in direction 0, side 1. Column 2 is the fraction of damaged components in direction 1, side 1. These should sum up to 0.5. Parallel sides will have the same fraction of damage. If not provided, these ratios will be sampled uniformly for all realizations.
+
+Additionally, the following inputs are required similar to the raw build procedure, but are not generated by Pelicun:
+ - **tenant_unit_list.csv**
+
+Then, the either the CLI or import method can be used to run the analysis as before, which will detect the presence of Pelicun files to use as build inputs. An example is provided in the model directory `RCSW_4story_pelicun`.
+
+_Cladding damage:_ Current implementation of Pelicun inputs will randomly distribute the damage across 4 sides of the building for the purpose of cladding damage assignment. Custom side-assignment is planned for a future implementation.
+
+```python
+from src.atc138 import driver
+
+example_dir = './examples/RCSW_4story_pelicun'
+output_dir = './examples/RCSW_4story_pelicun/output'
+
+driver.run_analysis(example_dir, output_dir, seed=985)
+```
diff --git a/examples/RCSW_4story_pelicun/CMP_QNT.csv b/examples/RCSW_4story_pelicun/CMP_QNT.csv
@@ -0,0 +1,92 @@
+ID,Units,Location,Direction,Theta_0,Blocks,Family,Theta_1,Comment
+B.20.22.001,SF,4,"1,2",4320,144,,0.6,"B2022.001    Curtain Walls - Generic Midrise Stick-Built Curtain wall, Config: Monolithic, Lamination: Unknown, Glass Type: Unknown, Details: Aspect ratio = 6:5,  Other details Unknown"
+B.30.11.011,SF,4,0,3888,38,,1.3,"B3011.011    Concrete tile roof, tiles secured and compliant with UBC94"
+C.10.11.001a,LF,4,"1,2",1440,14,,0.2,"C1011.001a    Wall Partition, Type: Gypsum with metal studs, Full Height, Fixed Below, Fixed Above"
+C.30.11.001a,LF,4,"1,2",108.9,1,,0.7,"C3011.001a    Wall Partition, Type: Gypsum + Wallpaper, Full Height, Fixed Below, Fixed Above"
+C.30.27.001,SF,4,0,10800,108,,0.2,"C3027.001    Raised Access Floor, non seismically rated."
+C.30.32.001a,SF,4,0,12960,51,,0,"C3032.001a    Suspended Ceiling, SDC A,B,C, Area (A): A < 250, Vert support only"
+C.30.32.001a,SF,4,0,720,2,,0,"C3032.001a    Suspended Ceiling, SDC A,B,C, Area (A): A < 250, Vert support only"
+C.30.32.001a,SF,4,0,432,1,,0,"C3032.001a    Suspended Ceiling, SDC A,B,C, Area (A): A < 250, Vert support only"
+C.30.32.001a,SF,4,0,288,1,,0,"C3032.001a    Suspended Ceiling, SDC A,B,C, Area (A): A < 250, Vert support only"
+D.20.21.011a,LF,4,0,604.8,1,,0.7,"D2021.011a    Cold or Hot Potable  - Small Diameter Threaded Steel - (2.5 inches in diameter or less), SDC A or B, PIPING FRAGILITY"
+D.30.41.012a,LF,4,0,288,1,,0.2,"D3041.012a    HVAC Galvanized Sheet Metal Ducting -  6 sq. ft cross sectional area or greater, SDC A or B"
+D.30.41.011a,LF,4,0,1080,1,,0.2,"D3041.011a    HVAC Galvanized Sheet Metal Ducting less than 6 sq. ft in cross sectional area, SDC A or B"
+D.30.41.031a,EA,4,0,129.6,12,,0.5,"D3041.031a    HVAC Drops / Diffusers in suspended ceilings - No independent safety wires, SDC A or B"
+D.30.41.041a,EA,4,0,72,7,,0.2,"D3041.041a    Variable Air Volume (VAV) box with in-line coil, SDC A or B"
+D.30.41.041a,EA,4,0,28.8,2,,0.5,"D3041.041a    Variable Air Volume (VAV) box with in-line coil, SDC A or B"
+C.30.34.001,EA,4,0,216,216,,0.3,C3034.001    Independent Pendant Lighting - non seismic
+C.30.34.001,EA,4,0,216,216,,0.3,C3034.001    Independent Pendant Lighting - non seismic
+D.40.11.021a,LF,4,0,2880,2,,0.1,"D4011.021a    Fire Sprinkler Water Piping - Horizontal Mains and Branches - Old Style Victaulic - Thin Wall Steel - No bracing, SDC A or B, PIPING FRAGILITY"
+D.40.11.031a,EA,4,0,129.6,1,,0.2,"D4011.031a    Fire Sprinkler Drop Standard Threaded Steel - Dropping into unbraced lay-in tile SOFT ceiling - 6 ft. long drop maximum, SDC A or B"
+B.20.22.001,SF,3,"1,2",4320,144,,0.6,"B2022.001    Curtain Walls - Generic Midrise Stick-Built Curtain wall, Config: Monolithic, Lamination: Unknown, Glass Type: Unknown, Details: Aspect ratio = 6:5,  Other details Unknown"
+B.30.11.011,SF,3,0,3888,38,,1.3,"B3011.011    Concrete tile roof, tiles secured and compliant with UBC94"
+C.10.11.001a,LF,3,"1,2",1440,14,,0.2,"C1011.001a    Wall Partition, Type: Gypsum with metal studs, Full Height, Fixed Below, Fixed Above"
+C.30.11.001a,LF,3,"1,2",108.9,1,,0.7,"C3011.001a    Wall Partition, Type: Gypsum + Wallpaper, Full Height, Fixed Below, Fixed Above"
+C.30.27.001,SF,3,0,10800,108,,0.2,"C3027.001    Raised Access Floor, non seismically rated."
+C.30.32.001a,SF,3,0,12960,51,,0,"C3032.001a    Suspended Ceiling, SDC A,B,C, Area (A): A < 250, Vert support only"
+C.30.32.001a,SF,3,0,720,2,,0,"C3032.001a    Suspended Ceiling, SDC A,B,C, Area (A): A < 250, Vert support only"
+C.30.32.001a,SF,3,0,432,1,,0,"C3032.001a    Suspended Ceiling, SDC A,B,C, Area (A): A < 250, Vert support only"
+C.30.32.001a,SF,3,0,288,1,,0,"C3032.001a    Suspended Ceiling, SDC A,B,C, Area (A): A < 250, Vert support only"
+D.20.21.011a,LF,3,0,604.8,1,,0.7,"D2021.011a    Cold or Hot Potable  - Small Diameter Threaded Steel - (2.5 inches in diameter or less), SDC A or B, PIPING FRAGILITY"
+D.30.41.012a,LF,3,0,288,1,,0.2,"D3041.012a    HVAC Galvanized Sheet Metal Ducting -  6 sq. ft cross sectional area or greater, SDC A or B"
+D.30.41.011a,LF,3,0,1080,1,,0.2,"D3041.011a    HVAC Galvanized Sheet Metal Ducting less than 6 sq. ft in cross sectional area, SDC A or B"
+D.30.41.031a,EA,3,0,129.6,12,,0.5,"D3041.031a    HVAC Drops / Diffusers in suspended ceilings - No independent safety wires, SDC A or B"
+D.30.41.041a,EA,3,0,72,7,,0.2,"D3041.041a    Variable Air Volume (VAV) box with in-line coil, SDC A or B"
+D.30.41.041a,EA,3,0,28.8,2,,0.5,"D3041.041a    Variable Air Volume (VAV) box with in-line coil, SDC A or B"
+C.30.34.001,EA,3,0,216,216,,0.3,C3034.001    Independent Pendant Lighting - non seismic
+C.30.34.001,EA,3,0,216,216,,0.3,C3034.001    Independent Pendant Lighting - non seismic
+D.40.11.021a,LF,3,0,2880,2,,0.1,"D4011.021a    Fire Sprinkler Water Piping - Horizontal Mains and Branches - Old Style Victaulic - Thin Wall Steel - No bracing, SDC A or B, PIPING FRAGILITY"
+D.40.11.031a,EA,3,0,129.6,1,,0.2,"D4011.031a    Fire Sprinkler Drop Standard Threaded Steel - Dropping into unbraced lay-in tile SOFT ceiling - 6 ft. long drop maximum, SDC A or B"
+B.20.22.001,SF,2,"1,2",4320,144,,0.6,"B2022.001    Curtain Walls - Generic Midrise Stick-Built Curtain wall, Config: Monolithic, Lamination: Unknown, Glass Type: Unknown, Details: Aspect ratio = 6:5,  Other details Unknown"
+B.30.11.011,SF,2,0,3888,38,,1.3,"B3011.011    Concrete tile roof, tiles secured and compliant with UBC94"
+C.10.11.001a,LF,2,"1,2",1440,14,,0.2,"C1011.001a    Wall Partition, Type: Gypsum with metal studs, Full Height, Fixed Below, Fixed Above"
+C.30.11.001a,LF,2,"1,2",108.9,1,,0.7,"C3011.001a    Wall Partition, Type: Gypsum + Wallpaper, Full Height, Fixed Below, Fixed Above"
+C.30.27.001,SF,2,0,10800,108,,0.2,"C3027.001    Raised Access Floor, non seismically rated."
+C.30.32.001a,SF,2,0,12960,51,,0,"C3032.001a    Suspended Ceiling, SDC A,B,C, Area (A): A < 250, Vert support only"
+C.30.32.001a,SF,2,0,720,2,,0,"C3032.001a    Suspended Ceiling, SDC A,B,C, Area (A): A < 250, Vert support only"
+C.30.32.001a,SF,2,0,432,1,,0,"C3032.001a    Suspended Ceiling, SDC A,B,C, Area (A): A < 250, Vert support only"
+C.30.32.001a,SF,2,0,288,1,,0,"C3032.001a    Suspended Ceiling, SDC A,B,C, Area (A): A < 250, Vert support only"
+D.20.21.011a,LF,2,0,604.8,1,,0.7,"D2021.011a    Cold or Hot Potable  - Small Diameter Threaded Steel - (2.5 inches in diameter or less), SDC A or B, PIPING FRAGILITY"
+D.30.41.012a,LF,2,0,288,1,,0.2,"D3041.012a    HVAC Galvanized Sheet Metal Ducting -  6 sq. ft cross sectional area or greater, SDC A or B"
+D.30.41.011a,LF,2,0,1080,1,,0.2,"D3041.011a    HVAC Galvanized Sheet Metal Ducting less than 6 sq. ft in cross sectional area, SDC A or B"
+D.30.41.031a,EA,2,0,129.6,12,,0.5,"D3041.031a    HVAC Drops / Diffusers in suspended ceilings - No independent safety wires, SDC A or B"
+D.30.41.041a,EA,2,0,72,7,,0.2,"D3041.041a    Variable Air Volume (VAV) box with in-line coil, SDC A or B"
+D.30.41.041a,EA,2,0,28.8,2,,0.5,"D3041.041a    Variable Air Volume (VAV) box with in-line coil, SDC A or B"
+C.30.34.001,EA,2,0,216,216,,0.3,C3034.001    Independent Pendant Lighting - non seismic
+C.30.34.001,EA,2,0,216,216,,0.3,C3034.001    Independent Pendant Lighting - non seismic
+D.40.11.021a,LF,2,0,2880,2,,0.1,"D4011.021a    Fire Sprinkler Water Piping - Horizontal Mains and Branches - Old Style Victaulic - Thin Wall Steel - No bracing, SDC A or B, PIPING FRAGILITY"
+D.40.11.031a,EA,2,0,129.6,1,,0.2,"D4011.031a    Fire Sprinkler Drop Standard Threaded Steel - Dropping into unbraced lay-in tile SOFT ceiling - 6 ft. long drop maximum, SDC A or B"
+B.20.22.001,SF,1,"1,2",4320,144,,0.6,"B2022.001    Curtain Walls - Generic Midrise Stick-Built Curtain wall, Config: Monolithic, Lamination: Unknown, Glass Type: Unknown, Details: Aspect ratio = 6:5,  Other details Unknown"
+B.30.11.011,SF,1,0,3888,38,,1.3,"B3011.011    Concrete tile roof, tiles secured and compliant with UBC94"
+C.10.11.001a,LF,1,"1,2",1440,14,,0.2,"C1011.001a    Wall Partition, Type: Gypsum with metal studs, Full Height, Fixed Below, Fixed Above"
+C.30.11.001a,LF,1,"1,2",108.9,1,,0.7,"C3011.001a    Wall Partition, Type: Gypsum + Wallpaper, Full Height, Fixed Below, Fixed Above"
+C.30.27.001,SF,1,0,10800,108,,0.2,"C3027.001    Raised Access Floor, non seismically rated."
+C.30.32.001a,SF,1,0,12960,51,,0,"C3032.001a    Suspended Ceiling, SDC A,B,C, Area (A): A < 250, Vert support only"
+C.30.32.001a,SF,1,0,720,2,,0,"C3032.001a    Suspended Ceiling, SDC A,B,C, Area (A): A < 250, Vert support only"
+C.30.32.001a,SF,1,0,432,1,,0,"C3032.001a    Suspended Ceiling, SDC A,B,C, Area (A): A < 250, Vert support only"
+C.30.32.001a,SF,1,0,288,1,,0,"C3032.001a    Suspended Ceiling, SDC A,B,C, Area (A): A < 250, Vert support only"
+D.20.21.011a,LF,1,0,604.8,1,,0.7,"D2021.011a    Cold or Hot Potable  - Small Diameter Threaded Steel - (2.5 inches in diameter or less), SDC A or B, PIPING FRAGILITY"
+D.30.41.012a,LF,1,0,288,1,,0.2,"D3041.012a    HVAC Galvanized Sheet Metal Ducting -  6 sq. ft cross sectional area or greater, SDC A or B"
+D.30.41.011a,LF,1,0,1080,1,,0.2,"D3041.011a    HVAC Galvanized Sheet Metal Ducting less than 6 sq. ft in cross sectional area, SDC A or B"
+D.30.41.031a,EA,1,0,129.6,12,,0.5,"D3041.031a    HVAC Drops / Diffusers in suspended ceilings - No independent safety wires, SDC A or B"
+D.30.41.041a,EA,1,0,72,7,,0.2,"D3041.041a    Variable Air Volume (VAV) box with in-line coil, SDC A or B"
+D.30.41.041a,EA,1,0,28.8,2,,0.5,"D3041.041a    Variable Air Volume (VAV) box with in-line coil, SDC A or B"
+C.30.34.001,EA,1,0,216,216,,0.3,C3034.001    Independent Pendant Lighting - non seismic
+C.30.34.001,EA,1,0,216,216,,0.3,C3034.001    Independent Pendant Lighting - non seismic
+D.40.11.021a,LF,1,0,2880,2,,0.1,"D4011.021a    Fire Sprinkler Water Piping - Horizontal Mains and Branches - Old Style Victaulic - Thin Wall Steel - No bracing, SDC A or B, PIPING FRAGILITY"
+D.40.11.031a,EA,1,0,129.6,1,,0.2,"D4011.031a    Fire Sprinkler Drop Standard Threaded Steel - Dropping into unbraced lay-in tile SOFT ceiling - 6 ft. long drop maximum, SDC A or B"
+C.20.11.001a,EA,4,"1,2",2.9,2,,0.2,C2011.001a    Prefabricated steel stair with steel treads and landings with seismic joints that accommodate drift.
+D.50.12.021a,EA,4,0,1,1,,0.4,D5012.021a    Low Voltage Switchgear - Capacity: 100 to <350 Amp - Unanchored equipment that is not vibration isolated - Equipment fragility only
+C.20.11.001a,EA,3,"1,2",2.9,2,,0.2,C2011.001a    Prefabricated steel stair with steel treads and landings with seismic joints that accommodate drift.
+D.50.12.021a,EA,3,0,1,1,,0.4,D5012.021a    Low Voltage Switchgear - Capacity: 100 to <350 Amp - Unanchored equipment that is not vibration isolated - Equipment fragility only
+C.20.11.001a,EA,2,"1,2",2.9,2,,0.2,C2011.001a    Prefabricated steel stair with steel treads and landings with seismic joints that accommodate drift.
+D.50.12.021a,EA,2,0,1,1,,0.4,D5012.021a    Low Voltage Switchgear - Capacity: 100 to <350 Amp - Unanchored equipment that is not vibration isolated - Equipment fragility only
+C.20.11.001a,EA,1,"1,2",2.9,2,,0.2,C2011.001a    Prefabricated steel stair with steel treads and landings with seismic joints that accommodate drift.
+D.50.12.021a,EA,1,0,1,1,,0.4,D5012.021a    Low Voltage Switchgear - Capacity: 100 to <350 Amp - Unanchored equipment that is not vibration isolated - Equipment fragility only
+D.10.14.011,EA,roof,0,2,2,,0.7,"D1014.011    Traction Elevator - Applies to most California Installations 1976 or later, most western states installations 1982 or later and most other U.S installations 1998 or later."
+D.30.31.011a,EA,roof,0,3,3,,0.1,D3031.011a    Chiller - Capacity: < 100 Ton - Unanchored equipment that is not vibration isolated - Equipment fragility only
+D.30.31.021a,EA,roof,0,3,3,,0.1,D3031.021a    Cooling Tower - Capacity: < 100 Ton - Unanchored equipment that is not vibration isolated - Equipment fragility only
+D.30.52.011a,EA,roof,0,13,13,,0.2,D3052.011a    Air Handling Unit - Capacity: <5000 CFM - Unanchored equipment that is not vibration isolated - Equipment fragility only
+D.50.12.013a,EA,roof,0,2.9,2,,0.5,D5012.013a    Motor Control Center - Capacity: all - Unanchored equipment that is not vibration isolated - Equipment fragility only
+B.10.44.101,SF,1--4,"1,2",288,2,,,Slender concrete wall
+B.10.49.012,EA,1--4,"1,2",21,21,,,RC slab-column connections