16,602
edits
Changes
m
{{man tip*; Events View, Sources View, Media view, Repositories View, and Notes View: only [[#General_filters| Tip |A filter you have already designed may be used as General filters]]. Those General filters are specific for a rule for another filter. This gives you nearly infinite flexibility View: in custom-tailoring your selection criteria that can be later used in most of the exports, reports, Media View the filters will only sort and some of the tools (such as comparing individual events)search on Media Objects.}}
This category includes the following general rules*;People without a known birth date:Matches people without a known birthdate.
*;Has text matching substring of: This rule matches all people whose records contain specified substring. All textual records are searched. Optionally, the search can be made case sensitive, or a regular expression match.== Person filters ==
*;Is a male: This rule matches any male person.
*;Has source of: This rule matches people whose records refer to the specified source.
This rule matches people who are ancestors of someone who is matched by the specified filter. The specified filter name should be selected from the menu.
Protected "Gramps 3.1 Wiki Manual - Filters" ([edit=autoconfirmed] (indefinite) [move=autoconfirmed] (indefinite))
==Custom Filter Editor==
[[Image:cfeCfe-df.png|right|thumb|150px250px|Fig.311.x 1 Define filter]]
The Custom Filter Editor builds custom filters that can be used to select people included in reports, exports, and other tools and utilities. This is in fact a very powerful tool in genealogical analysis.
Check {{man label|Return values that do not match the filter rules}} to invert the filter rule. For example, inverting "has a common ancestor with I1" rule will match everyone who does not have a common ancestor with that person).
<br clear="all" />
Clicking the {{man button|Add...}} button invokes the following {{man label|Add Rule}} dialog:
[[Image:cfeCfe-ar.png|right|thumb|150px250px|Fig.311.x 2 Add rule]]
The pane on the left-hand side displays available filter rules arranged by their categories in an expandable tree. For detailed filter rule reference, see ''append-filtref'' . Click on the arrows to fold/unfold the appropriate category. Select the rule from the tree by clicking on its name. The right-hand side displays the name, the description, and the values for the currently selected rule. 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.<br clear="all" />{{man tip| Tip |A filter you have already designed may be used as a rule for another filter. This gives you nearly infinite flexibility in custom-tailoring your selection criteria that can be later used in most of the exports, reports, and some of the tools (such as comparing individual events).}} == Which filters in which view? == Depending on the used View, you will get a different set of filters. *; Gramplets: no filters available *; Persons View, Relationships View, and Pedigree View: [[#Ancestral_filters|Ancestral filters]], [[#Descendant_filters|Descendant filters]], [[#Family_filters|Family filters]], [[#General_filters|General filters]], [[#Event_filters|Event filters]], and [[#Relationship filters|Relationship Filters]].
*; Places View: [[#General_filters|General filters]], and [[#Position filters|Position filters]].
== General filters ==
=== Persons-, Relationship-, and Pedigree View===
This category includes the following general rules:
*;Bookmarked People: Matches the people on the bookmark list.
*;Default person: Matches the default person.
*;Disconnected People: Matches people that have no family relationships to any other person in the database.
*;Everyone: Matches everyone in the database.
*;Females: Matches all females.
*;Males: Matches all males.
*;People having <count> notes: Matches people having a certain number of notes: Values: Number of instances -- Number must be greater than/lesser/equal to
*;People having notes containing <regular expression>: Matches people whose notes contain text matching a regular expression. Values: Regular expression
*;People having notes containing <substring>: Matches people whose notes contain text matching a substring. Values: Substring
*;People marked private: Matches people that are indicated as private.
*;People matching the <filter>: Matches people matched by the specied filter name. Values: Filter name. The specified filter name should be selected from the menu.
*;People probably alive: Matches people without indications of death that are not too old. Values: On Date
*;People with <id> matching regular expression: Matches people whose GRAMPS ID matches the regular expression. Values: Regular expression
*;People with <count> LDS events: Matches people with a certain number of LDS events. Values: Number of instances -- Number must be greater than/lesser/equal to
*;People with <count> addresses: Matches people with a certain number of personal addresses. Values: Number of instances -- Number must be greater than/lesser/equal to
*;People with <count> associations: Matches people with a certain number of associations. Values: Number of instances -- Number must be greater than/lesser/equal to
*;People with <count> media: Matches people with a certain number of items in the gallery. Values: Number of instances -- Number must be greater than/lesser/equal to
*;People with <count> source: Matches people with a certain number of items in the source. Values: Number of instances -- Number must be greater than/lesser/equal to
*;People with <marker>: Matches people with a marker of a particular value. Values: Marker type ' ', Complete, or ToDo.
*;People with complete records: Matches all the people whose records are complete.
*;People with incomplete names: Matches people with firstname or lastname missing.
*;People with records containing <substring>: Matches people whose records contain text matching a substring. Values: Substring -- Case Sensitive or not -- Regular-Expression matching or not
*;People with the <name>: Matches people with a specied (partial) name. Values: Given Name -- Family Name -- Suffix -- Title -- Prefix -- Patronymic -- Call Name
*;People with the source: Matches people who have a particular source. values: Source ID
*;People with the family <attribute>: Matches people with the family attribute of a particular value. Values: Family Attribute: Identification Number -- Age ...
*;People with the personal <attribute>: Matches people with the personal attribute of a particular value. Values: Family Attribute: Identification Number -- Age ...
*;People with unknown gender: Matches all people with unknown gender.
*;Has complete recordPeople with <id>: This rule matches all Matches people whose records are marked as completewith GRAMPS ID. Currently, The rule returns a match only if the completeness of personal information ID is marked manuallymatched exactly. You can either enter the ID into a text entry field, in or select an object from the list by clicking {{man labelbutton|Edit PersonSelect...}} dialogbutton. In the latter case, the ID will appear in the text field after the selection was made.
*;People with incomplete nameschanged after <date time>: This rule matches all people with either Matches person records changed after a specified date-time (yyy-mm-dd hh:mm:ss) or in the range, if a second date-time is given name or family name missing: Values: Changed after: -- but before:.
*;Is bookmarked personPeople with events matching the <event filter>: This rule matches all people Matches persons who are on the bookmark listhave events that match a certain event filter. Values: Event filter name.
*;EveryoneHas Address: This rule matches any person in the database. As such it is not very useful on its own except for testing purposes. However, it may be useful in combinations people with other rulesa personal address.
*;People probably aliveHas Association: This rule matches all people whose records do not indicate their death and who are not unreasonably old, judging by their available birth data and today's datewith a personal association.
*;Has a nameComplete Record: This rule matches any person all people whose name matches the specified value in full or in partrecords are marked as complete. For exampleCurrently, ''Marta Ericsdotter'' will be matched by the rule using the value "eric" for the family name. Separate values can be used for Given namecompleteness of personal information is marked manually, Family name, Suffix, and the Title. The rule returns a match if, and only if, all non-empty values are (partially) matched by a person's name. To use just one value, leave in the other values empty{{man label|Edit Person}} dialog.
*;Has the IdName: This rule matches any person with a whose name matches the specified GRAMPS IDvalue in full or in part. For example, ''Marta Ericsdotter'' will be matched by the rule using the value "eric" for the family name. Separate values can be used for Given name, Family name, Suffix, and the Title. The rule returns a match if, and only if the ID is , all non-empty values are (partially) matched exactly. You can either enter the ID into a text entry field, or select by a person from the list by clicking {{man button|Select...}} button's name. In the latter caseTo use just one value, leave the ID will appear in the text field after the selection was madeother values empty.
*;Is default person: This rule matches the default (home) person.
*;People marked privateIs a female: This rule matches people whose records are marked as privateany female person. *;Is a male: This rule matches any male person.
*;Is a femalePeople probably alive: This rule matches any female personall people whose records do not indicate their death and who are not unreasonably old, judging by their available birth data and today's date.
*;People who have imageswith incomplete names: This rule matches all people with images in their gallerieseither given name or family name missing.
*;People without a birth date: This rule matches people missing birth date.
== Event filters ==
*;Has the death: This rule matches people whose death event matches specified values for Date, Place, and Description. The rule returns a match even if the person's death event matches the value partially. The matching rules are case-insensitive. For example, anyone who died in Sweden will be matched by the rule using the value "sw" for the Place. The rule returns a match if, and only if, all non-empty values are (partially) matched by a person's death. To use just one value, leave the other values empty.
*;Has the personal event: This rule matches people that have a personal event matching specified values for the Event type, Date, Place, and Description. The rule returns a match even if the person's event matches the value partially. The matching rules are case-insensitive. For example, anyone who graduated in Sweden will be matched by the rule using the Graduation event and the value "sw" for the Place. The personal events should be selected from a pull-down menu. The rule returns a match if, and only if, all non-empty values are (partially) matched by the personal event. To use just one value, leave the other values empty.
This category includes the following rules that match people based on their ancestral relations to other people:
*;Is an ancestor of : This rule matches people who are ancestors of the specified person. The Inclusive option determines whether the specified person should be considered his/her own ancestor (useful for building reports). You can either enter the ID into a text entry field, or select a person from the list by clicking {{man button|Select...}} button. In the latter case, the ID will appear in the text field after the selection was made. *Is an ancestor of person at least N generations away This rule matches people who are ancestors of the specified person and are at least N generations away from that person in their lineage. For example, using this rule with the value of 2 for the number of generations will match grandparents, great-grandparents, etc., but not the parents of the specified person. *Is an ancestor of person not more than N generations away This rule matches people who are ancestors of the specified person and are no more than N generations away from that person in their lineage. For example, using this rule with the value of 2 for the number of generations will match parents and grandparents, but not great-grandparents, etc., of the specified person.
*Has a common ;Is an ancestor of person at least N generations away: This rule matches people who are ancestors of the specified person and are at least N generations away from that person in their lineage. For example, using this rule withthe value of 2 for the number of generations will match grandparents, great-grandparents, etc., but not the parents of the specified person.
*;Is an ancestor of person not more than N generations away: This rule matches people who have common are ancestors of the specified person and are no more than N generations away from that person in their lineage. For example, using this rule with the value of 2 for the number of generations will match parents and grandparents, but not great-grandparents, etc., of the specified person.
*;Has a common ancestor with filter match: This rule matches people who have common ancestors with the specified person.
*;Has a common ancestor with filter match: This rule matches people who have common ancestors with someone who is matched by the specified filter. The specified filter name should be selected from the menu.
*;Is an ancestor of filter match: This rule matches people who are ancestors of someone who is matched by the specified filter. The specified filter name should be selected from the menu.
== Descendant filters ==
This category includes the following rules that match people based on their descendant relations to other people:
*;Is a descendant of : This rule matches people who are descendants of the specified person. The Inclusive option determines whether the specified person should be considered his/her own descendant (useful for building reports). You can either enter the ID into a text entry field, or select a person from the list by clicking {{man button| Select...}} button. In the latter case, the ID will appear in the text field after the selection was made. *Is a descendant of person at least N generations away This rule matches people who are descendants of the specified person and are at least N generations away from that person in their lineage. For example, using this rule with the value of 2 for the number of generations will match grandchildren, great-grandchildren, etc., but not the children of the specified person. *Is a descendant of person not more than N generations away This rule matches people who are descendants of the specified person and are no more than N generations away from that person in their lineage. For example, using this rule with the value of 2 for the number of generations will match children and grandchildren, but not great-grandchildren, etc., of the specified person.
*;Is a descendant of filter person at least N generations away: This rule matches people who are descendants of the specified person and are at least N generations away from that person in their lineage. For example, using this rule with the value of 2 for the number of generations will matchgrandchildren, great-grandchildren, etc., but not the children of the specified person.
*;Is a descendant of person not more than N generations away: This rule matches people who are descendants of someone who is matched by the specified filterperson and are no more than N generations away from that person in their lineage. For example, using this rule with the value of 2 for the number of generations will match children and grandchildren, but not great-grandchildren, etc. The , of the specified filter name should be selected from the menuperson.
*;Is a descendant family member offilter match: This rule matches people who are descendants of someone who is matched by the specified filter. The specified filter name should be selected from the menu.
*;Is a descendant family member of: This rule not only matches people who are descendants of the specified person, but also those descendants' spouses.
== Relationship filters ==
This category includes the following rules that match people based on their mutual relationship:
*;Relationship path between two people : This rule matches all ancestors of both people back to their common ancestors (if exist). This produces the "relationship path" between these two people, through their common ancestors. You can either enter the ID of each person into the appropriate text entry fields, or select people from the list by clicking their {{man button|Select...}} buttons. In the latter case, the ID will appear in the text field after the selection was made.
== Miscellaneous filters ==
This category includes the following rules which do not naturally fit into any of the above categories:
*;Has the personal attribute : This rule matches people who have the personal attribute of the specified value. The specified personal attribute name should be selected from the menu. The specified value should be typed into the text entry field. *Has the family attribute This rule matches people who have the family attribute of the specified value. The specified family attribute should be selected from the menu. The specified value should be typed into the text entry field.
*Matches ;Has the filter namedfamily attribute: This rule matches people who have the family attribute of the specified value. The specified family attribute should be selected from the menu. The specified value should be typed into the text entry field.
*;Has LDS: This rule matches people who are matched by the specified filter. The specified filter name should be selected from the menuor families with a LDS event.
{{man index|Gramps 3.1 Wiki Manual - Settings|Gramps 3.1 Wiki Manual - FAQ|3.1}}
[[Category:Documentation]][[Category:Filters]]
{{languages|Gramps_3.1_Wiki_Manual_-_Filters}}