doc/docbook/GuideImageSearch.xml

   1 <?xml version="1.0" encoding="utf-8"?>\r
   2 <chapter id="GuideImageSearch">\r
   3   <title id="titleGuideImageSearch">Search and Select</title>\r
   4   <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
   5   <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
   6   <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
   7   <section id="GuideImageSearchCache">\r
   8     <title id="titleGuideImageSearchCache">Caching Data For Searches</title>\r
   9     <para>\r
  10       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
  11       <para />\r
  12       If the\r
  13       <link linkend="PreferencesThumbnails">Cache Thumbnails</link>\r
  14       option is selected in Preferences/General, the similarity matrix, checksum, image size and Exif Date may also be cached. This will reduce the time needed for future searches.\r
  15       <note>\r
  16         If you frequently search on similarity and your images are in a tree arrangement under a single point, the\r
  17         <link linkend="CreateSimFiles">Create file similarity cache</link>\r
  18         from the top of the tree will generate the similarity data for all images.\r
  19       </note>\r
  20       <para>Similarity data are stored in a folder hierarchy 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
  21       <para>\r
  22         The root of the hierarchy is:\r
  23         <para>\r
  24           <programlisting>$XDG_CACHE_HOME/geeqie/thumbnails/</programlisting>\r
  25           or, if $XDG_CACHE_HOME is not defined:\r
  26           <programlisting>$HOME/.cache/geeqie/thumbnails/</programlisting>\r
  27         </para>\r
  28       </para>\r
  29     </para>\r
  30     <para />\r
  31   </section>\r
  32   <xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="GuideImageSearchSearch.xml" />\r
  33   <xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="GuideImageSearchFindingDuplicates.xml" />\r
  34   <xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="GuideImageMarks.xml" />\r
  35   <para />\r
  36 </chapter>\r