Skip to contents

Changelog

floodam.building 1.6.6.0

Release date: 2025-02-24

Data

  • inst/extdata/model/component_elementary:
    • Changes for ‘category_vulnerability.csv’, ‘component_elementary_action.csv’, ‘component_elementary.csv’
  • DAM, COMPONENT_ELEMENTARY:
    • Change in name for
      • “baseboard_pvc”
      • “door_exterior_pvc”
      • “door_garage_overhead_pvc”
      • “drainage_network_pvc”
      • “french_window_pvc”
      • “french_window_shutter_louvered_pvc”
      • “french_window_shutter_rolling_pvc”
      • “french_window_shutter_solid_pvc”
      • “window_pvc”
      • “window_shutter_louvered_pvc”
      • “window_shutter_rolling_pvc”
      • “window_shutter_solid_pvc”
      • “wall_render_exterior_lime_nhl_3_5”
    • IMPLY ADAPTATIONS FOR MODEL (building part)
  • adu_elevator, adu_l, adu_t_2room, adu_t_basement, adu_t_invisible, adu_t
    • Change in material (“PVC” to “pvc”)

floodam.building 1.6.5.0

Release date: 2025-02-23

Data

  • adu_t_basement
    • New preloaded model with stage load only
  • adu_elevator
    • New preloaded model with stage load only
  • adu_t_2room
    • New preloaded model with stage load only
  • adu_t_invisible
    • New preloaded model with stage load only
  • adu_l
    • New preloaded model with stage load only

floodam.building 1.6.4.0

Release date: 2025-02-23

Enhancements

Data

  • adu_t
    • Preloaded model with stage load, extract, damaging, and hydraulic to help tests

floodam.building 1.6.3.0

Release date: 2025-02-21

Data

  • adu_t
    • Preloaded model dwelling renamed as adu_t

Documentation

  • adu_t
    • Documentation modified
  • Keyword internal added to documentation of internal functions
  • Vignettes on model creation (from plan to input files) converted to articles
  • Release dates added to changelog

floodam.building 1.6.2.0

Release date: 2025-02-20

Enhancements

  • prepare_elevator_data() (internal)
    • New function to handle the integration of the new elevator elementary components
  • update_elementary_damaging() (internal)
    • code block added to integrate elevator components in DAM
  • DAM
    • New elementary damaging functions for elevator components
  • COMPONENT_ELEMENTARY
    • New elementary components for elevator

Data

  • New model available in inst/extdata/model/adu/adu_elevator:
    • adu_elevator is a 3-storey building with one room and one elevator shaft per storey
  • New internal datasets available in inst/extdata/component_elementary/elevator:
    • elevator_vulnerability.csv
    • elevator_complementary.csv

Documentation

  • New vignette available
    • how to add an elevator to your model

floodam.building 1.6.1.0

Release date: 2025-01-29

Enhancements

  • compute_exchange() (internal)
    • No need for opening_name as an input, it is deducted from colnames(exchange). If colnames(exchange) is NULL, it should work as expected.
    • documentation and tests are improved.

floodam.building 1.6.0.1

Release date: 2025-01-25

Bugs

  • Several bugs in documentation solved

floodam.building 1.6.0.0

Release date: 2025-01-21

In this version of the library, the hydraulic module has been rewritten entirely in R and Rcpp. The goal is to enhance the coherence of the code and make it more flexible for futur updates. All python dependencies have been removed.

Enhancements

  • analyse_hydraulic()
    • New function that sets up new hydraulic module written in R
  • compute_hydraulic() (internal)
    • New hydraulic module written in R, faster and more optimised than the previous Python hydraulic module.
  • compute_exchange() (internal)
    • New function allowing flow rate computations written in pure R.
  • rcpp_compute_exchange() (internal)
    • New function allowing flow rate computations written in Rcpp. It has a faster running time than it’s R counter part compute_exchange().
  • generate_limnigraph()
    • The limnigraph now has to be ordered by externals, and the externals have to be specified.
  • update_path()
    • model_output_hydraulic added to save hydraulic outputs.
  • dependency of reticulate library removed
  • function manage_python() removed
  • module hydraulic_module.py removed
  • function analyse_hydraulics() removed
  • function .onAttach() removed
  • package global variable floodam_building_py removed
  • Test is_compatible_python removed

floodam.building 1.5.0.3

Release date: 2025-01-16

Bugs

  • order_wall() (internal)
    • Could not deal external with many walls (more than 26). Now it can. Start the 27th to AA and so on up to ZZ. Model can have external with 702 walls now.
  • compute_damage_detail() (internal)
    • Information on room and storey were discarded for ceiling before being passed to adjust_dam_by_component. And so distrib_by_room() could not affect ceiling components to the good room.

floodam.building 1.5.0.2

Release date: 2024-11-20

Bugs

  • is_compatible_python() (internal)
    • Really solved bug provoking error when loading the library (coming from change in R version 4.4 and management of x < 3 when x is a character)
    • test added

floodam.building 1.5.0.1

Release date: 2024-11-19

Bugs

  • is_compatible_python() (internal)
    • new name for compatible_python()
    • Solved bug provoking error when loading the library

floodam.building 1.5.0.0

