Overview
In this section we are going to discuss the steps for ingesting building data into a format that MAEviz can understand and use in the building analyses. Before we launch the software, we will go over the MAEviz building data format so that if any changes need to be made, we can make those now.
Data Format
We will need two datasets for running a building damage analysis, a building dataset ingested into MAEviz and a Fragility Mapping dataset ingested into MAEviz. The building dataset will contain columns such as structure type, year built, etc and the fragility mapping dataset tells MAEviz which fragility curves should be used for which buildings.
Building Data
Let's start out describing the building data. The building data for MAEviz needs to be in ESRI's Shapefile format. Below you will find the column names and column types that MAEviz requires. Only the column types (e.g. integer, double, string, etc) must explicitly match because when we ingest the dataset, MAEviz will ask you to map your columns to the columns that MAEviz needs. For example, your structure type information might be in a column called s_type and MAEviz expects it to be called str_type so you can tell MAEviz that s_type maps to str_type and no changes need to be made to your dataset. I've categorized the columns into three categories: Very Important, Less Important and Least Important.
Building Columns:
Very Important
Field Name |
Field Description |
Field Type |
|---|---|---|
STRUCT_TYP |
General structure type of the building |
string |
Less Important
Field Name |
Field Description |
Field Type |
|---|---|---|
OCC_TYPE |
Broad HAZUS Occupancy Category (e.g. RES3 - multi-family residential) |
string |
APPR_BLDG |
Appraised value for the building |
double |
SQ_FOOT |
total building area in square feet |
integer |
DWELL_UNIT |
total number of dwelling units in the building |
integer |
CONT_VAL |
value of building contents |
double |
STR_TYP2 |
detailed structure type as per HAZUS MR-3 specifications |
string |
EFACILITY |
essential facility designation |
string |
Least Important
Field Name |
Field Description |
Field Type |
|---|
PAR_ID
PARID_CARD
BLDG_ID
STR_PROB
YEAR_BUILT
NO_STORIES
A_STORIES
B_STORIES
BSMT_TYPE
GSQ_FOOT
OCC_DETAIL
MAJOR_OCC
BROAD_OCC
REPL_CST
STR_CST
NSTRA_CST
NSTRD_CST
DGN_LVL
OCC_TYP2
TRACT_ID
Now, it's ok if you don't have all of the above information for your buildings since the more detail you have about your building means you can be more explicit in mapping your fragilities to your buildings in the damage analysis and in some cases, the more advanced analysis will start requiring some of those attributes (e.g. estimating structural damage cost requires the APPR_BLDG column since the cost of the structure needs to be known). However, all of these columns need to be present, even if they contain no data because MAEviz will expect all of the columns to be there. In the next version of MAEviz, this restriction of all columns being present, even with no data, should be eliminated.
Fragility Data
Launch MAEviz
The default installation directory for MAEviz is a folder with the same name, "MAEviz" so you should be able to launch the software by going to Start -> Programs -> MAEviz.