User Tools

Site Tools


image_manager

Differences

This shows you the differences between two versions of the page.

Link to this comparison view

Both sides previous revision Previous revision
Next revision
Previous revision
image_manager [2022/03/14 19:12]
yves [Directory view (middle panel)]
image_manager [2023/11/21 16:22] (current)
chris
Line 1: Line 1:
 ===== Image management ===== ===== Image management =====
  
-The image manager is accessible from the "​Images"​ option on the left menu. This section allows the user to browse through the available virtual slides, manage the [[caching|cache files]], view, move and rename each image and [[viewport|launch the built in slide viewer]].+The image manager is accessible from the "​Images"​ option on the left menu. This section allows the user to browse through the available virtual slides, [[viewport|launch the built in slide viewer]], manage the [[caching|cache files]], view, move and rename each image.
  
 {{ :​man.png?​nolink&​400 |}} {{ :​man.png?​nolink&​400 |}}
Line 11: Line 11:
 {{::​img_man_left.png?​400|}} {{::​img_man_left.png?​400|}}
  
-In this view, only the root directories ​appear ​that the administrator has access to according to [[rootdir_security|ACL rules]]. [[rootdir_security#​public_vs_private|Public root directories]] (by definition) are always included here.+In this view, only the root directories that the administrator has access to appear (according to [[rootdir_security|ACL rules]]). [[rootdir_security#​public_vs_private|Public root directories]] (by definition) are always included here.
  
-It is possible for an administrator to manage mappings to 100s of root-directories and access pointswithout actually being able to navigate the content in these folders. When an administrator ​therefore ​wants to inspect ​certain ​content of a [[rootdir_security#​public_vs_private|private root directory]],​ it may be necessary to temporarily change this directory'​s access properties.+It is possible for an administrator to manage mappings to 100s of root-directories and access points without actually being able to navigate the content in these folders. When an administrator wants to inspect ​the content of a [[rootdir_security#​public_vs_private|private root directory]],​ it may be necessary to temporarily change this directory'​s access properties.
  
 Root directories that are NOT available for technical reasons, //are// shown in the folder hierarchy. The reason for this is: PMA.core is an administrative tool, and it must be possible for an administrator to emulate a non-accessible root directory to trigger a particular error that can then be further inspected via the [[elmah|Elmah log]]. Root directories that are NOT available for technical reasons, //are// shown in the folder hierarchy. The reason for this is: PMA.core is an administrative tool, and it must be possible for an administrator to emulate a non-accessible root directory to trigger a particular error that can then be further inspected via the [[elmah|Elmah log]].
Line 19: Line 19:
 {{::​img_man_search.png?​400|}} {{::​img_man_search.png?​400|}}
  
-A search bar let'​s ​you search for specific files or extensions across the entire spectrum of the PMA.core server (this feature is mainly useful during startup; ​search ​a multi-terabyte repository this way in real-time is not very practical, and we've developed [[https://​www.pathomation.com/​products|other products]] to facilitate this latter use case more efficiently).+A search bar lets you search for specific files or extensions across the entire spectrum of the PMA.core server (this feature is mainly useful during startup; ​searching ​a multi-terabyte repository this way in real-time is not very practical, and we've developed [[https://​www.pathomation.com/​products|other products]] to facilitate this latter use case more efficiently).
  
-There'​s a quick menu access ​menu to provide convenient access to certain managerial tasks related to the image management view. +There'​s a [[image_manager_left_menu|dropdown ​menu]] to provide convenient access to certain managerial tasks related to the image management view.
- +
-=== Quick access menu - Root directories === +
- +
-{{:​img_man_left_menu_rootdirs.png?​400|}} +
- +
-This menu takes you to the [[rootdir_config|root directory manager]]. +
- +
-=== Quick access menu - External Treeview === +
- +
-{{:​img_man_left_menu_ext_treeview.png?​400|}} +
- +
-//Currently non-functional//​ +
- +
-=== Quick access menu - Stats === +
- +
-{{:​img_man_left_menu_stats.png?​400|}} +
- +
-//Currently non-functional//​ +
- +
-=== Quick access menu - Copy dir path === +
- +
-{{:​img_man_left_menu_copy_dir_path.png?​400|}} +
- +
-Whether you want to verify a directory'​s content through the Windows Explorer, or are building a script in Jupyter, there are number of reasons where it is useful to readily have a full path to a particular directory hierarchy available. This function does exactly that. +
- +
-{{::​img_man_left_menu_copied_dir_path.png?​400|}}+
  
 ==== Directory view (middle panel) ==== ==== Directory view (middle panel) ====
Line 55: Line 29:
 {{::​img_man_mid.png?​600|}} {{::​img_man_mid.png?​600|}}
  
-Similarly to the Tree view, there'​s a quick menu access menu to provide convenient access to certain managerial tasks related to the directory content view. +Similarly to the Tree view, there'​s a quick access menu to provide convenient access to certain managerial tasks related to the directory content view.
- +
-Several operations can be performed on a directory:​ +
- +
-=== Edit root directory === +
- +
-{{::​img_man_mid_menu_10_edit_rootdir.png?​400|}} +
- +
-This menu option takes you to the [[rootdir_config|configuration page]] for the current selected root-directory. +
- +
-=== Rename this directory === +
- +
-{{:​img_man_mid_menu_20_rename_dir.png?​400|}} +
- +
-As the name implies, this option allows you to rename the current selected directory.  +
- +
-This option only applies for sub directories //within// root directories. For a root directory itself you can [[rootdir_config|change its alias]], but not his original path reference. +
- +
-The success of this operation depends on the access rights of the underlying (security) entity used to access the original directory. +
- +
-Renaming sub directories can be tricky: In a cloud context, unfortunately,​ oftentimes a rename/move function comes down to subsesequent copy/delete operations. This means that renaming empty directories is pretty much a straightforward operation, but renaming a complex structure can take a while to process. +
- +
-=== Create subdirectory === +
- +
-{{:​img_man_mid_menu_30_create_subdir.png?​400|}} +
- +
-This menu option creates a new  +
- +
-The success of this operation depends on the access rights of the underlying (security) entity used to access the original directory. +
- +
-=== Delete subdirectory === +
- +
-{{:​img_man_mid_menu_40_delete_subdir.png?​400|}} +
- +
-The success of this operation depends on the access rights of the underlying (security) entity used to access the original directory. +
- +
-=== Empty all cache files of this directory === +
- +
-{{:​img_man_mid_menu_50_delete_cache.png?​400|}} +
- +
-=== Refresh directory === +
- +
-{{:​img_man_mid_menu_60_refresh.png?​400|}} +
- +
-This option is useful during setup of new root-directories. For large volumes of data, working via an external  +
- +
-=== Export files === +
- +
-{{:​img_man_mid_menu_70_export_files.png?​400|}} +
- +
-=== Copy dir path === +
- +
-{{:​img_man_mid_menu_80_copy_dir_path.png?​400|}} +
- +
-Whether you want to verify a slide'​s path through the Windows Explorer, or are building a script in Jupyter, there are number of reasons where it is useful to readily have a full path to a particular slide available. This function does exactly that. +
- +
  
 +[[image_manager_mid_menu|Several operations can be performed on a directory]].
 ==== Slide view (right panel) ==== ==== Slide view (right panel) ====
  
Line 122: Line 41:
  
   * Dimensions: The width & height of the image in pixels   * Dimensions: The width & height of the image in pixels
-  * File format: Name of the format / vendor as well as the compression type used by the selected slide.+  * File format: Name of the format / vendor as well as the [[compression type]] used by the selected slide.
   * Tile size: The size of the tiles that PMA.core will server for this image.   * Tile size: The size of the tiles that PMA.core will server for this image.
   * Physical size: The total size of all the files that this slide comprises of.   * Physical size: The total size of all the files that this slide comprises of.
-  * Strict fingerprint:​ A unique identifier calculated based on the contents as well as the path of the slide. +  * Strict ​[[https://​realdata.pathomation.com/​fingerprinting-applications/​|fingerprint]]: A unique identifier calculated based on the contents as well as the path of the slide. 
-  * Loose fingerprint:​ A unique identifier calculated based on the contents of the slide. This value can be used to compare slides that reside in different locations to test if they are exactly the same or not.+  * Loose [[https://​realdata.pathomation.com/​fingerprinting-applications/​|fingerprint]]: A unique identifier calculated based on the contents of the slide. This value can be used to compare slides that reside in different locations to test if they are exactly the same or not.
   * Barcode text: If detected, displays the text version of a slide'​s embedded barcode.   * Barcode text: If detected, displays the text version of a slide'​s embedded barcode.
   * Tile cache: Percentage of the [[caching|cache]] that has already been built for the slide.   * Tile cache: Percentage of the [[caching|cache]] that has already been built for the slide.
-  * Annotations:​ This label will be green if there are annotations available for this slide. +  * [[working_with_annotations|Annotations]]: This label will be green if there are annotations available for this slide. 
-  * 3-rd party annotations:​ This label will be green if any of the supported third party annotations have been detected for this slide. +  * [[meta_data#​external_meta-data|3-rd party annotations]]: This label will be green if any of the supported third party annotations have been detected for this slide. 
-  * Form data: This label will be green if form meta data have been captured for this slide.+  * [[form_management|Form data]]: This label will be green if form meta data have been captured for this slide.
  
 Clicking on the image opens a [[viewport|full screen viewer]]. There are several buttons available in the image panel interface: Clicking on the image opens a [[viewport|full screen viewer]]. There are several buttons available in the image panel interface:
Line 138: Line 57:
   * Move image: Moves the image to another directory   * Move image: Moves the image to another directory
   * Rename image: Renames the image   * Rename image: Renames the image
-  * Heatmap: Displays a heatmap which highlights the areas of the image that have been consulted most so far+  * Heatmap: Displays a heatmap which highlights the most consulted ​areas of the image
   * Event log: Displays a list of events that involve the currently selected image   * Event log: Displays a list of events that involve the currently selected image
image_manager.1647274349.txt.gz · Last modified: 2022/03/14 19:12 by yves