c:geo User Guide

User Tools

Site Tools

You are here: c:geo User Guide » c:geo User Guide » Cache Filtering
Trace:
en:cachefilter

Differences

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

Link to this comparison view

Both sides previous revisionPrevious revision
Next revision		Previous revision
Next revisionBoth sides next revision
en:cachefilter [2021/07/07 08:27] – eddiemucen:cachefilter [2021/07/27 11:07] – [Status filter] lineflyer
Line 1: Line 1:
 ====== Cache Filtering ====== ====== Cache Filtering ======
  
-Cache filtering can be applied at various places in c:geo e.g. on the [[:en:mainmenu:livemap|Live Map]], in [[:en:mainmenu:lists|Stored Caches]] or when performing online cache [[:en:mainmenu:search|Search]]. In all these places, the same filter mechanism is used.+Cache filtering can be applied at various places in c:geo e.g. on the [[.:mainmenu:livemap|Live Map]], in [[.:mainmenu:lists|Stored Caches]] or when performing online cache [[.:mainmenu:search|Search]]. In all these places, the same filter mechanism is used.
  
 ===== Accessing filter ===== ===== Accessing filter =====
Line 7: Line 7:
 Filter settings are reachable via the options menu by clicking the filter icon {{:ic_menu_filter.png?nolink&30|}}.  Filter settings are reachable via the options menu by clicking the filter icon {{:ic_menu_filter.png?nolink&30|}}. 
  
-In case a filter is already active, it is shown as a header line below the title bar. by clicking this header line, the filter settings can also be reached. For example, the following screenshot shows both the filter icon as well as the filter header line (circled in red) where the current filter is set to only show caches of type "Traditional". +In case a filter is already active, it is shown as a header line below the title bar. By tapping this header line, the filter settings can also be reached. For example, the following screenshot shows both the filter icon as well as the filter header line (circled in red) where the current filter is set to only show caches of type "Traditional". 
  
 {{ :en:filter-access.png?direct&400 |}} {{ :en:filter-access.png?direct&400 |}}
Line 23: Line 23:
 |{{:abc_ic_cab_done_holo_light.png?nolink&30 |}} | Apply | Closes the dialog and applies the current filter settings to the caches in the current context. | |{{:abc_ic_cab_done_holo_light.png?nolink&30 |}} | Apply | Closes the dialog and applies the current filter settings to the caches in the current context. |
 |{{:abc_ic_clear_normal.png?nolink&30 |}} | Cancel | Closes the dialog and aborts the filter changes. | |{{:abc_ic_clear_normal.png?nolink&30 |}} | Cancel | Closes the dialog and aborts the filter changes. |
