Hi @bruno-pannunzio : although I labelled this work in progress, I would appreciate your review. Specifically, is this level of detail appropriate for an introductory tutorial? Also, I think it is about time to replace the TIFF dataset from FLUTe with our own data before the first release of the library. Preferably in form of PTU files to demonstrate the phasorpy.io module and metadata handling.

Hi @cgohlke! I really like the suggested changes to the tutorials! It makes it much more clear and more direct to select one depending on the needs. Also the addition of the "Applications" sections is great, this can be useful to show the full functionalities of the library without crowding the API tutorials. I think we can work after in useful tutorials for the Applications section.

Regarding the introduction tutorial, I think all are excellent additions.

is this level of detail appropriate for an introductory tutorial

I believe that in general it's okay the level of detail. I would suggest just moving the apparent lifetime section to another tutorial (maybe to an application tutorial?). I think the introduction tutorial is enough if we show the most basic workflow which I think is reached when plotting. I think further analyses can be discussed in more detail in other tutorials. Also, the introduction tutorial is missing hyperspectral images, which would be good to show since it's also an important aspect of the library, and at the moment the introduction tutorial is biased towards FLIM. Maybe we can use the paramecium example used in the cursors tutorial and show the basic workflow until plotting, which shouldn't extend too much the tutorial.

Also, I think it is about time to replace the TIFF dataset from FLUTe with our own data before the first release of the library. Preferably in form of PTU files to demonstrate the phasorpy.io module and metadata handling.

Definitely! This is long due. The problem we have with this is that our instruments only generate FBD files. We should consider reaching someone open to provide us some nice PTU files. Maybe @lmalacrida can help with this.

Thanks for the review!

I think we can work after in useful tutorials for the Applications section.

I'd like to add (not in this PR) a tutorial demonstrating out-of-core processing with dask on one of the tiled datasets that @schutyb recently shared. Let's discuss in the next meeting.

I would suggest just moving the apparent lifetime section to another tutorial (maybe to an application tutorial?). I think the introduction tutorial is enough if we show the most basic workflow which I think is reached when plotting.

I agree, that section stands out. On the other hand, I wanted the introduction tutorial to demonstrate all aspects of the library, which includes converting phasor coordinates, and (currently still missing) cursors and components.

Also, the introduction tutorial is missing hyperspectral images, which would be good to show since it's also an important aspect of the library, and at the moment the introduction tutorial is biased towards FLIM.

True. On the other hand, of the almost 60 functions and classes in the library so far, more than half are specific to FLIM, while only two (?) functions are specific to spectral imaging.

Let's dedicate one section at the end of the introduction tutorial to "Spectral phasors", basically a shortened version of the cursors tutorial. OK?

The problem we have with this is that our instruments only generate FBD files.

FDB is certainly more appropriate than TIFF for the tutorial, but FBD is such a mess of a format that I prefer to not cover it in the main tutorial.

Let's dedicate one section at the end of the introduction tutorial to "Spectral phasors", basically a shortened version of the cursors tutorial. OK?

Great!

FDB is certainly more appropriate than TIFF for the tutorial, but FBD is such a mess of a format that I prefer to not cover it in the main tutorial.

Agree. PTU is more adequate for the tutorial. Let's discuss next meeting candidates to let us use some of their files.

I added the section about spectral phasors and removed apparent lifetimes. In principle, this is ready for review and could be merged. Switching to PTU files and adding a tutorial about apparent lifetimes (which would require a helper function for plotting images) is better done in separate PRs.