Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Refine Risk Assessment Terms: Vulnerability and Impact Functions (Update Guide_Introduction.ipynb) #802

Merged
merged 4 commits into from
May 2, 2024

Conversation

DahyannAraya
Copy link
Collaborator

The choice of terminology in risk assessment models such as CLIMADA is crucial, as it shapes the framework and perspective of the analysis. The distinction between "vulnerability function" and "impact function" is particularly significant. I made some changes along the lines of making this terminology more visible. I also made changes in the documentation where vulnerability function or damage function was still referenced in order to unify the communication of CLIMADA terminology.

I considered adding a few lines to explain that the concepts of damage function, vulnerability function, and impact function, though interrelated, each serve a distinct purpose. Damage functions quantify specific damages, focusing on concrete impacts. Vulnerability functions, in contrast, articulate the susceptibility of different exposures to hazards. This susceptibility encompasses more than just the potential for damage; it includes a variety of preconditions that define an exposure's overall vulnerability. Meanwhile, impact functions assess the likelihood of a hazard's effects, both negative and positive, by parameterizing the degree to which an exposure will be impacted by a particular hazard.Something along those lines..... but maybe it's too much... we can discuss it sometime ......

Changes proposed in this PR:

This PR fixes #

PR Author Checklist

PR Reviewer Checklist

The choice of terminology in risk assessment models such as CLIMADA is crucial, as it shapes the framework and perspective of the analysis. The distinction between "vulnerability function" and "impact function" is particularly significant. I made some changes along the lines of making this terminology more visible. I also made changes in the documentation where vulnerability function or damage function was still referenced in order to unify the communication of CLIMADA terminology. 

I considered adding a few lines to explain that the concepts of damage function, vulnerability function, and impact function, though interrelated, each serve a distinct purpose. Damage functions quantify specific damages, focusing on concrete impacts. Vulnerability functions, in contrast, articulate the susceptibility of different exposures to hazards. This susceptibility encompasses more than just the potential for damage; it includes a variety of preconditions that define an exposure's overall vulnerability. Meanwhile, impact functions assess the likelihood of a hazard's effects, both negative and positive, by parameterizing the degree to which an exposure will be impacted by a particular hazard.Something along those lines..... but maybe it's too much... we can discuss it sometime ......
@chahank
Copy link
Member

chahank commented Nov 13, 2023

I think it is a great idea to clarify a bit the terminology. However, I think there are many more ways to interpret the words as those that you mentioned, so I would just be careful to not be to strong on the wording. The one thing we can be very clear about is what are impact functions in the context of CLIMADA. They are very flexible, and so can fulfill the roles of both vulnerability functions or damage function, but could also be productivity functions or warning levels.

In any case, thanks for the updates!

Copy link
Collaborator

@zeliest zeliest left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I think it is good idea to clarify the terminology here. I would however not go more into detail as it is a general introduction, maybe in the tutorial on impact functions?

doc/guide/Guide_Introduction.ipynb Outdated Show resolved Hide resolved
doc/guide/Guide_Introduction.ipynb Outdated Show resolved Hide resolved
doc/guide/Guide_Introduction.ipynb Outdated Show resolved Hide resolved
@chahank
Copy link
Member

chahank commented Apr 9, 2024

@DahyannAraya : How is this PR going?

@DahyannAraya
Copy link
Collaborator Author

OK @chahank, it's ready. I have implemented the changes suggested by @zeliest. You can do the merge, or if not, I'll wait for your confirmation and do it myself... Thanks

@chahank
Copy link
Member

chahank commented Apr 30, 2024

Thanks @DahyannAraya ! But as you can see, all tests are failing. We need to fix this first. First thing to do is merge the develop branch into your branch as it has been a long time since this was done last. If tests are still failing, please try to fix them or seek help.

@zeliest : can you please see if you are satisfied and approve the PR if yes (and if all tests are passing).

@chahank chahank merged commit f0852a4 into develop May 2, 2024
9 of 12 checks passed
@emanuel-schmid emanuel-schmid deleted the DahyannAraya-patch-1 branch May 8, 2024 07:29
gdeskos pushed a commit to gdeskos/climada_python that referenced this pull request Sep 16, 2024
…ate Guide_Introduction.ipynb) (CLIMADA-project#802)

* Update Guide_Introduction.ipynb

The choice of terminology in risk assessment models such as CLIMADA is crucial, as it shapes the framework and perspective of the analysis. The distinction between "vulnerability function" and "impact function" is particularly significant. I made some changes along the lines of making this terminology more visible. I also made changes in the documentation where vulnerability function or damage function was still referenced in order to unify the communication of CLIMADA terminology. 

I considered adding a few lines to explain that the concepts of damage function, vulnerability function, and impact function, though interrelated, each serve a distinct purpose. Damage functions quantify specific damages, focusing on concrete impacts. Vulnerability functions, in contrast, articulate the susceptibility of different exposures to hazards. This susceptibility encompasses more than just the potential for damage; it includes a variety of preconditions that define an exposure's overall vulnerability. Meanwhile, impact functions assess the likelihood of a hazard's effects, both negative and positive, by parameterizing the degree to which an exposure will be impacted by a particular hazard.Something along those lines..... but maybe it's too much... we can discuss it sometime ......

* Update Guide_Introduction.ipynb

* Implementations of comments
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
None yet
Projects
None yet
Development

Successfully merging this pull request may close these issues.

3 participants