-|{{:ic_menu_delete.png?nolink&30 |}} | Clear | Clears the current filter, e.g. sets it to a state where is doesn't filter anything (all cache types checked, all difficulties/terrain values selected). |+|{{:ic_menu_delete.png?nolink&30 |}} | Clear | Clears the current filter, i.e. sets it to a state where is doesn't filter anything (all cache types checked, all difficulties/terrain values selected). |
 |{{:en:filter-advanced-switch.png?nolink&150|}}| Basic/Advanced mode switch | Switches between basic and [[#filter_advanced|advanced]] filter mode. | |{{:en:filter-advanced-switch.png?nolink&150|}}| Basic/Advanced mode switch | Switches between basic and [[#filter_advanced|advanced]] filter mode. |
  
Line 35: Line 35:
 Filter by cache type. Use checkboxes to mark/unmark the cache types you want to include in the result list. Use **Select all** checkbox to quickly mark/unmark all cache types. Filter by cache type. Use checkboxes to mark/unmark the cache types you want to include in the result list. Use **Select all** checkbox to quickly mark/unmark all cache types.
  
-c:geo supports over 20 cache types from across many geocaching services. Thus, to easify filter dialog, some selectable cache types will group other cache types. This logic was copied as closely as possible from geocaching.com behaviour:+c:geo supports over 20 cache types from across many geocaching services. Thus, to easify filter dialog, some selectable cache types will group other cache types. This logic was copied as closely as possible from geocaching.com behavior:
 ^ Icon ^ Cache Type Filter ^ Filters the following cache types ^ ^ Icon ^ Cache Type Filter ^ Filters the following cache types ^
 | {{ :type_traditional.png?nolink&50 |}} | Tradi | Traditional Cache, Geocaching HQ, Project APE Cache | | {{ :type_traditional.png?nolink&50 |}} | Tradi | Traditional Cache, Geocaching HQ, Project APE Cache |
Line 50: Line 50:
  
 {{anchor:filter_advanced:}} {{anchor:filter_advanced:}}
 +
 +==== Basic status filter ====
 +
 +Allows to filter by the current state of a cache. You can select whether to filter out caches by their state. This filter is also available with more options in the [[#filter_advanced|advanced]] mode.
 +
 +To include/exclude caches in states **Active**, **Disabled** or **Archived**, mark/unmark the respective chips at the top of the filter.
 +
 +The other status options all allow you to set one of three values for it:
 +* **All**: Caches should not be filtered according to this criteria.
 +* **Yes**: Only caches meeting this criteria will be included in result. For example, setting **Found** to //Yes// will lead to only found caches being included in the filter result.
 +* **No**: Only caches **NOT** meeting this criteria will be included in result. For example, setting **Found** to //No// will lead to only not-found caches being included in the filter result.
 +
 +The following status filters are available (Description says what is filtered if you choose //Yes//):
 +
 +^ Status Filter ^ Description ^ 
 +| Found | Filters for caches you have found. | 
 +| Owned | Filters for caches you own. | 
 +| Has Offline Log | Filters caches which have a locally stored offline log. |
 +
 ===== Advanced filtering ===== ===== Advanced filtering =====
 +
 +{{anchor:filter_advanced:}}
  
 To use advanced filter functions, turn on the **Basic/Advanced mode switch**. This will change the layout of the filter dialog to something like this: To use advanced filter functions, turn on the **Basic/Advanced mode switch**. This will change the layout of the filter dialog to something like this:
Line 60: Line 81:
 ==== Creating and deleting filter criteria ==== ==== Creating and deleting filter criteria ====
  
-In **Basic** mode, the available filter criteria are fixed to exactly //Cache Type//, //Difficulty// and //Terrain//.+In **Basic** mode, the available filter criteria are fixed to exactly //Cache Type//, //Difficulty// and //Terrain// as well as a basic //status// filter.
 In **Advanced** mode you may freely add or delete filter criteria to build up you own personal filter. You may even add the same filter criteria multiple times, e.g. to create a filter containing multiple text pieces in the cache name. In **Advanced** mode you may freely add or delete filter criteria to build up you own personal filter. You may even add the same filter criteria multiple times, e.g. to create a filter containing multiple text pieces in the cache name.
  
Line 69: Line 90:
 {{ :en:filter-advanced-criterias.png?direct&300 |}}  {{ :en:filter-advanced-criterias.png?direct&300 |}} 
  
-Choosing one of the criterias will add the respective filter to the criteria list. All criterias are explained [[#filter_criterias|here]].+Choosing one of the criteria will add the respective filter to the criteria list. All criteria are explained [[#filter_criterias|here]].
  
 To remove a filter criteria, tap the trash icon {{:ic_menu_delete.png?nolink&30 |}} in its upper right corner. To remove a filter criteria, tap the trash icon {{:ic_menu_delete.png?nolink&30 |}} in its upper right corner.
  
-To change the order of filter criterias in the list, tap&drag the drag icon {{:settings_details_black.png?nolink&30 |}} in its upper right corner.+To change the order of filter criteria in the list, tap&drag the drag icon {{:settings_details_black.png?nolink&30 |}} in its upper right corner.
  
 ==== Load and save filters ==== ==== Load and save filters ====
Line 96: Line 117:
  
 ^ Function ^ Description ^ ^ Function ^ Description ^
-| Use OR instead of AND | Usually, the filter criterias are connected using an AND logic (as described in [[#filter_basic:Basic mode]]). When this checkbox is marked, they are connected using OR logic.  | +| Use OR instead of AND | Usually, the filter criteria are connected using an AND logic (as described in [[#filter_basic:Basic mode]]). When this checkbox is marked, they are connected using OR logic.  | 
-| Inverse Filter | If this checkbox is checked, the logic of the filter is inversed (in other words: a NOT is applied in front of it). All caches filters by the expression before are now NOT filtered and vice versa |+| Inverse Filter | If this checkbox is checked, the logic of the filter is inverted (in other words: a NOT is applied in front of it). All caches filters by the expression before are now NOT filtered and vice versa |
 | Include inconclusive matches | In some situations, some filters can't be evaluated by c:geo. For example, for not locally stored caches, the //attributes// filter cannot be evaluated. Caches falling in this category are said to be 'inconclusive' because c:geo can't decide whether they fulfill the filter criteria or not. Normally such caches are NOT shown in the result list. By marking this checkbox, you may tell c:geo to SHOW such caches in the result list. | | Include inconclusive matches | In some situations, some filters can't be evaluated by c:geo. For example, for not locally stored caches, the //attributes// filter cannot be evaluated. Caches falling in this category are said to be 'inconclusive' because c:geo can't decide whether they fulfill the filter criteria or not. Normally such caches are NOT shown in the result list. By marking this checkbox, you may tell c:geo to SHOW such caches in the result list. |
  
 {{anchor:filter_criterias:}} {{anchor:filter_criterias:}}
-===== Available filter criterias =====+===== Available filter criteria =====
  
-The following table lists all available filter criterias. Those criterias can be used to build up arbitrarly complex filters in **Advanced** mode. +The following table lists all available filter criteria. Those criteria can be used to build up arbitrary complex filters in **Advanced** mode. 
-In follow-up sections, some filter criterias are explained in more detail.+In follow-up sections, some filter criteria are explained in more detail.
  
 ==== Category "Basic" ==== ==== Category "Basic" ====
Line 120: Line 141:
 ^ Filter ^ Description ^  ^ Filter ^ Description ^ 
 | Cache Attributes | Filters caches using Cache Attributes e.g. "Recommended for kids" or "Stealth necessary". This filter is explained in more details [[#filter_criteria_attributes|here]]. | | Cache Attributes | Filters caches using Cache Attributes e.g. "Recommended for kids" or "Stealth necessary". This filter is explained in more details [[#filter_criteria_attributes|here]]. |
-| Cache Size | Filters caches for her size (e.g. Regular, Small, Micro). This filter is explained in more details [[#filter_criteria_size|here]]. | +| Cache Size | Filters caches by their size (e.g. Regular, Small, Micro). This filter is explained in more details [[#filter_criteria_size|here]]. | 
-| Difficulty | Filters caches for her difficulty. This is a basic filter which is described [[#filter_basic_difficultyterrain|here]]. | +| Difficulty | Filters caches by their difficulty. This is a basic filter which is described [[#filter_basic_difficultyterrain|here]]. | 
-| Favorites | Filters caches for hassigned favorite points. This filter is explained in more details [[#filter_criteria_favorites|here]]. |+| Favorites | Filters caches by assigned favorite points. This filter is explained in more details [[#filter_criteria_favorites|here]]. |
 | Last Found Date | A [[#filter_criteria_date|date filter]] for the cache's last found date. | | Last Found Date | A [[#filter_criteria_date|date filter]] for the cache's last found date. |
 | Location | A [[#filter_criteria_text|text filter]] for the cache's Location (e.g. Country or State). On typing this text filter will make completion suggestions such as "Germany" or "Bavaria" depending on the locations of caches stored on your device. | | Location | A [[#filter_criteria_text|text filter]] for the cache's Location (e.g. Country or State). On typing this text filter will make completion suggestions such as "Germany" or "Bavaria" depending on the locations of caches stored on your device. |
 | Log Entry | Filters caches based on content stored in one of it's log entries. This filter is explained in more details [[#filter_criteria_logentry|here]]. | | Log Entry | Filters caches based on content stored in one of it's log entries. This filter is explained in more details [[#filter_criteria_logentry|here]]. |
 | Logs Count | Filters caches based on logs count. This filter is explained in more details [[#filter_criteria_logscount|here]]. | | Logs Count | Filters caches based on logs count. This filter is explained in more details [[#filter_criteria_logscount|here]]. |
-| Origin | Filters caches based on their origin e.g. //Geocaching.com// or //opencaching.de//. Mark the entries of the origins you want to see in the result list, use //Add more items// button to see more Origins to add. | +| Origin | Filters caches based on their origin e.g. //Geocaching.com// or //opencaching.de//. This is a [[#filter_criteria_dynamiccheckboxlist|Dynamic checkbox filter]]. | 
-| Terrain | Filters caches for her terrain. This is a basic filter which is described [[#filter_basic_difficultyterrain|here]]. |+| Terrain | Filters caches by their terrain. This is a basic filter which is described [[#filter_basic_difficultyterrain|here]]. |
  
 ==== Category "User Specific" ==== ==== Category "User Specific" ====
Line 136: Line 157:
 | Offline Log | A [[#filter_criteria_text|text filter]] for existing offline logs. |  | Offline Log | A [[#filter_criteria_text|text filter]] for existing offline logs. | 
 | Personal Note | A [[#filter_criteria_text|text filter]] for cache's personal note. |  | Personal Note | A [[#filter_criteria_text|text filter]] for cache's personal note. | 
-| Stored Lists | Filters caches based on their presence in a user-defined list. Mark the entries of the list(s) you want to see in the result list, use //Add more items// button to see more Lists to add. | +| Stored Lists | Filters caches based on their presence in a user-defined list. This is a [[#filter_criteria_dynamiccheckboxlist|Dynamic checkbox filter]]. | 
 | Stored Since | Filters caches based on their storage age in c:geo (e.g. how many days ago was this cache's offline data last refreshed). |  | Stored Since | Filters caches based on their storage age in c:geo (e.g. how many days ago was this cache's offline data last refreshed). | 
  
Line 146: Line 167:
 ==== Text filters ==== ==== Text filters ====
  
-Text filters filter for a text in a specific field of the cache data, e.g. Name or Description. They all work the same way and are explained here using //Cache Name// as an example.+Text filters filter for a text in a specific field of the cache data, e.g. //Name// or //Description//. They all work the same way and are explained here using //Cache Name// as an example.
  
-TODO+{{ :en:filter-criteria-textfilter.png?direct&400 |}}  
 + 
 +The type of text filtering can be selected by tapping the **Text filter type** button which initially shows the value //Contains//. 
 +The text type together with the text value entered in field **Search Text** determines which caches are filtered. 
 + 
 +^ Filter Type ^ Description ^  
 +| Is Present | Filters all caches where the filtered field has a non-empty value. |  
 +| Is Not Present | Filters all caches where the filtered field has no value or an empty value. |  
 +| Contains | Filters all caches where the filtered field contains the **Search Text** at any position. |  
 +| Starts With | Filters all caches where the filtered field starts with the **Search Text**. |  
 +| Ends With | Filters all caches where the filtered field ends with the **Search Text**. |  
 +| Pattern | Filters all caches where the filtered fields value corresponds to the Pattern given in the **Search Text**. You may use the wildcards **?** and *****. A ***** represents zero, one or multiple characters, while a **?** represents only one single character. For example, pattern ''H?mburg*'' will match e.g. ''Homburg'' or ''Hamburg at Night'' but not ''A day in Hamburg'' or ''Hahmburg'' | 
 + 
 +Use the **Match case** checkbox to decide whether text matching should occur case-sensitive or not. 
  
 {{anchor:filter_criteria_text:}} {{anchor:filter_criteria_text:}}
Line 155: Line 189:
 Date filters filter for a date in a specific date field of the cache data, e.g. the hidden date. They all work the same way and are explained here using //Hidden Date// as an example. Date filters filter for a date in a specific date field of the cache data, e.g. the hidden date. They all work the same way and are explained here using //Hidden Date// as an example.
  
-TODO+{{ :en:filter-criteria-datefilter.png?direct&400 |}}  
 + 
 +This type of filter let's you search for a From - To Date range, where both From and To can optionally be empty. Tap on the respective buttons next to the **From** / **To** label to set a date. In the date picker dialog, you may choose the button **Clear** to clear the date.
  
 {{anchor:filter_criteria_status:}} {{anchor:filter_criteria_status:}}
Line 162: Line 198:
 The status filter filters for various cache status values and looks like this: The status filter filters for various cache status values and looks like this:
  
-TODO+{{ :en:filter-criteria-status.png?direct&400 |}}  
 + 
 +To include/exclude caches in states **Active**, **Disabled** or **Archived**, mark/unmark the respective chips at the top of the filter. 
 + 
 +The other status options all allow you to set one of three values for it: 
 + 
 +|**All**| Caches should not be filtered according to this criteria.| 
 +|**Yes**| Only caches meeting this criteria will be included in result. For example, setting **Found** to //Yes// will lead to only found caches being included in the filter result.| 
 +|**No**| Only caches **NOT** meeting this criteria will be included in result. For example, setting **Found** to //No// will lead to only not-found caches being included in the filter result.| 
 + 
 +The following status filters are available (Description says what is filtered if you choose //Yes//): 
 + 
 +^ Status Filter ^ Description ^  
 +| Found | Filters for caches you have found. |  
 +| Owned | Filters for caches you own. |  
 +| Stored | Filters for caches which are stored locally. | 
 +| Own Favorite | Filters for caches where you gave a favorite point. | 
 +| On Watchlist | Filters for caches on your watchlist. | 
 +| Premium | Filters for Premium caches (geocaching.com only) | 
 +| Has Trackable | Filters caches which have at least one trackable associated with them. | 
 +| Has Own Vote | Filters caches where you gave a vote. | 
 +| Has Offline Log | Filters caches which have a locally stored offline log. | 
 +| Solved Mystery | Filters mystery caches which are considered //solved//. A mystery is considered //solved// if it has either changed coordinates or a valid final waypoint filled with coordinates. | 
  
 {{anchor:filter_criteria_attributes:}} {{anchor:filter_criteria_attributes:}}
Line 169: Line 228:
 The attributes filter filters for various cache attributes values and looks like this: The attributes filter filters for various cache attributes values and looks like this:
  
-TODO+{{ :en:filter-criteria-attributes.png?direct&400 |}}  
 + 
 +Check multiple cache attributes to filter caches which have **all** of the selected attributes attached to them. Note that geocaching.com also supports negative attribute assignment, tap attribute symbol again to select it's //negative// version. 
 + 
 +Perform a long tap on an icon to see its meaning as a tool tip text. 
 + 
 +Use **Include** / **Exclude** toggle to filter for caches either **including** or **excluding** all of the selected attributes. 
 + 
 +use the **Clear** button in the upper right to deselect all cache attributes quickly.
  
 {{anchor:filter_criteria_size:}} {{anchor:filter_criteria_size:}}
Line 176: Line 243:
 The size filter filters for cache sizes such as //Regular//, //Small// and //Micro//), and looks like this: The size filter filters for cache sizes such as //Regular//, //Small// and //Micro//), and looks like this:
  
-TODO+{{ :en:filter-criteria-cachesize.png?direct&400 |}}  
 + 
 +Mark all size chips where you want to filter caches for. Use the special //Select all// chip to quickly mark or unmark all available size options.
  
 {{anchor:filter_criteria_favorites:}} {{anchor:filter_criteria_favorites:}}
Line 183: Line 252:
 The favorites filter filters for favorite points assigned to a cache, and looks like this: The favorites filter filters for favorite points assigned to a cache, and looks like this:
  
-TODO+{{ :en:filter-criteria-favorites.png?direct&400 |}}  
 + 
 +Use the **Absolute** / **Percentage** toggle to choose whether to filter for absolute favorite point count or for percentage of favorited logs in comparison with all found logs. Note that the scale of the slider below will change/reset if you toggle this value. 
 + 
 +In **Absolute** mode, select on the scale the range of favorite points you want to filter. Selecting the very right point of the scale will result in filtering all caches with > 1000 favorite points. 
 + 
 +In **Percentage** mode, use the scale to select a percentage range between 0% and 100% to filter.
  
 {{anchor:filter_criteria_logentry:}} {{anchor:filter_criteria_logentry:}}
 ==== Log Entry filter ==== ==== Log Entry filter ====
  
-The logentry filter filters caches based on their log entries, and looks like this:+The log entry filter filters caches based on their log entries, and looks like this:
  
-TODO+{{ :en:filter-criteria-logentry.png?direct&400 |}}  
 + 
 +You may choose to filter caches with a log entry: 
 +  * by a specific user (e.g. //EddieMuc//), or  
 +  * containing a specific text (e.g. //TFTC//) 
 + 
 +Use **Include** / **Exclude** toggle to filter for caches either **having** or **not having** a log entry satisfying the selected criterias.
  
 {{anchor:filter_criteria_logscount:}} {{anchor:filter_criteria_logscount:}}
Line 197: Line 278:
 The logs count filter filters caches based on their logs count, and looks like this: The logs count filter filters caches based on their logs count, and looks like this:
  
-TODO+{{ :en:filter-criteria-logscount.png?direct&400 |}}  
 + 
 +Tap on the **Log Count Type** combo box (initially set to //Found It//) to select the type of log for whose count you want to filter. Select one of //Found it//, //Didn't find it// or //All logs//. 
 + 
 +In the slider below, select the range of logs count you want to filter caches for. Selecting the very right point of the slider will result in filtering all caches with > 1000 logs of the specified type.
  
 {{anchor:filter_criteria_distance:}} {{anchor:filter_criteria_distance:}}
Line 204: Line 289:
 The distance filter filters caches based on their distance from a certain point, and looks like this: The distance filter filters caches based on their distance from a certain point, and looks like this:
  
-TODO+{{ :en:filter-criteria-distance.png?direct&400 |}}  
 + 
 +  * Mark the //Use current position// checkbox to base the distance calculation on your current GPS position 
 +  * Enter a valid WGS84-coordinate in the text field to use it as the base for the distance calculation. 
 +  * Use the slider below to select the min and max distance (in kilometers/miles) of caches within the base coordinate to include in the filter result. 
 + 
 +{{anchor:filter_criteria_dynamiccheckboxlist:}} 
 +==== Dynamic Checkbox filters ==== 
 + 
 +Dynamic Checkboxlist filters filters for one or multiple value from a more dynamic list. Example filters using this are //Origin// and //Stored List// filter: 
 + 
 +{{ :en:filter-criteria-dynamiccheckboxlist.png?direct&400 |}} 
  
 +Mark the items on the list you want to see in the result list. Use the //Add more items// button to see more items to add.
  
en/cachefilter.txt · Last modified: 2024/06/11 23:25 by murggel

Page Tools

Except where otherwise noted, content on this wiki is licensed under the following license: CC Attribution-Noncommercial-Share Alike 4.0 International
CC Attribution-Noncommercial-Share Alike 4.0 International Donate Powered by PHP Valid HTML5 Valid CSS Driven by DokuWiki