<para>Geeqie provides comprehensive set of search methods, including not only the standard functions such as file date or size, but also image similarity.</para>\r
<para>There is a duplicate file finder, which uses search parameters such as image dimensions or checksum. Two sets of image files may be compared.</para>\r
<para>Geeqie also has a set of temporary "marks" or "tags" which may be allocated to any image as an aide to file organising.</para>\r
+ <section id="GuideImageSearchCache">\r
+ <title id="titleGuideImageSearchCache">Caching Data For Searches</title>\r
+ <para>\r
+ Searching large numbers of files for similarity can take significant cpu time. Part of this is the time to compute the similarity matrix for each file.\r
+ <para />\r
+ If the\r
+ <link linkend="PreferencesThumbnails">Cache Thumbnails</link>\r
+ option is selected in Preferences/General, the similarity matrix and the checksum will also be cached. This will reduce the time needed for future searches.\r
+ <note>If you frequently search on similarity and your images are in a tree arrangement under a single point, initiating a one-time search on similarity from the top of the tree will generate the similarity data for all images.</note>\r
+ <para>Similarity data are stored in a folder hierachy that mirrors the location of the source images. The data have the same name as the original appended by the file extension .sim.</para>\r
+ <para>\r
+ The root of the hierachy is:\r
+ <para>\r
+ <programlisting>$XDG_CACHE_HOME/geeqie/thumbnails/</programlisting>\r
+ or, if $XDG_CACHE_HOME is not defined:\r
+ <programlisting>$HOME/.cache/geeqie/thumbnails/</programlisting>\r
+ </para>\r
+ </para>\r
+ </para>\r
+ <para />\r
+ </section>\r
<xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="GuideImageSearchSearch.xml" />\r
<xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="GuideImageSearchFindingDuplicates.xml" />\r
<xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="GuideImageMarks.xml" />\r
<para />\r
-</chapter>
+</chapter>\r
<li><a class="xref" href="GuideOtherWindows.html" title="Stand-alone Windows">Stand-alone Windows</a></li>
<li>
<a class="xref" href="GuideImageSearch.html" title="Search and Select">Search and Select</a><div class="autotoc"><ul>
+<li><a class="xref" href="GuideImageSearchCache.html" title="Caching Data For Searches">Caching Data For Searches</a></li>
<li><a class="xref" href="GuideImageSearchSearch.html" title="Search Window">Search Window</a></li>
<li><a class="xref" href="GuideImageSearchFindingDuplicates.html" title="Finding Duplicates">Finding Duplicates</a></li>
<li>Marking Images</li>
<meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
<title>Search and Select</title>
<link rel="previous" href="GuideCollections.html" title="Collections">
-<link rel="next" href="GuideImageSearchSearch.html" title="Search Window">
+<link rel="next" href="GuideImageSearchCache.html" title="Caching Data For Searches">
<link rel="top" href="GuideIndex.html" title="The Geeqie User Manual">
<style type="text/css">
<body>
<div class="navbar navbar-top"><table class="navbar"><tr>
<td class="navbar-prev"><a class="navbar-prev" href="GuideCollections.html" title="Collections">Collections</a></td>
-<td class="navbar-next"><a class="navbar-next" href="GuideImageSearchSearch.html" title="Search Window">Search Window</a></td>
+<td class="navbar-next"><a class="navbar-next" href="GuideImageSearchCache.html" title="Caching Data For Searches">Caching Data For Searches</a></td>
</tr></table></div>
<div class="sidebar"><div class="sidenav"><div class="autotoc"><ul>
<li><a href="GuideIndex-info.html" title="About This Document">About This Document</a></li>
<li><a class="xref" href="GuideSidebars.html" title="Sidebars">Sidebars</a></li>
<li><a class="xref" href="GuideOtherWindows.html" title="Stand-alone Windows">Stand-alone Windows</a></li>
<li>Search and Select<div class="autotoc"><ul>
+<li><a class="xref" href="GuideImageSearchCache.html" title="Caching Data For Searches">Caching Data For Searches</a></li>
<li><a class="xref" href="GuideImageSearchSearch.html" title="Search Window">Search Window</a></li>
<li><a class="xref" href="GuideImageSearchFindingDuplicates.html" title="Finding Duplicates">Finding Duplicates</a></li>
<li><a class="xref" href="GuideImageMarks.html" title="Marking Images">Marking Images</a></li>
<p class="para block"></p>
<div class="autotoc"><ul>
<li>
-<span class="label">5.1. </span><a class="xref" href="GuideImageSearchSearch.html" title="Search Window">Search Window</a>
+<span class="label">5.1. </span><a class="xref" href="GuideImageSearchCache.html" title="Caching Data For Searches">Caching Data For Searches</a>
</li>
<li>
-<span class="label">5.2. </span><a class="xref" href="GuideImageSearchFindingDuplicates.html" title="Finding Duplicates">Finding Duplicates</a>
+<span class="label">5.2. </span><a class="xref" href="GuideImageSearchSearch.html" title="Search Window">Search Window</a>
</li>
<li>
-<span class="label">5.3. </span><a class="xref" href="GuideImageMarks.html" title="Marking Images">Marking Images</a>
+<span class="label">5.3. </span><a class="xref" href="GuideImageSearchFindingDuplicates.html" title="Finding Duplicates">Finding Duplicates</a>
+</li>
+<li>
+<span class="label">5.4. </span><a class="xref" href="GuideImageMarks.html" title="Marking Images">Marking Images</a>
</li>
</ul></div>
</div></div>
<div class="navbar navbar-bottom"><table class="navbar"><tr>
<td class="navbar-prev"><a class="navbar-prev" href="GuideCollections.html" title="Collections">Collections</a></td>
-<td class="navbar-next"><a class="navbar-next" href="GuideImageSearchSearch.html" title="Search Window">Search Window</a></td>
+<td class="navbar-next"><a class="navbar-next" href="GuideImageSearchCache.html" title="Caching Data For Searches">Caching Data For Searches</a></td>
</tr></table></div>
</body>
</html>
<li><a class="xref" href="GuideOtherWindows.html" title="Stand-alone Windows">Stand-alone Windows</a></li>
<li>
<a class="xref" href="GuideImageSearch.html" title="Search and Select">Search and Select</a><div class="autotoc"><ul>
+<li><a class="xref" href="GuideImageSearchCache.html" title="Caching Data For Searches">Caching Data For Searches</a></li>
<li><a class="xref" href="GuideImageSearchSearch.html" title="Search Window">Search Window</a></li>
<li>Finding Duplicates</li>
<li><a class="xref" href="GuideImageMarks.html" title="Marking Images">Marking Images</a></li>
</p>
<div class="autotoc"><ul>
<li>
-<span class="label">5.
2.1. </span><a class="xref" href="GuideImageSearchFindingDuplicates.html#Addingfilestobecompared" title="Adding files to be compared">Adding files to be compared</a>
+<span class="label">5.
3.1. </span><a class="xref" href="GuideImageSearchFindingDuplicates.html#Addingfilestobecompared" title="Adding files to be compared">Adding files to be compared</a>
</li>
<li>
-<span class="label">5.
2.2. </span><a class="xref" href="GuideImageSearchFindingDuplicates.html#Comparisonmethods" title="Comparison methods">Comparison methods</a>
+<span class="label">5.
3.2. </span><a class="xref" href="GuideImageSearchFindingDuplicates.html#Comparisonmethods" title="Comparison methods">Comparison methods</a>
</li>
<li>
-<span class="label">5.
2.3. </span><a class="xref" href="GuideImageSearchFindingDuplicates.html#Resultslist" title="Results list">Results list</a>
+<span class="label">5.
3.3. </span><a class="xref" href="GuideImageSearchFindingDuplicates.html#Resultslist" title="Results list">Results list</a>
</li>
<li>
-<span class="label">5.
2.4. </span><a class="xref" href="GuideImageSearchFindingDuplicates.html#Statusbar" title="Status bar">Status bar</a>
+<span class="label">5.
3.4. </span><a class="xref" href="GuideImageSearchFindingDuplicates.html#Statusbar" title="Status bar">Status bar</a>
</li>
<li>
-<span class="label">5.
2.5. </span><a class="xref" href="GuideImageSearchFindingDuplicates.html#Thumbnails" title="Thumbnails">Thumbnails</a>
+<span class="label">5.
3.5. </span><a class="xref" href="GuideImageSearchFindingDuplicates.html#Thumbnails" title="Thumbnails">Thumbnails</a>
</li>
<li>
-<span class="label">5.
2.6. </span><a class="xref" href="GuideImageSearchFindingDuplicates.html#Rotation" title="Ignore Rotation">Ignore Rotation</a>
+<span class="label">5.
3.6. </span><a class="xref" href="GuideImageSearchFindingDuplicates.html#Rotation" title="Ignore Rotation">Ignore Rotation</a>
</li>
<li>
-<span class="label">5.
2.7. </span><a class="xref" href="GuideImageSearchFindingDuplicates.html#Sort" title="Sort">Sort</a>
+<span class="label">5.
3.7. </span><a class="xref" href="GuideImageSearchFindingDuplicates.html#Sort" title="Sort">Sort</a>
</li>
<li>
-<span class="label">5.
2.8. </span><a class="xref" href="GuideImageSearchFindingDuplicates.html#Comparetwofilesets" title="Compare two file sets">Compare two file sets</a>
+<span class="label">5.
3.8. </span><a class="xref" href="GuideImageSearchFindingDuplicates.html#Comparetwofilesets" title="Compare two file sets">Compare two file sets</a>
</li>
<li>
-<span class="label">5.
2.9. </span><a class="xref" href="GuideImageSearchFindingDuplicates.html#DragandDrop" title="Drag and Drop">Drag and Drop</a>
+<span class="label">5.
3.9. </span><a class="xref" href="GuideImageSearchFindingDuplicates.html#DragandDrop" title="Drag and Drop">Drag and Drop</a>
</li>
<li>
-<span class="label">5.
2.10. </span><a class="xref" href="GuideImageSearchFindingDuplicates.html#ImageDataWindow" title="Image Data Window">Image Data Window</a>
+<span class="label">5.
3.10. </span><a class="xref" href="GuideImageSearchFindingDuplicates.html#ImageDataWindow" title="Image Data Window">Image Data Window</a>
</li>
</ul></div>
<div class="division section">
-<a name="Addingfilestobecompared"></a><div class="header"><h2 class="section title"><span class="title"><span class="label">5.2.1. </span>Adding files to be compared</span></h2></div>
+<a name="Addingfilestobecompared"></a><div class="header"><h2 class="section title"><span class="title"><span class="label">5.3.1. </span>Adding files to be compared</span></h2></div>
<p class="para block block-first">Add files to be compared using drag and drop. Drop files or folders onto the Find Duplicates window to add them to the list of files to compare. When one or more folders are dropped onto the window a menu will appear allowing you to choose the desired action:</p>
<div class="block list variablelist"><dl class="variablelist">
<dt class="term dt-first">
</dl></div>
</div>
<div class="division section">
-<a name="Comparisonmethods"></a><div class="header"><h2 class="section title"><span class="title"><span class="label">5.2.2. </span>Comparison methods</span></h2></div>
+<a name="Comparisonmethods"></a><div class="header"><h2 class="section title"><span class="title"><span class="label">5.3.2. </span>Comparison methods</span></h2></div>
<p class="para block block-first">
The attribute to use for two images to match can be selected with the
<span class="emphasis emphasis-bold">Compare by:</span>
</dl></div>
</div>
<div class="division section">
-<a name="Resultslist"></a><div class="header"><h2 class="section title"><span class="title"><span class="label">5.2.3. </span>Results list</span></h2></div>
+<a name="Resultslist"></a><div class="header"><h2 class="section title"><span class="title"><span class="label">5.3.3. </span>Results list</span></h2></div>
<p class="para block block-first">Files that match with the selected comparison method will appear in the list. Matching files are grouped in alternating color.</p>
<p class="para block">The order of the result list can not be changed, files will appear in the order of the search. When comparing by image content similarity, the matching groups will be sorted by order of rank starting with the files that are most similar.</p>
<p class="para block">
<p class="para block">The image Dimensions column of the result list will only contain dimension information when comparing by dimensions, or when the data is easily available from memory or has been read from the cache.</p>
</div>
<div class="division section">
-<a name="Statusbar"></a><div class="header"><h2 class="section title"><span class="title"><span class="label">5.2.4. </span>Status bar</span></h2></div>
+<a name="Statusbar"></a><div class="header"><h2 class="section title"><span class="title"><span class="label">5.3.4. </span>Status bar</span></h2></div>
<p class="para block block-first">Along the bottom of the Find Duplicates window is an area that displays the count of files contained in the window, and the number of files in the result list.</p>
<p class="para block">The status bar will also display the status of an active compare operation using the progress bar. A compare operation involves 2 or 3 stages, depending on the type of comparison. These are the stages in order:</p>
<div class="block list orderedlist"><ol class="orderedlist">
</ol></div>
</div>
<div class="division section">
-<a name="Thumbnails"></a><div class="header"><h2 class="section title"><span class="title"><span class="label">5.2.5. </span>Thumbnails</span></h2></div>
+<a name="Thumbnails"></a><div class="header"><h2 class="section title"><span class="title"><span class="label">5.3.5. </span>Thumbnails</span></h2></div>
<p class="para block block-first">Thumbnails can be displayed beside each image in the result list by enabling the Thumbnails check box.</p>
</div>
<div class="division section">
-<a name="Rotation"></a><div class="header"><h2 class="section title"><span class="title"><span class="label">5.2.6. </span>Ignore Rotation</span></h2></div>
+<a name="Rotation"></a><div class="header"><h2 class="section title"><span class="title"><span class="label">5.3.6. </span>Ignore Rotation</span></h2></div>
<p class="para block block-first">When checked, the rotational orientation of images will be ignored.</p>
</div>
<div class="division section">
-<a name="Sort"></a><div class="header"><h2 class="section title"><span class="title"><span class="label">5.2.7. </span>Sort</span></h2></div>
+<a name="Sort"></a><div class="header"><h2 class="section title"><span class="title"><span class="label">5.3.7. </span>Sort</span></h2></div>
<p class="para block block-first">
The normal sort order is for groups (in the case of Similarity checks) with the highest number of near-100% matches to be at the top of the list.
<p class="para block block-first"></p>
</p>
</div>
<div class="division section">
-<a name="Comparetwofilesets"></a><div class="header"><h2 class="section title"><span class="title"><span class="label">5.2.8. </span>Compare two file sets</span></h2></div>
+<a name="Comparetwofilesets"></a><div class="header"><h2 class="section title"><span class="title"><span class="label">5.3.8. </span>Compare two file sets</span></h2></div>
<p class="para block block-first">Sometimes it is useful to compare one group of files to another, different group of files. Enable this check box to compare two groups of files. When enabled, a second list will appear and files can be added to this list using the same methods for the main list.</p>
<p class="para block">When comparing two file sets the results list will display matches between the two lists. For each match group, the first file is always from the main group, and the remaining files are always from the second group.</p>
</div>
<div class="division section">
-<a name="DragandDrop"></a><div class="header"><h2 class="section title"><span class="title"><span class="label">5.2.9. </span>Drag and Drop</span></h2></div>
+<a name="DragandDrop"></a><div class="header"><h2 class="section title"><span class="title"><span class="label">5.3.9. </span>Drag and Drop</span></h2></div>
<p class="para block block-first">Drag and drop can be initiated with the primary or middle mouse buttons. Dragging a file that is selected will include all selected files in the drag. Dragging a file that is not selected will first change the selection to the dragged file, and clear the previous selection.</p>
</div>
<div class="division section">
-<a name="ImageDataWindow"></a><div class="header"><h2 class="section title"><span class="title"><span class="label">5.2.10. </span>Image Data Window</span></h2></div>
+<a name="ImageDataWindow"></a><div class="header"><h2 class="section title"><span class="title"><span class="label">5.3.10. </span>Image Data Window</span></h2></div>
<p class="para block block-first">
<span class="code" dir="ltr">Ctrl+Shift+Right Mouse click</span>
: Use this to display a dialog containing the data stored for the clicked image file. This is usually only useful for debugging purposes.
<head>
<meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
<title>Search Window</title>
-<link rel="previous" href="GuideImageSearchSearch.html" title="Search Window">
+<link rel="previous" href="GuideImageSearchCache.html" title="Caching Data For Searches">
<link rel="next" href="GuideImageSearchFindingDuplicates.html" title="Finding Duplicates">
<link rel="top" href="GuideIndex.html" title="The Geeqie User Manual">
<style type="text/css">
</head>
<body>
<div class="navbar navbar-top"><table class="navbar"><tr>
-<td class="navbar-prev"><a class="navbar-prev" href="GuideImageSearchSearch.html" title="Search Window">Search Window</a></td>
+<td class="navbar-prev"><a class="navbar-prev" href="GuideImageSearchCache.html" title="Caching Data For Searches">Caching Data For Searches</a></td>
<td class="navbar-next"><a class="navbar-next" href="GuideImageSearchFindingDuplicates.html" title="Finding Duplicates">Finding Duplicates</a></td>
</tr></table></div>
<div class="sidebar"><div class="sidenav"><div class="autotoc"><ul>
<li><a class="xref" href="GuideOtherWindows.html" title="Stand-alone Windows">Stand-alone Windows</a></li>
<li>
<a class="xref" href="GuideImageSearch.html" title="Search and Select">Search and Select</a><div class="autotoc"><ul>
+<li><a class="xref" href="GuideImageSearchCache.html" title="Caching Data For Searches">Caching Data For Searches</a></li>
<li>Search Window</li>
<li><a class="xref" href="GuideImageSearchFindingDuplicates.html" title="Finding Duplicates">Finding Duplicates</a></li>
<li><a class="xref" href="GuideImageMarks.html" title="Marking Images">Marking Images</a></li>
<p class="para block"></p>
<div class="autotoc"><ul>
<li>
-<span class="label">5.
1.1. </span><a class="xref" href="GuideImageSearchSearch.html#Searchlocation" title="Search location">Search location</a>
+<span class="label">5.
2.1. </span><a class="xref" href="GuideImageSearchSearch.html#Searchlocation" title="Search location">Search location</a>
</li>
<li>
-<span class="label">5.
1.2. </span><a class="xref" href="GuideImageSearchSearch.html#Searchparameters" title="Search parameters">Search parameters</a>
+<span class="label">5.
2.2. </span><a class="xref" href="GuideImageSearchSearch.html#Searchparameters" title="Search parameters">Search parameters</a>
</li>
<li>
-<span class="label">5.
1.3. </span><a class="xref" href="GuideImageSearchSearch.html#Resultslist" title="Results list">Results list</a>
+<span class="label">5.
2.3. </span><a class="xref" href="GuideImageSearchSearch.html#Resultslist" title="Results list">Results list</a>
</li>
<li>
-<span class="label">5.
1.4. </span><a class="xref" href="GuideImageSearchSearch.html#Statusbar" title="Status bar">Status bar</a>
+<span class="label">5.
2.4. </span><a class="xref" href="GuideImageSearchSearch.html#Statusbar" title="Status bar">Status bar</a>
</li>
<li>
-<span class="label">5.
1.5. </span><a class="xref" href="GuideImageSearchSearch.html#DragandDrop" title="Drag and Drop">Drag and Drop</a>
+<span class="label">5.
2.5. </span><a class="xref" href="GuideImageSearchSearch.html#DragandDrop" title="Drag and Drop">Drag and Drop</a>
</li>
</ul></div>
<div class="division section">
-<a name="Searchlocation"></a><div class="header"><h2 class="section title"><span class="title"><span class="label">5.1.1. </span>Search location</span></h2></div>
+<a name="Searchlocation"></a><div class="header"><h2 class="section title"><span class="title"><span class="label">5.2.1. </span>Search location</span></h2></div>
<p class="para block block-first">One of several locations can be chosen as the source to use in the search.</p>
<div class="block list variablelist"><dl class="variablelist">
<dt class="term dt-first">
<p class="para block"></p>
</div>
<div class="division section">
-<a name="Searchparameters"></a><div class="header"><h2 class="section title"><span class="title"><span class="label">5.1.2. </span>Search parameters</span></h2></div>
+<a name="Searchparameters"></a><div class="header"><h2 class="section title"><span class="title"><span class="label">5.2.2. </span>Search parameters</span></h2></div>
<p class="para block block-first">Each search parameter can be enabled or disabled with the check box to its left. For a file to be a match, all enabled parameters must be true.</p>
<div class="block list variablelist"><dl class="variablelist">
<dt class="term dt-first">
<p class="para block"></p>
</div>
<div class="division section">
-<a name="Resultslist"></a><div class="header"><h2 class="section title"><span class="title"><span class="label">5.1.3. </span>Results list</span></h2></div>
+<a name="Resultslist"></a><div class="header"><h2 class="section title"><span class="title"><span class="label">5.2.3. </span>Results list</span></h2></div>
<p class="para block block-first">Files that match the parameters of the search are shown in the list. By default they are displayed in the order that they are found. To sort the results list by a column, activate or click the column title. Activating a column that is already used to sort the list will toggle between increasing and decreasing sort order.</p>
<p class="para block">
A
<p class="para block"></p>
</div>
<div class="division section">
-<a name="Statusbar"></a><div class="header"><h2 class="section title"><span class="title"><span class="label">5.1.4. </span>Status bar</span></h2></div>
+<a name="Statusbar"></a><div class="header"><h2 class="section title"><span class="title"><span class="label">5.2.4. </span>Status bar</span></h2></div>
<p class="para block block-first">At the bottom of the search window is an area that includes the following items from left to right:</p>
<div class="block list variablelist">
<p class="para block"></p>
<p class="para block"></p>
</div>
<div class="division section">
-<a name="DragandDrop"></a><div class="header"><h2 class="section title"><span class="title"><span class="label">5.1.5. </span>Drag and Drop</span></h2></div>
+<a name="DragandDrop"></a><div class="header"><h2 class="section title"><span class="title"><span class="label">5.2.5. </span>Drag and Drop</span></h2></div>
<p class="para block block-first">Drag and drop can be initiated with the primary or middle mouse buttons. Dragging a file that is selected will include all selected files in the drag. Dragging a file that is not selected will first change the selection to the dragged file, and clear the previous selection.</p>
<p class="para block"></p>
</div>
</div></div>
<div class="navbar navbar-bottom"><table class="navbar"><tr>
-<td class="navbar-prev"><a class="navbar-prev" href="GuideImageSearchSearch.html" title="Search Window">Search Window</a></td>
+<td class="navbar-prev"><a class="navbar-prev" href="GuideImageSearchCache.html" title="Caching Data For Searches">Caching Data For Searches</a></td>
<td class="navbar-next"><a class="navbar-next" href="GuideImageSearchFindingDuplicates.html" title="Finding Duplicates">Finding Duplicates</a></td>
</tr></table></div>
</body>
<li>
<span class="label">5. </span><a class="xref" href="GuideImageSearch.html" title="Search and Select">Search and Select</a><div class="autotoc"><ul>
<li>
-<span class="label">5.1. </span><a class="xref" href="GuideImageSearchSearch.html" title="Search Window">Search Window</a>
+<span class="label">5.1. </span><a class="xref" href="GuideImageSearchCache.html" title="Caching Data For Searches">Caching Data For Searches</a>
</li>
<li>
-<span class="label">5.2. </span><a class="xref" href="GuideImageSearchFindingDuplicates.html" title="Finding Duplicates">Finding Duplicates</a>
+<span class="label">5.2. </span><a class="xref" href="GuideImageSearchSearch.html" title="Search Window">Search Window</a>
</li>
<li>
-<span class="label">5.3. </span><a class="xref" href="GuideImageMarks.html" title="Marking Images">Marking Images</a>
+<span class="label">5.3. </span><a class="xref" href="GuideImageSearchFindingDuplicates.html" title="Finding Duplicates">Finding Duplicates</a>
+</li>
+<li>
+<span class="label">5.4. </span><a class="xref" href="GuideImageMarks.html" title="Marking Images">Marking Images</a>
</li>
</ul></div>
</li>
projects / geeqie.git / commitdiff