Differences

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

--- caching [2022/02/09 14:39] – [Tile caching] yves
+++ caching [2022/03/28 19:01] (current) – [Tile caching] yves
@@ Line 4: / Line 4: @@
 We have a strategy where cache is deleted after a retention period automatically and no new cache is created if there is not enough disk space.
+There's a [[settings_image#cache_settings|separate configuration page for cache settings]]
 ==== Tile caching ====
-PMA.core will not cache tiles or thumbnails if there is not enough disk space (as defined in the [[cache_settings|settings]]).
+Extracted tiles from [[https://realdata.pathomation.com/what-whole-slide-images-wsis-are-made-of/|WSIs]] are stored in a cache repository. This is Just In Time (JIT) caching: the tiles are only stored in the cache after being generated for the first time.
+When many people look at the same slide, they are typically interested in the same regions of interest and slide details. This means that as a system is used over time, almost all of its accessed content will be available through the tile cache. Tile caching in this regard also makes PMA.core a much more scalable system than it would be without this mechanism.
+PMA.core will not cache tiles or thumbnails if there is not enough disk space (as defined in the [[settings_image#cache_settings|settings]]).
 ==== Cloud caching ====
+Slides that are retrieved through cloud storage like S3 or Azure, benefit from an additional layer of caching.
+{{ :cache_structure.png?nolink&400 |}}
+Based on requests received from clients, PMA.core will retrieve part of the original slide from cloud storage, and keep that in a local cache repository. From that //data chunk// eventual tiles are extracted.
 ==== Troubleshooting ====
@@ Line 21: / Line 33: @@
 you can take this to a higher extreme and assume you have 100GB free space on a 100GB disk and you receive 100s of requests for "Image Info". This will again cause PMA.core to store chunks of 100s of images to the disk simultaneously, and may end up in a full disk (without breaking any rule).
-After this point nothing works, because PMA.core doesn't know what to delete; all the cache is fresh.
+After this point nothing works, because PMA.core doesn't know what to delete; all the cache is fresh. You now have to purge the cache folder(s) manually, after which the build process may re-commence (you may also provide more storage for your cache repositories this time around).