Skip to content
Open
Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
27 commits
Select commit Hold shift + click to select a range
037a55a
(dev) adding starter for pelicun convert function
hgp297 Feb 18, 2026
b24f26b
feat(WIP): implement Pelicun conversion
hgp297 Feb 19, 2026
56b13a4
removed testing notebook
hgp297 Feb 19, 2026
b8eab3e
(fix)system exit in elevator error
hgp297 Feb 24, 2026
e3b6b42
(feat) Pelicun conversion needs elevator is_sim_ds override
hgp297 Feb 24, 2026
824d84a
Fixes to plotting modules for Python compatibility
hgp297 Feb 24, 2026
74ee65e
doc: updated README with Pelicun instructions
hgp297 Feb 24, 2026
586cb0c
doc: added example script
hgp297 Feb 24, 2026
7d0ea23
doc: formatting README.md
hgp297 Feb 24, 2026
66ce6ba
feat: plotter has p_gantt as argument, default median
hgp297 Feb 24, 2026
d4f6668
Added force_rebuild flag in run_analysis
hgp297 Feb 24, 2026
f8eff0b
doc: docstring for force_rebuild
hgp297 Feb 24, 2026
ffffbaa
feat: added repair_cost_engineering (assumed as 10% of total ratio) t…
hgp297 Feb 24, 2026
b85fd93
fix(input_builder): properly indexing DV columns in pelicun converter
hgp297 Feb 24, 2026
ce06035
fix(input_builder): matched naming convention between DMG and DV from…
hgp297 Feb 25, 2026
e6d5d26
doc: more commenting and troubleshooting print commented out
hgp297 Feb 25, 2026
4a45ff7
refactor(plotters): moved plotting under
hgp297 Feb 25, 2026
ed50145
feat: Assigned side damage randomly
hgp297 Mar 2, 2026
9920f40
feat: added force_rebuild flag to cli.py
hgp297 Mar 2, 2026
477df42
fix(driver): moved seed initialization earlier
hgp297 Mar 2, 2026
5dfdc4b
fix(input_builder): init comp_population fix
hgp297 Mar 3, 2026
2612658
doc: fixed errors in README
hgp297 Mar 3, 2026
3f7af7c
feat: specify engineering cost
hgp297 Mar 3, 2026
5f3240e
doc: noting cladding damage and simulated_damage categories
hgp297 Mar 3, 2026
27c55aa
fix(example input): removed typo error
hgp297 Mar 3, 2026
12c08af
feat: added reoccupancy trajectory plot
hgp297 Mar 4, 2026
351bf94
feat: robustness in Pelicun conversion per Adam
hgp297 Mar 6, 2026
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
27 changes: 26 additions & 1 deletion README.md
Original file line number Diff line number Diff line change
Expand Up @@ -135,7 +135,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.
Expand All @@ -145,3 +144,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
- **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)
```
92 changes: 92 additions & 0 deletions examples/RCSW_4story_pelicun/CMP_QNT.csv
Original file line number Diff line number Diff line change
@@ -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
Loading