Import examples

Z:\OMERO_in-place_import\AG_Xyz\Max_Mustermann_mamu100\--   2023-06-19_grp1\   image1.czi
                                                      |                        image1.tiff
                                                      |                        image2.czi
                                                      |                        image2.tiff
                                                      |
                                                      |--   2023-06-19_grp2\--   details\   sample1_detail.tiff
                                                      |                    |                sample2_detail.tiff
                                                      |                    |
                                                      |                    |--   overview\  sample1_overview.tiff
                                                      |                                     sample2_overview.tiff
                                                      |
                                                      |--   2023-06-20_grp3\   image3.czi
                                                                           |   image3.tiff


Case n°1:
Input:
- Project:ID:123 (new datasets will be generated and attached to the project with ID 123)
- Main folder path: Z:\OMERO_in-place_import\AG_Xyz\Max_Mustermann_mamu100\2023-06-19_grp1
- File names: *.tiff

Result:
Dataset "2023-06-19_grp1" with images "image1.tiff" and "image2.tiff"

Explanation:
The given main folder path directly match the folder with the images to import. That folder name only is used to name the new dataset. 
The File names parameter uses a wildcard * followed by the file extension ".tiff". This only matches the two tiff files for import.



Case n°2:
Input:
- Project:ID:123 (new datasets will be generated and attached to the project with ID 123)
- Main folder path: Z:\OMERO_in-place_import\AG_Xyz\Max_Mustermann_mamu100
- File names: 2023-06*/*.tiff

Result:
Dataset "2023-06-19_grp1" with images "image1.tiff" and "image2.tiff"
Dataset "2023-06-20_grp3" with image "image3.tiff"

Explanation:
The file names contain folder names, that are used to name the new datasets.
2023-06* matches all three folders "2023-06-19_grp1", "2023-06-19_grp2", "2023-06-20_grp3". However, no image in 2023-06-19_grp2 matches "*.tiff", so no dataset is generated for it.
"image1.tiff", "image2.tiff" and "image3.tiff" from the two other folders match "*.tiff". A dataset for each folder is generated.



Case n°3:
Input:
- Project:ID:123 (new datasets will be generated and attached to the project with ID 123)
- Main folder path: Z:\OMERO_in-place_import\AG_Xyz\Max_Mustermann_mamu100
- File names: 2023-06-19*/*, 2023-06-19*/*/*

Dataset "2023-06-19_grp1" with images "image1.czi", "image1.tiff" and "image2.czi", "image2.tiff"
Dataset "2023-06-19_grp2__details" with image "sample1_detail.tiff", "sample2_detail.tiff"
Dataset "2023-06-19_grp2__overview" with image "sample1_overview.tiff", "sample2_overview.tiff"

Explanation:
The file names contain folder names, that are used to name the new datasets.
In the case of "2023-06-19*/*/*", sub-folders are matched by the wildcard are images are searched inside. Because two subfolders are found, it generates two datasets in OMERO.
The multiple folder names are concatenated with double underscores (__) to make the dataset names. 



Case n°4:
Input:
- Dataset:ID:123 
- Main folder path: Z:\OMERO_in-place_import\AG_Xyz\Max_Mustermann_mamu100
- File names: 2023-06-19*/*, 2023-06-19*/*/*

Images (same as case n°3) are all imported to the existing dataset with ID 123.

Explanation:
A dataset is selected as the target. All images found by the script will be imported inside this dataset (no dataset is created by the script).
The explanation on image found is the same as case n°3 (main folder path and file name parameters are identical).