Release date: 2024-11-04

Enhancements

  • adjust_elementary_damaging()
    • stop() sequence when checking parameter damaging removed. Now the function returns NULL if parameter damaging is NULL, allowing the estimate of the building’s damage function ignoring missing elementary components
  • compute_damage()
    • use of message() instead of cat() for verbose or talkative mode
    • new management of missing elementary component:
      • if some elementary components ar missing (i.e. are not present in DAM), then compute_damage() does not return NULL. It continues the calculation, consistent with new behavior of adjust_elementary_damaging().
      • a message and a warning are sent to inform the user that the estimation will be done ignoring those elementary components.
  • check_damaging()
  • load_model()
  • order_wall()
  • to_numeric() (internal)
    • extracted from loead_model(), to deal with ‘clever’ transformation from character to numeric
    • test added
  • remove_comment() (internal)
    • extracted from loead_model(), to deal with removal of comments when reading xml files
    • test to be added

Data

  • New model available in inst/extdata:
    • adu_t_missing is similar to adu_t with missing elementary components

floodam.building 1.4.1.0

Release date: 2024-10-28

Data

  • New model dwelling available as package data
  • New model available in inst/extdata:
    • adu_t_bassement is two storey dwelling composed of a single-room basement and a 4-room ground floor (3 rooms around a central room)
  • Furniture included in models adu_t and adu_t_basement

Documentation

  • New vignette explaining how to model +1 storey buildings
  • New vignette explaining how to handle furniture
  • Update of function examples

Bugs

  • analyse_hydraulics()
    • Solved bug provoking error when function called

floodam.building 1.4.0.2

Release date: 2024-10-04

Bugs

  • load_model()
    • keep only one category of elementary components when too many are found and generate a warning
  • COMPONENT_ELEMENTARY
    • keep only one category for activities’ elementary components
  • analyse_hydraulics()
    • adapt to reticulate’s strange way of calling attribute

floodam.building 1.4.0.1

Release date: 2024-09-13

Enhancements

  • create_new_model()
    • New metadata value for the input_file parameter to generate, from an internal template, the metadata file to be inputted

Documentation

  • Update and bug handling of function examples

floodam.building 1.4.0.0

Release date: 2024-06-19

Enhancements

  • COMPONENT_ELEMENTARY
    • Elementary vulnerability function categories in variable category_vulnerability deduplicated and relabeled

floodam.building 1.3.2.0

Release date: 2024-05-15

Enhancements

  • analyse_hydraulics()
    • The function now executes the hydraulic module of floodam.building in either the default python virtual environment “floodam” or in a user-defined python virtual environment, provided using the new parameter envname.
  • manage_python()
    • Function to manage the installation of python dependencies needed by the hydraulic module of floodam.building. It creates a virtual environment to avoid system pollution or dependency conflicts.
  • compatible_python() (internal)
    • Internal function that checks whether Python 3 is installed
  • py_simulate_hydraulics() (internal)
    • replace sim_hydrau_py()
    • execute the hydraulic module of floodam.building in either the default python virtual environment, “floodam”, or in a user-defined python virtual environment, provided using the new parameter envname.
  • plot.damaging()
    • Finalization of snake_case transformation for internal functions.
  • plot.model()
    • Finalization of snake_case transformation for internal functions.

Documentation

  • Cover page of website
    • Modification of installation instructions

floodam.building 1.3.1.1

Release date: 2024-04-28

Bugs

floodam.building 1.3.1.0

Release date: 2024-04-09

Enhancements

Documentation

  • Vignettes
    • The structure of the input file of floodam.building
    • From the architect’s plan to the input file of floodam.building

Dependencies

  • R
    • Package DT
    • Package htmltools

floodam.building 1.3.0.0

Release date: 2023-10-25

Enhancements

  • analyse_hydraulics()
    • Function to simulate the hydraulics in the interior of the building
  • analyse_model()
    • New stage “hydraulic”
  • extract_hydraulic_input()
    • Function called by analyse_model() to generate input on exchanges through openings
    • Called when “hydraulic” is given as stage
  • generate_limnigraph()
    • Function to generate limnigraph (evolution of water depth against time)
  • New global variables (input needed by hydraulic simulator)
    • floodam_building_hydraulic_discharge_coefficient, default value 0.42
    • floodam_building_hydraulic_initial_water_depth_interior default value 0
    • floodam_building_hydraulic_closed_opening_clearance default value 0.5
  • New optional tags in XML input to facilitate the identification of water exchanges through openings and empty walls
    • opening names
    • wall names

Data

  • dwelling models in inst/extdata:
    • adu_l is a single storey linear 4-room dwelling
    • adu_t is a single storey 4-room dwelling; 3 rooms around a central room
    • adu_t_2room is a single storey 2-room dwelling; created by merging rooms in adu_t
    • adu_t_invisible is similar to adu_t_2room but instead of merged, rooms are separated by invisible walls

Documentation

  • Vignettes
    • Getting started with floodam.building
    • Simulating the hydraulic behavior of the interior of a building (English)
  • How to install python dependencies

Dependencies

  • R
    • Package reticulate
  • Python
    • Python 3
    • Package NumPy
    • Package pandas