Changes

Jump to: navigation, search

Gramps 3.1 Wiki Manual - Filters

3,366 bytes added, 08:25, 31 December 2010
m
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]].
{{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.}}
*; 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.
This category includes *;People with complete records: Matches all the following general rules:people whose records are complete.
*;ChangedSincePeople with incomplete names: This rule matches primary objects changed since a specific timeMatches people with firstname or lastname missing.
*;EverythingPeople with records containing <substring>: This rule matches any object in the databaseMatches people whose records contain text matching a substring. As such it is Values: Substring -- Case Sensitive or not -- Regular-Expression matching or not very useful on its own except for testing purposes. However, it may be useful in combinations with other rules.
*;Has GalleryPeople with the <name>: This rule matches primary objects who have Media ObjectMatches people with a specied (partial) name.Values: Given Name -- Family Name -- Suffix -- Title -- Prefix -- Patronymic -- Call Name
*;Has Id: This rule matches any person People with a specified GRAMPS ID. The rule returns a match only if the ID is matched exactly. You can either enter the ID into source: Matches people who have a text entry field, or select a person from the list by clicking {{man button|Selectparticular source...}} button. In the latter case, the values: Source ID will appear in the text field after the selection was made.
*;Has MarkerPeople with the family <attribute>: This rule matches Matches people, families and notes with the family attribute of a particular markervalue. Values: Family Attribute: Identification Number -- Age ...
*;Has NotePeople with the personal <attribute>: This rule matches primary objects having notesMatches people with the personal attribute of a particular value. Values: Family Attribute: Identification Number -- Age ...
*;Has Reference CountPeople with unknown gender: This rule matches primary objects Matches all people with a reference <count>unknown gender.
*;Has SourcePeople without a known birth date: This rule matches primary objects having sourcesMatches people without a known birthdate.
*;Has text matching substring ofPeople with <id>: This rule matches all Matches people whose records contain specified substringwith GRAMPS ID. All textual records are searchedThe rule returns a match only if the ID is matched exactly. OptionallyYou can either enter the ID into a text entry field, or select an object from the list by clicking {{man button|Select...}} button. In the search can be made latter case sensitive, or a regular expression matchthe ID will appear in the text field after the selection was made.
*;Is bookmarkedPeople changed after <date time>: This rule matches all primary objects who are on Matches person records changed after a specified date-time (yyy-mm-dd hh:mm:ss) or in the bookmark listrange, if a second date-time is given: Values: Changed after: -- but before:.
*;Is PrivatePeople with events matching the <event filter>: This rule matches primary objects whose records are marked as privateMatches persons who have events that match a certain event filter. Values: Event filter name.
== Person filters ==
*;Has complete recordAddress: This rule matches people with a personal address. *;Has Association: This rule matches people with a personal association. *;Has Complete Record: This rule matches all people whose records are marked as complete. Currently, the completeness of personal information is marked manually, in the {{man label|Edit Person}} dialog.
*;Has a nameName: This rule matches any person whose name matches the specified value 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, all non-empty values are (partially) matched by a person's name. To use just one value, leave the other values empty.
*;Is default person: This rule matches the default (home) person.
*;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 source of: This rule matches people whose records refer to the specified source.
*;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.
*;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.
*;HasLDSHas LDS: This rule matches people or families with a LDS event. *;Matches the filter named: This rule matches people who are matched by the specified filter. The specified filter name should be selected from the menu.
{{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}}

Navigation menu