11,036
edits
Changes
no edit summary
{{#vardefine:chapter|16}}
{{#vardefine:figure|0}}
[[File:DefineFilter-dialog-default-50.png|right|thumb|450px|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} {{man label|[[Gramps_5.1_Wiki_Manual_Gramps_{{Version manual}}_Wiki_Manual_-_Filters#Define_Filter_dialog|Define filter]]}} - dialog - default]]
Lists of all the filter rules currently defined in Gramps. Each of these rules is available for use when creating custom filters.
The rules are listed by their [[Gramps_5.1_Wiki_Manual_Gramps_{{Version manual}}_Wiki_Manual_-_Filters#Which_filters_in_which_Category.3F|categories]].
== Filter vs. Search ==
There are two ways to find data in Gramps: Search and Filter. Search uses the [[Gramps_5.1_Wiki_Manual_Gramps_{{Version manual}}_Wiki_Manual_-_Main_Window#Search_bar|Search Bar]] above a listing View (such as People, Families, etc). Filter can be used in combination with Search, or stand-alone in the sidebar/bottombar Gramplets. The [[Gramps_5.1_Wiki_Manual_-_Main_Window#Search_bar|Search Bar]] only appears when the entire sidebar is closed. You can show or hide the Gramplet bars through changing the selection of the {{man menu|View ➡ ☑Sidebar}} or {{man menu|View ➡ ☑Bottombar}} menus.
{{man note|Name filtering behavior has [[Rule_expansions#Gramps_5.1.0_.28Aug._2019.29|changed for Gramps 5.1]]|In prior versions of Gramps, the name portion of the Filter Gramplet would try to match on any single name field (given, surname, prefix, etc) of all names (primary and alternate) but only field per name — you couldn't match the given field and surname field in the same name. You could match surname, but simultaneously matching surname and given in the same query wasn't possible. For example, if you Filter on "John", you would get matches of people with firstname "John" but also those with surname "Johnson". More complex search required use of the regular expressions pattern matching options or custom filters.<br /><br />This constraint has been removed and simultaneous search of multiple terms is now the default behavior.}}
Search and Filter work completely differently and it is useful to understand these differences:
*''Search'' - the [[Gramps_5.1_Wiki_Manual_Gramps_{{Version manual}}_Wiki_Manual_-_Main_Window#Search_bar|Search Bar]] looks through the database as it appears in the rows and columns on the screen. The Search functionality is probably the one you want to use most of the time, as it is fast and most straightforward. But speed and simplicity imposes some limitations (see below).
:For example, if you have the Name Display in Preferences set to show "Surname, Given" then you can match names such as "Smith, J" and all of the correct rows will match. If you change the way that names are displayed (in Preferences) then you can match that format (for example, "John Smith").
Some additional points:
* The Filter will search alternative & multiple names too; the [[Gramps_5.1_Wiki_Manual_Gramps_{{Version manual}}_Wiki_Manual_-_Main_Window#Search_bar|Search Bar]] only looks in the primary name... the one showing in the People view. That is why doing a Filter on "Smith" might list people that superficially don't appear to match. But if you drill down into that person's details with the [[Gramps_5.1_Wiki_Manual_Gramps_{{Version manual}}_Wiki_Manual_-_Entering_and_editing_data:_detailed_-_part_3#Name_Editor|Name Editor]], you might see that they have an alternate name containing "smith".* The Filter allows "regular expressions". So you can find all of the names that start with "B" and end in "ship": "B.*ship". You can't do that with the [[Gramps_5.1_Wiki_Manual_Gramps_{{Version manual}}_Wiki_Manual_-_Main_Window#Search_bar|Search Bar]].* The Search will only match what is visible. If a name or text is too big to see in listing below [[Gramps_5.1_Wiki_Manual_Gramps_{{Version manual}}_Wiki_Manual_-_Main_Window#Search_bar|Search Bar]], then you won't find it. This is something to keep in mind when Searching through Notes. Best to use Filter for notes and other long text fields.
* All Filters default to use case-insensitive matching; "Ship" will match "ship", "SHIP", or "ShIp".
* [[Gramps_Glossary#filter|Filter]] - a definition
* [[Gramps_{{Version manual}}_Wiki_Manual_-_Filters|Filters introduction]] in the Gramps Manual
* [[Gramps_5.1_Wiki_Manual_Gramps_{{Version manual}}_Wiki_Manual_-_Filters#Which_filters_in_which_Category.3F|Which filters in which Category?]]
* [[Filter|Filter]]
* [[Example filters]] - Multi-stage filters
Once you are satisfied with your rule selection and its values, click {{man button|OK}} to add this rule to the rule list of the currently edited filter. Clicking {{man button|Cancel}} will abort adding the rule to the filter.
See also [[Gramps_5.1_Wiki_Manual_Gramps_{{Version manual}}_Wiki_Manual_-_Filters#Which_filters_in_which_Category.3F|Which filters in which Category?]]
{{-}}
== Which filter rules in which Category? ==
Depending on the used [[Gramps_5.1_Wiki_Manual_Gramps_{{Version manual}}_Wiki_Manual_-_Categories|Category]], you will get a different set of [[Gramps_5.1_Wiki_Manual_Gramps_{{Version manual}}_Wiki_Manual_-_Gramplets#Filter|filter]] rules. Also see [[Gramps_5.1_Wiki_Manual_-_Gramplets#Summary_of_Gramplets|Summary of Gramplets]].
*; Dashboard Category: no filter rules available
===Families with twins===
Matches families with two (or more) children having a [[Gramps_5.1_Wiki_Manual_Gramps_{{Version manual}}_Wiki_Manual_-_Entering_and_editing_data:_detailed_-_part_1#Child_Reference_Editor|'Birth' role for the Relationship to the Mother]] and the same birthdate.
== Citation/source filters ==
{{stub}}<!-- link to page on how Gramps calculates this-->
* [[Gramps_5.1_Wiki_Manual_Gramps_{{Version manual}}_Wiki_Manual_-_Probably_Alive#Probably_Alive_Filter|Probably Alive Filter]]
====People with <count> LDS events====
====People with the family <attribute>====
Matches people with the family attribute of a particular value. Use RegEx pattern matching to search for [[Gramps_5.1_Wiki_Manual_Gramps_{{Version manual}}_Wiki_Manual_-_Filters#regex_all|all values]] or attributes that have been [[Gramps_5.1_Wiki_Manual_Gramps_{{Version manual}}_Wiki_Manual_-_Filters#regex_null|left blank]]. Values: Family Attribute: Identification Number -- Age ...
====People with the personal <attribute>====
Matches people with the personal attribute of a particular value. Use RegEx pattern matching to search for [[Gramps_5.1_Wiki_Manual_Gramps_{{Version manual}}_Wiki_Manual_-_Filters#regex_all|all values]] or attributes that have been [[Gramps_5.1_Wiki_Manual_Gramps_{{Version manual}}_Wiki_Manual_-_Filters#regex_null|left blank]]. Values: Family Attribute: Identification Number -- Age ...
====People with unknown gender====
[[File:Toolbar-TagSelectedRows-Icon-DropDownMenu-overview-example-50.png|thumb|right|300px|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} Available Tag actions from "Tag selected rows" Toolbar icon - drop down menu overview - example]]
{{-}}
See also [[Gramps_5.1_Wiki_Manual_Gramps_{{Version manual}}_Wiki_Manual_-_Reports_-_part_6#Tag_Report|Tag Report]]
{{-}}
===New Tag dialog===
<!-- merge with above? -->
Due to the '''static''' nature of tags, it might be useful to add a tag to a selection of objects. For example one should be able to select a number of person in the [[Gramps_5.1_Wiki_Manual_Gramps_{{Version manual}}_Wiki_Manual_-_Main_Window#People_Category|Person View]], and add them a new tag or an existing one.
{{-}}
[[File:EditPersonEditor-TagSelectionWindow-50.png|thumb|right|400px|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} Tag selection in the Person Editor]]
When you use [[File:16x16-gramps-tag.png]]{{man button|Edit the tag list}} button from any of the Editor dialogs like {{man label|Person Edit}} the {{man label|[[Gramps_5.1_Wiki_Manual_Gramps_{{Version manual}}_Wiki_Manual_-_Filters#Tag_selection_dialog|Tag selection]]}} dialog list is shown that lets you remove or assign existing custom tags. The tags are shown in alphabetical order.
{{-}}
===See also===
* [[Tags in Gramps]] - an introduction
* Automatic [[Gramps_5.1_Wiki_Manual_Gramps_{{Version manual}}_Wiki_Manual_-_Settings#General_Gramps_settings|Import timestamp Tags]]
* filtered [[Addon:RemoveTagTool|Add/Remove Tag Tool]] (Third party add-on for Gramps)