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

Sensitivity analysis tutorial #11

Open
wants to merge 20 commits into
base: main
Choose a base branch
from
Open

Conversation

ghwilliams
Copy link

Added a section about uncertainty quantification and resolution.
I've created the first tutorial, about the use of the sensitivity matrix with a few examples.
There are still some gaps that I'm going to fill (e.g in the section describing some theoretical aspects).
The plan is to continue developing more tutorials in this section showing techniques for uncertainty assessment in inverse problems using SimPEG.

@dccowan dccowan self-assigned this Feb 21, 2024
@dccowan dccowan self-requested a review February 21, 2024 21:01
@dccowan
Copy link
Member

dccowan commented Feb 21, 2024

image

Try to be consistent with capitalizing letters. Capitalize all significant words. Transitional words like 'a' 'the' 'for' are not capitalized. See https://www.scribbr.com/academic-writing/capitalization-titles-headings/

@dccowan
Copy link
Member

dccowan commented Feb 21, 2024

image

Can we get a fancier image than this?

@dccowan
Copy link
Member

dccowan commented Feb 21, 2024

General comments on file storage and structure:

Please house notebooks related to sensitivity and resolution analysis in a directory notebooks/13-sensitivity-resolution. As of right now, the name you gave to the notebook seems fine.

Data files that are downloaded and used in the tutorials should be housed in an appropriate directory within the assets folder. You have created a folder notebooks/xx-dc2d/century where everything is unzipped. To fix this, you will need to:

  • Create a directory assets/13-sensitivity-resolution
  • Zip all of the files related to a notebook within a .tar.gz. For example, yours would be dc2d_sens_files.tar.gz

In the near future, we will use something called Pooch to download.

@dccowan
Copy link
Member

dccowan commented Feb 21, 2024

Is this example specific to DC resistivity? Or did you want to extent it to a generate concept? If it's DC resistivity specifically, it could be a tutorial within that section of the website.

@ghwilliams
Copy link
Author

ghwilliams commented Feb 21, 2024

Great. Thanks for the comments, I'll work on your suggestions. For the picture to be replaced, do you have any suggestions for a new one? I will make a selection of a few alternatives and show you later.
Feel free to continue adding your comments.
When you start looking at the tutorial, the "theoretical background" section is not really polished yet. I'm not even sure that it would be good to have it there. So, maybe I should ask you. What do you think about it, should I keep it?

@dccowan
Copy link
Member

dccowan commented Feb 21, 2024

image

Did we need to define this function? Can't we use once of the functions within SimPEG.utils.io_utils?

@dccowan
Copy link
Member

dccowan commented Feb 21, 2024

image

Did we need to define this function? Can't we use once of the functions within SimPEG.utils.io_utils?

In fact, the utility might also generate the data object automatically.

@ghwilliams
Copy link
Author

image

Did we need to define this function? Can't we use once of the functions within SimPEG.utils.io_utils?

Not sure. I'll look at the possibilities within SimPEG. I'm not really happy with this too.

@dccowan
Copy link
Member

dccowan commented Feb 21, 2024

I feel like the content can really be split into 2 parts. In part 1, we use the sensitivities to see how sensitive our survey geometry is to a particular model. In part 2, we use the sensitivities to determine which features we have recovered with a certain degree of confidence. Is that true? If so, we should be more explicit in stating this.

@ghwilliams
Copy link
Author

Is this example specific to DC resistivity? Or did you want to extent it to a generate concept? If it's DC resistivity specifically, it could be a tutorial within that section of the website.

In the end, we will always need to use some specific method to create the examples, otherwise the tutorial would only have conceptual information, the mathematics and so on. So, I don't know yet what would be the best strategy to organize these tutorials. One option is, as you suggested, to make this one really specific to DC problems, put it in the DC group and write other similar tutorials for the other methods.

@ghwilliams
Copy link
Author

I feel like the content can really be split into 2 parts. In part 1, we use the sensitivities to see how sensitive our survey geometry is to a particular model. In part 2, we use the sensitivities to determine which features we have recovered with a certain degree of confidence. Is that true? If so, we should be more explicit in stating this.

I agree, we can split the tutorial in two parts, making them shorter. One tutorial would focus on the detectability, and the other on the resolution.

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.

2 participants