Gramps 5.0 Wiki Manual - Filters

From Gramps
Jump to: navigation, search
Previous Index Next


Fig. 14.1 Define filter - dialog

Lists of all the filter rules currently defined in Gramps. Each of these rules is available for use when creating custom filters. (See Define filter - dialog image.) . The rules are listed by their categories.

Filter vs. Search

There are two ways to find data in Gramps: Search and Filter. Search uses the topbar 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 top bar Search only appears when the entire sidebar is closed. You can close/open the Sidebar/bottombar through -> View.

Search and Filter work completely differently and it is useful to understand these differences:

  • Search - the topbar search looks through the database as it appears in the rows and columns on the screen. 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"). The Search functionality is probably the one you want to use most of the time, as it is most straightforward, but has some limitations (see below).
Fig. 14.2 Gramps Main Window showing Search Bar
  • Filter - Filters use a more complex system. It is not limited to what you see on the screen, but looks at the actual data, rather than just what is showing in the View. The name Filter will try to match on any single name field (given, surname, prefix, etc) of all names (primary and alternate) but only field per name---you can't match the given field and surname field in the same name. You can match surname, but not surname and given in the same name. For example, if you Filter on "John", you will get matches of people with firstname "John" but also those with surname "Johnson". You just can't filter on combinations of first and lastnames.
Fig. 14.3 Gramps Filter SideBar

Filters can be created and controlled from the menu Edit -> Filter Editor, or from a special sidebar/bottombar Gramplet. The Filter Gramplets allow for some quick filters that are similar to the topbar Search, but all Filters follow the distinction outlined here.

Some additional points:

  • The Filter will search alternative names too; Search only looks in the primary name (the one showing). That is why if you do a Filter on "Smith" you might see people listed that don't appear to match. But if you edit that person's details, 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 top bar Search.
  • The Search will only match what is visible. If a name or text is too big to see in listing below topbar, 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 use case-insensitive matching; "Ship" will match "ship", "SHIP", or "ShIp".

You can find more details about making filters in Example filters.

Regular Expressions

Regular Expressions(aka regex) are a quick and powerful way to describe text that matches a pattern and we use these in Filters. You must have the:

  • Use regular expressions option check box checked.

For example, if you were looking for a surname that started with a "B", and ended with "ship" then you could use regular expressions to describe that pattern. That would be ^B.*ship:

  • The ^B indicates text that starts with B
  • The . indicates any single character (letter, number, or anything)
  • The * indicates zero or more of the previous (in this case, any single character)
  • The ship matches the exact letters s, h, i, p in that order.

Regular expressions are quite powerful, and there are many options. We use the Python Regular Expression system, and we will document that here. In addition, you can use any Python Regular Expression resource.

whitespace - The term "whitespace" is used below to mean one or more character that you don't see. For example, whitespace includes tabs, spaces, and newlines.

There are some characters that have special meaning with regular expressions. They are:

  • . ^ $ * + ? { } [ ] \ | ( )

They can be used as described:

  • '.' matches any character (letter, number, or other)
  • '^' matches beginning of text
  • '$' matches end of text
  • '*' matches zero or more of the previous item
  • '+' matches one or more of the previous item
  • '?' matches zero or one of the previous item (makes it optional)
  • '{' - defines a number of matches
  • '}' - ends number of matches
  • '[' - beginning of set
  • ']' - end of set
  • '\' - next character is special sequence
  • '|' - or
  • '(' - beginning of a group
  • ')' - ending of a group

Some of the special sequences beginning with '\' represent predefined sets of characters that are often useful, such as the set of digits, the set of letters, or the set of anything that isn't whitespace. The following predefined special sequences are a subset of those available.

  • \d Matches any decimal digit; this is equivalent to the class [0-9].
  • \D Matches any non-digit character; this is equivalent to the class [^0-9].
  • \s Matches any whitespace character; this is equivalent to the class [ \t\n\r\f\v].
  • \S Matches any non-whitespace character; this is equivalent to the class [^ \t\n\r\f\v].
  • \w Matches any alphanumeric character; this is equivalent to the class [a-zA-Z0-9_].
  • \W Matches any non-alphanumeric character; this is equivalent to the class [^a-zA-Z0-9_].

The most complicated repeated qualifier is {m,n}, where m and n are decimal integers. This qualifier means there must be at least m repetitions, and at most n.

Groups and Sets

Groups are marked by the '(', ')' metacharacters. '(' and ')' have much the same meaning as they do in mathematical expressions; they group together the expressions contained inside them, and you can repeat the contents of a group with a repeating qualifier, such as *, +, ?, or {m,n}. For example, (ab)* will match zero or more repetitions of ab.

Sets are marked by the '[' and ']' metacharacters.

You can think of groups as a list of alternatives separated by the '|' metacharacter, where each alternative consists of one, several or zero characters and sets as a list of alternatives where each alternative is a single character.

Examples

  • ^B.*ship$ - matches all text that starts with a 'B', followed by anything, ending with 'ship'.
    • matches: Blankenship, Blueship, Beeship
    • does not match: Blankenships
  • ^B.*ship - matches all text that starts with a 'B', followed by anything, followed by 'ship' (could be followed by more).
    • matches: Blankenship, Blankenships, Blueship, Blueshipman, Beeship, Beeshipness
    • does not match: Blankenschips

Common variations of a surname

Example 1
Using the expression Eri(ch|ck|k|c)(ss|s)on the following are matched:
Erikson
Eriksson
Ericson
Ericsson
Erickson
Ericksson
Erichson
Erichsson

Explanation: Because of the following

  • Eri = Eri
  • (ch|ck|k|c) = group matching ch, ck, k or c. It tries to make the longest match first
  • (ss|s) = group matching ss or s. It tries to make the longest match first
  • on = on

Example 2
Using the expression Ba(in|yn|m|n)bri(dge|cke|g(g|e|)) the following are matched:
Bainbricke
Bainbridge
Bainbrig
Bainbrigg
Bambridge
Banbrig
Banbrige
Baynbrige

Explanation: Because of the following

  • Ba = Ba
  • (in|yn|m|n) = group matching in, yn, m or n. It tries to make the longest match first.
  • bri = bri
  • (dge|cke|g(g|e|)) = group matching dge, cke or (g with g, g with e or g with nothing)

Example 3
Using the expression n(es|oua|oai|o[iya]|a[iy])r(r|)(on|((e|)au(x|t|d|lt|))) the following are matched:
nairaud
nairault
naireaud
nayrault
nesrau                
nesrault
nesreau
nesreaud
noirau
noiraud
noirauld
noirault
noiraut
noiraux
noireau
noireaud
noireault
noireaut
noirraux
noirreau
noirreaud
nouarault
noyraud
noyrault 

Explanation: Because of the following

  • n = n
  • (es|oua|oai|set1|set2) = group matching es, oua, oai, set1 or set2
  • set1 is o[iya] = set matching o AND i, y or a. In other words oi, oy or oa
  • set2 is a[iy] = set matching a AND i or y. In other words ai or ay
  • r = r
  • (r|) = group matching r or nothing
  • (on|(subgroup1) = group matching on or subgroup1.
  • subgroup1 is group matching (subgroup2 au subgroup3)
  • subgroup2 is (e|) = group matching e or nothing
  • au = au
  • subgroup3 is (x|t|d|lt) = group matching x, t, d or lt

Testing regular expressions

Regular Expression testers can be found online through Google. http://www.regexr.com/ is simple and convenient

Custom Filters

Gnome-important.png
Custom rules migration

To avoid unwanted effects after a major upgrades of Gramps (eg, from version 3.2.x to 5.0.x), if required, you can manually copy your custom_filter.xml from Gramps User Directory to gramps_version_number.

You can carry out a considerable amount of selection of persons, events, places, etc., just using the Filter Sidebar in Person, Event, Place,etc. Views; but note, however, that the 'Use regular expressions' option only works with particular fields in each View.

If the Filter Sidebar is inadequate for your purpose, you will need to build custom filters.

CategoryName Filters dialog

Gramps-notes.png
Note:Changes on filters

The changes made to the filters only take effect after you use the Close button from this window.

Fig. 14.4 Person Filters - dialog list

To show previously created custom filters use the CategoryName Filters dialog list where the CategoryName changes based on the category you are in eg:

  • Person Filters
  • Family Filters
  • Event Filters
  • Place Filters
  • Source Filters
  • Media Filters
  • Repository Filters
  • Note Filters
  • Citation Filters

When in the CategoryName Filters dialog you have the following options from the right hand side icons:

  • + (Add another rule to filter) button to show the Define filter dialog add your new custom filter.
  • Edit the selected filter button to show the Define filter dialog and edit your existing custom filter.
  • Clone the selected filter makes an exact copy of the selected filter.
  • Test the selected filter when selected brings up the Filter Test dialog results list, that may or may not show results from your custom filter.
  • Delete the selected filter


Filter Test dialog

Fig. 14.5 Filter Test dialog results list - example

The Filter Test dialog results list, may or may not show results from your custom filter.

Define Filter dialog

Fig. 14.6 Define filter - dialog - example

The Define filter dialog allow you to build 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.

To list all the filters (if any) previously defined by you, access the Define filter dialog from:

  • The Sidebar/Bottombar Filters
  • In most categories via the menu Edit > CategoryName Filter Editor which will bring up the CategoryName Filters dialog where you can select the + (Add another rule to filter) button or Edit the selected filter button.

In the Definition section type the Name: for your new filter and add a Comment: that would help you identify this filter in the future. Add as many rules to the Rule list as you would like to your filter using + button.

If the filter has more than one rule, select one of the Options from the drop down list which allows you to choose whether

  • All rules must apply(default)
  • At least one rule must apply
  • Exactly one rule must apply

in order for the filter to generate a match. If your filter has only one rule, this selection has no effect.

  • Select
    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). (Check box unchecked by default)


Add Rule dialog

Gnome-important.png
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).
See: Example filters


Fig. 14.7 Add Rule - selector dialog - available for Person filters

To define a new filter click the + (Add another rule to filter) button from the Define filter dialog as this invokes the Add Rule dialog

The pane on the left-hand side displays available filter rules arranged by their categories in an expandable tree.

For detailed filter rule reference.

  • 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 OK to add this rule to the rule list of the currently edited filter. Clicking Cancel will abort adding the rule to the filter.

See also Which filters in which Category?

Which filters in which Category?

Depending on the used Category, you will get a different set of filters. Also see Summary of Gramplets.

  • Dashboard Category
    no filters available

Ancestral filters

This category includes the following rules that match people based on their ancestral relations to other people:

  • 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.
  • Ancestor of <person>
    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 Select... button. In the latter case, the ID will appear in the text field after the selection was made.
  • 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.
  • 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.
  • Duplicate ancestors of <person>
    Matches people that are ancestors twice or more of a specified person
  • People with 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.
  • People with a common ancestor with <person>
    This rule matches people who have common ancestors with the specified person.

Child filters

  • Families having child with id containing <text>
    Matches families where child has a specified Gramps ID
  • Families with child with the <name>
    Matches families where child has a specified (partial) name
  • Families with twins
    Matches families with twins

Citation/source filters

These filters are view dependent

Persons-, and Relationship Category

This category includes the following citation and source rules:

  • 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 the <citation>
    Matches people with a citation of a particular value
  • People with the <source>
    Matches people who have a particular source. values: Source ID
  • Person with at least one direct source >= <confidence level>

Families Category

This category includes the following citation and source rules:

  • Families with <count> source
    Matches families with a certain number of items in the source. Values: Number of instances -- Number must be greater than/lesser/equal to
  • Families with at least one direct source >= <confidence level>
    Matches families with at least one direct source with confidence level(s)
  • Families with the <citation>
    Matches families with a citation of a particular value
  • Families with the <source>
    Matches families who have a particular source. values: Source ID

Events Category

This category includes the following citation and source rules:

  • Events with <count> source
    Matches events with a certain number of items in the source. Values: Number of instances -- Number must be greater than/lesser/equal to
  • Events with at least one direct source >= <confidence level>
    Matches events with at least one direct source with confidence level(s)
  • Events with source matching the <source filter>
  • Events with the <citation>
    Matches events with a citation of a particular value

Places Category

This category includes the following citation and source rules:

  • Places with <count> source
    Matches places with a certain number of items in the source. Values: Number of instances -- Number must be greater than/lesser/equal to
  • Places with a direct source >= <confidence level>
    Matches places with at least one direct source with confidence level(s)
  • Places with the <citation>
    Matches places with a citation of a particular value
  • Places with the <source>
    Matches places who have a particular source. values: Source ID

Media Category

This category includes the following citation and source rules:

  • Media with <count> source
    Matches media with a certain number of items in the source. Values: Number of instances -- Number must be greater than/lesser/equal to
  • Media with a direct source >= <confidence level>
    Matches media with at least one direct source with confidence level(s)
  • Media with the <citation>
    Matches media with a citation of a particular value
  • Media with the <source>
    Matches media who have a particular source. values: Source ID

Descendant filters

This category includes the following rules that match people based on their descendant relations to other people:

  • Descendant family member of <filter> match
    Matches people that are descendants or the spouse of anybody matched by a filter
  • Descendant family member of <person>
    This rule not only matches people who are descendants of the specified person, but also those descendants' spouses.
  • Descendant of <filter> 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.
  • Descendant of <person>
    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 Select... button. In the latter case, the ID will appear in the text field after the selection was made.
  • 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.
  • 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.

Event filters

These filters are view dependent

Persons-, and Relationship Category

This category includes the following rules that match people based on their recorded events:

  • Families with incomplete events
    This rule matches people missing date or place in any family event of any of their families.
  • People with incomplete events
    This rule matches people missing date or place in any personal event.
  • People with the <birth data>
    This rule matches people whose birth event matches specified values for Date, Place, and Description. The rule returns a match even if the person's birth event matches the value partially. The matching rules are case-insensitive. For example, anyone born 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 birth. To use just one value, leave the other values empty.
  • People with the <death data>
    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.
  • People with the family <event>
    This rule matches people that have a family 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 was married in Sweden will be matched by the rule using the Marriage event and the value "sw" for the Place. The family 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.
  • People with 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.
  • Witness
    This rule matches people who are present as a witness in the event. If the personal or family event type is specified, only the events of this type will be searched.

Families Category

This category includes the following rules that match families based on their recorded events:

  • Families with the <event>
    This rule matches famikies that have a 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 was married in Sweden will be matched by the rule using the Marriage event and the value "sw" for the Place. The family 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.

Family filters

This category includes the following rules that match people based on their family relationships:

  • Adopted people
    This rule matches adopted people.
  • Child of <filter> match
    This rule matches people for whom either parent is matched by the specified filter. The specified filter name should be selected from the menu.
  • Parents of <filter> match
    This rule matches people whose child is matched by the specified filter. The specified filter name should be selected from the menu.
  • People missing parents
    Matches people that are children in a family with less than two parents or are not children in any family.
  • People with children
    This rule matches people with children.
  • People with multiple marriage records
    This rule matches people with more than one spouse.
  • People with no marriage records
    This rule matches people with no spouses.
  • People with the <relationships>
    This rule matches people with a particular relationship. The relationship must match the type selected from the menu. Optionally, the number of relationships and the number of children can be specified. The rule returns a match if, and only if, all non-empty values are (partially) matched by a person's relationship. To use just one value, leave the other values empty.
  • Siblings of <filter> match
    This rule matches people whose sibling is matched by the specified filter. The specified filter name should be selected from the menu.
  • Spouses of <filter> match
    This rule matches people married to someone who is matched by the specified filter. The specified filter name should be selected from the menu.

Father filters

  • Families having father with id containing <text>
    Matches families whose father has a specified Gramps ID
  • Families with father with the <name>
    Matches families whose father has a specified (partial) name

General filters

These filters are view dependent

Persons-, and Relationship Category

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 <text>
    Matches people whose notes contain text matching a regular expression
  • People marked private
    Matches people that are indicated as private.
  • People matching the <filter>
    Matches people matched by the specified filter name. Values: Filter name. The specified filter name should be selected from the menu.
  • People not marked private
    Matches people that are not indicated as private
  • People probably alive
    Matches people without indications of death that are not too old. Values: On Date
  • 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 id containing <text>
    Matches people whose Gramps ID matches the regular expression
  • People with a nickname
    Matches people with a nickname
  • People with an alternate name
    Matches people with an alternate name
  • People with incomplete names
    Matches people with first-name or last-name 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 type>
    Matches people with a type of name
  • People with the <Surname origin type>
    Matches people with a surname origin
  • People with the <name>
    Matches people with a specified (partial) name. Values: Given Name -- Family Name -- Suffix -- Title -- Prefix -- Patronymic -- Call Name
  • People with <tag>
    Matches people with a tag of a particular value. Values: Tag name.
  • 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.
  • People without a known birth date
    Matches people without a known birth date.
  • People without a known death date
    Matches people without a known death date.
  • People with <id>
    Matches people with Gramps ID. The rule returns a match only if the ID is matched exactly. You can either enter the ID into a text entry field, or select an object from the list by clicking Select... button. In the latter case, the ID will appear in the text field after the selection was made.
  • People changed after <date time>
    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: Values: Changed after: -- but before:.
  • Persons with events matching the <event filter>
    Matches persons who have events that match a certain event filter. Values: Event filter name.

Families Category

This category includes the following general rules:

  • Bookmarked families
    Matches the families on the bookmark list.
  • Every family
    Matches every family in the database.
  • Families changed after <date time>
    Matches families records changed after a specified date-time (yyy-mm-dd hh:mm:ss) or in the range, if a second date-time is given: Values: Changed after: -- but before:.
  • Families having <count> notes
    Matches families having a certain number of notes: Values: Number of instances -- Number must be greater than/lesser/equal to
  • Families having notes containing <text>
    Matches families whose notes contain text matching a regular expression
  • Families marked private
    Matches families that are indicated as private.
  • Families matching the <filter>
    Matches families matched by the specified filter name. Values: Filter name. The specified filter name should be selected from the menu.
  • Families with <count> LDS events
    Matches families with a certain number of LDS events. Values: Number of instances -- Number must be greater than/lesser/equal to
  • Families with <count> media
    Matches families with a certain number of items in the gallery. Values: Number of instances -- Number must be greater than/lesser/equal to
  • Families with id containing <text>
    Matches families whose Gramps ID matches the regular expression
  • Families with a reference count of <count>
    Matches families with a certain number of references. Values: Number of references -- Number must be greater than/lesser/equal to
  • Families with the <tag>
    Matches families with a tag of a particular value. Values: Tag name.
  • Families with the family <attribute>
    Matches families with the family attribute of a particular value. Values: Family Attribute: Identification Number -- Age ...
  • Families with the relationship type
    Matches families with the relationship type of a particular value
  • Families with <id>
    Matches families with Gramps ID. The rule returns a match only if the ID is matched exactly. You can either enter the ID into a text entry field, or select an object from the list by clicking Select... button. In the latter case, the ID will appear in the text field after the selection was made.

Events Category

This category includes the following general rules:

  • Event with <id>
    Matches events with Gramps ID. The rule returns a match only if the ID is matched exactly. You can either enter the ID into a text entry field, or select an object from the list by clicking Select... button. In the latter case, the ID will appear in the text field after the selection was made.
  • Events changed after <date time>
    Matches events records changed after a specified date-time (yyy-mm-dd hh:mm:ss) or in the range, if a second date-time is given: Values: Changed after: -- but before:.
  • Events having <count> notes
    Matches events having a certain number of notes: Values: Number of instances -- Number must be greater than/lesser/equal to
  • Events having notes containing <text>
    Matches events whose notes contain text matching a regular expression
  • Events marked private
    Matches events that are indicated as private.
  • Events matching the <filter>
    Matches events matched by the specified filter name. Values: Filter name. The specified filter name should be selected from the menu.
  • Events occurring on a particular day of the week
    Matches events occurring on a particular day of the week
  • Events of persons matching the <person filter>
    Matches events of person matched by the specified person filter name
  • Events of places matching the <place filter>
    Matches events that occurred at places that match the specified place filter name
  • Events with <count> media
    Matches events with a certain number of items in the gallery. Values: Number of instances -- Number must be greater than/lesser/equal to
  • Events with <date>
    Matches events with data of a particular value
  • Events with id containing <text>
    Matches events whose Gramps ID matches the regular expression
  • Events with a reference count of <count>
    Matches events with a certain number of references. Values: Number of references -- Number must be greater than/lesser/equal to
  • Events with the <tag>
    Matches events with a tag of a particular value. Values: Tag name.
  • Events with the <attribute>
    Matches events with the attribute of a particular value. Values: Family Attribute: Identification Number -- Age ...
  • Events with the particular type
    Matches events with the particular type
  • Every event
    Matches every event in the database.

Places Category

This category includes the following general rules:

  • Every place
    Matches every place in the database.
  • Place with <id>
    Matches places with Gramps ID. The rule returns a match only if the ID is matched exactly. You can either enter the ID into a text entry field, or select an object from the list by clicking Select... button. In the latter case, the ID will appear in the text field after the selection was made.
  • Places changed after <date time>
    Matches places records changed after a specified date-time (yyy-mm-dd hh:mm:ss) or in the range, if a second date-time is given: Values: Changed after: -- but before:.
  • Places having <count> notes
    Matches places having a certain number of notes: Values: Number of instances -- Number must be greater than/lesser/equal to
  • Places having notes containing <text>
    Matches places whose notes contain text matching a regular expression
  • Places marked private
    Matches places that are indicated as private.
  • Places matching a title
    Matches places with a particular title
  • Places matching parameters
    Matches places with particular parameters
  • Places matching the <filter>
    Matches places matched by the specified filter name. Values: Filter name. The specified filter name should be selected from the menu.
  • Places of events matching the <event filter>
    Matches places where events happened that match the specified event filter name
  • Places with <count> media
    Matches places with a certain number of items in the gallery. Values: Number of instances -- Number must be greater than/lesser/equal to
  • Places with id containing <text>
    Matches places whose Gramps ID matches the regular expression
  • Places with a reference count of <count>
    Matches places with a certain number of references. Values: Number of references -- Number must be greater than/lesser/equal to
  • Places with the <tag>
    Matches places with a tag of a particular value. Values: Tag name.

Sources Category

This category includes the following general rules:

  • Every source
    Matches every source in the database.
  • Sources with <id>
    Matches sources with Gramps ID. The rule returns a match only if the ID is matched exactly. You can either enter the ID into a text entry field, or select an object from the list by clicking Select... button. In the latter case, the ID will appear in the text field after the selection was made.
  • Sources changed after <date time>
    Matches sources records changed after a specified date-time (yyy-mm-dd hh:mm:ss) or in the range, if a second date-time is given: Values: Changed after: -- but before:.
  • Sources having <count> notes
    Matches sources having a certain number of notes: Values: Number of instances -- Number must be greater than/lesser/equal to
  • Sources having notes containing <text>
    Matches sources whose notes contain text matching a regular expression
  • Sources marked private
    Matches sources that are indicated as private.
  • Sources matching the <filter>
    Matches sources matched by the specified filter name. Values: Filter name. The specified filter name should be selected from the menu.
  • Sources with <count> Repository references
    Matches sources with a certain number of repository references
  • Sources with <count> media
    Matches sources with a certain number of items in the gallery. Values: Number of instances -- Number must be greater than/lesser/equal to
  • Sources with id containing <text>
    Matches sources whose Gramps ID matches the regular expression
  • Sources with a reference count of <count>
    Matches sources with a certain number of references. Values: Number of references -- Number must be greater than/lesser/equal to
  • Sources with repository reference containing <text> in 'Call Number'
    Matches sources with a repository reference containing a substring in 'Call Number'
  • Sources with repository reference matching the <repository filter>
    Matches sources with a repository reference that match a certain repository filter
  • Sources with the <tag>
    Matches sources with a tag of a particular value. Values: Tag name.
  • Sources with title containing <text>
    Matches sources whose title contains a certain substring

Citations Category

This category includes the following general rules:

  • Citation with <id>
    Matches citations with Gramps ID. The rule returns a match only if the ID is matched exactly. You can either enter the ID into a text entry field, or select an object from the list by clicking Select... button. In the latter case, the ID will appear in the text field after the selection was made.
  • Citations changed after <date time>
    Matches citations records changed after a specified date-time (yyy-mm-dd hh:mm:ss) or in the range, if a second date-time is given: Values: Changed after: -- but before:.
  • Citations having <count> notes
    Matches citations having a certain number of notes: Values: Number of instances -- Number must be greater than/lesser/equal to
  • Citations having notes containing <text>
    Matches citations whose notes contain text matching a regular expression
  • Citations marked private
    Matches citations that are indicated as private.
  • Citations matching parameters
    Matches citations with particular parameters
  • Citations matching the <filter>
    Matches citations matched by the specified filter name. Values: Filter name. The specified filter name should be selected from the menu.
  • Citations with <count> media
    Matches citations with a certain number of items in the gallery. Values: Number of instances -- Number must be greater than/lesser/equal to
  • Citations with id containing <text>
    Matches citations whose Gramps ID matches the regular expression
  • Citations with Volume/Page containing <text>
    Matches citations whose Volume/Page contains a certain substring
  • Citations with a reference count of <count>
    Matches citations with a certain number of references. Values: Number of references -- Number must be greater than/lesser/equal to
  • Citations with a source with a repository reference matching the <repository filter>
    Matches citations with a source with a repository reference that match a certain repository filter
  • Citations with source matching the <source filter>
    Matches citations with sources that match the specified source filter name
  • Citations with the <tag>
    Matches citations with a tag of a particular value. Values: Tag name.
  • Every citation
    Matches every citation in the database.

Repositories Category

This category includes the following general rules:

  • Every repository
    Matches every repository in the database.
  • Repositories changed after <date time>
    Matches repository records changed after a specified date-time (yyy-mm-dd hh:mm:ss) or in the range, if a second date-time is given: Values: Changed after: -- but before:.
  • Repositories having notes containing <text>
    Matches repositories whose notes contain text matching a regular expression
  • Repositories marked private
    Matches repositories that are indicated as private.
  • Repositories matching the <filter>
    Matches repositories matched by the specified filter name. Values: Filter name. The specified filter name should be selected from the menu.
  • Repositories with id containing <text>
    Matches repositories whose Gramps ID matches the regular expression
  • Repositories with a reference count of <count>
    Matches repositories with a certain number of references. Values: Number of references -- Number must be greater than/lesser/equal to
  • Repositories with name containing <text>
    Matches repositories whose name contains substring
  • Repositories with the <tag>
    Matches repositories with a tag of a particular value. Values: Tag name.
  • Repository with <id>
    Matches repositories with Gramps ID. The rule returns a match only if the ID is matched exactly. You can either enter the ID into a text entry field, or select an object from the list by clicking Select... button. In the latter case, the ID will appear in the text field after the selection was made.

Media Category

This category includes the following general rules:

  • Every media object
    Matches every media object in the database.
  • Media object with <id>
    Matches media objects with Gramps ID. The rule returns a match only if the ID is matched exactly. You can either enter the ID into a text entry field, or select an object from the list by clicking Select... button. In the latter case, the ID will appear in the text field after the selection was made.
  • Media objects changed after <date time>
    Matches media object records changed after a specified date-time (yyy-mm-dd hh:mm:ss) or in the range, if a second date-time is given: Values: Changed after: -- but before:.
  • Media objects having notes containing <text>
    Matches media objects whose notes contain text matching a regular expression
  • Media objects marked private
    Matches media objects that are indicated as private.
  • Media objects matching the <filter>
    Matches media objects matched by the specified filter name. Values: Filter name. The specified filter name should be selected from the menu.
  • Media objects with id containing <text>
    Matches media objects whose Gramps ID matches the regular expression
  • Media objects with a reference count of <count>
    Matches media objects with a certain number of references. Values: Number of references -- Number must be greater than/lesser/equal to
  • Media objects with the <tag>
    Matches media objects with a tag of a particular value. Values: Tag name.
  • Media objects with the attribute <attribute>
    Matches media objects with the attribute of a particular value

Notes Category

This category includes the following general rules:

  • Every note
    Matches every note in the database.
  • Note with <id>
    Matches notes with Gramps ID. The rule returns a match only if the ID is matched exactly. You can either enter the ID into a text entry field, or select an object from the list by clicking Select... button. In the latter case, the ID will appear in the text field after the selection was made.
  • Notes changed after <date time>
    Matches notes records changed after a specified date-time (yyy-mm-dd hh:mm:ss) or in the range, if a second date-time is given: Values: Changed after: -- but before:.
  • Notes containing <text>
    Matches notes contain text matching a regular expression
  • Notes marked private
    Matches notes that are indicated as private.
  • Notes matching parameters
    Matches notes with particular parameters
  • Notes matching the <filter>
    Matches notes matched by the specified filter name. Values: Filter name. The specified filter name should be selected from the menu.
  • Notes with id containing <text>
    Matches notes whose Gramps ID matches the regular expression
  • Notes with a reference count of <count>
    Matches notes with a certain number of references. Values: Number of references -- Number must be greater than/lesser/equal to
  • Notes with the <tag>
    Matches notes with a tag of a particular value. Values: Tag name.
  • Notes with the particular type
    Matches notes with the particular type

Mother filters

  • Families having mother with id containing <text>
    Matches families whose mother has a specified Gramps ID
  • Families with mother with the <name>
    Matches families whose mother has a specified (partial) name

Position filters

  • Places in neighborhood of given position
    Matches places with latitude or longitude position in a rectangle of given height and width (in degrees), and with middle point the given latitude and longitude.
  • Places with no latitude or longitude given
    Matches places with empty latitude or longitude

Source filters

  • Citation with Source <id>
    Matches a citation with a source with a specified Gramps ID
  • Citations having source notes containing <text>
    Matches citations whose source notes contain a substring or match a regular expression
  • Citations with Source Id containing <text>
    Matches citations whose source has a Gramps ID that matches the regular expression
  • Sources matching parameters
    Matches citations with a source of a particular value

Relationship filters

This category includes the following rules that match people based on their mutual relationship:

  • People related to <Person>
    Matches people related to a specified person
  • Relationship path between <person> and people matching <filter>
    Searches over the database starting from a specified person and returns everyone between that person and a set of target people specified with a filter. This produces a set of relationship paths (including by marriage) between the specified person and the target people. Each path is not necessarily the shortest path.
  • Relationship path between <persons>
    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 Select... buttons. In the latter case, the ID will appear in the text field after the selection was made.
  • Relationship path between bookmarked persons
    Matches the ancestors of bookmarked individuals back to common ancestors, producing the relationship path(s) between bookmarked persons.

Tagging

Gramps-notes.png

Please update or expand this section.


The concept of tagging for most people using gmail or thunderbird, tags will not be something new. Instead of classifying emails into folders like in Outlook (Windows) or Evolution (Linux), emails are classified by assigning tags to them. So instead of having a disjoint N:1 classification (a email can be in one and only one folder, and a folder can contain many emails), in gmail or thunderbird there is a N:M classification (a email can have several tags, and a tag can be applied to several emails)

Likewise, when you have a big tree, you might want to make subsets of the tree, and these subsets might be overlapping. For example, the subsets of your fathers family and your mothers family, some subset of your family that emigrated to Australia.

The idea is to assign a different tag to each subset: Paternal, Maternal, Australia and ToDo for example.

The differences with Gramps previous Markers are like the folders for emails. A person can be given at most one marker. Tags are thus are like multiple-valued markers.

Go to the Menu Edit ->Tag.

Fig. 14.8 Tag actions from Edit menu


Or click the Toolbar Tag button.

Fig. 14.9 Tag actions from Toolbar button


See also Tag Report

New Tag dialog

Gramps-notes.png

Please update or expand this section.


Fig. 14.10 Attach a new tag to a multiple selection


Organize Tags Window

Gramps-notes.png

Please update or expand this section.


Fig. 14.11 Tag Organizer


Tag selection dialog

Gramps-notes.png

Please update or expand this section.


Fig. 14.12 Tag selection in the Person Editor

When you use Edit the tag list button from any of the Editor dialogs like Person Edit the Tag selection dialog list is shown that lets you remove or assign existing custom tags.

Usage of tags

Here are a some ideas of operations that can be done with tags

Filtering

The most obvious use is that of filtering.

  • Tags and filters both create subsets of the tree. However they have practical differences in usage.
Fig. 14.13 Filter on a tag from the Filter Sidebar

Specifying your fathers family using filters is an easy thing; there are already filters based on some logics that do it. On the other hand, specifying the people that emigrated to the USA is harder, while for the famous people in your family it is simply impossible as there is no logical rule. Tags are much more practical here.

However filters have the advantage of being dynamical. If you add an ancestor of your father in the database, it will be automatically added to the filter.

On the other hand, tags are statical. When adding a famous person in the tree, you have to explicitly tag them as FAMOUS.

  • The most immediate object that comes to mind are the individuals, and that is also the most useful. However, other objects could be tagged:
    • Places: For example "places to visit",
    • Source: For example "sources in german",
    • Notes: For example "notes in progess", or "notes in german",
    • Media: For example "Picture belonging to Uncle Alfred".

Tags are available to use with all primary objects.

Tagging a selection of objects

Fig. 14.14 Attach a new tag to a multiple selection

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 Person View, and add them a new tag or an existing one.

Tags Column

Fig. 14.15 Tags column and colored rows

It is convenient to have a Tags column in the views of objects that can be tagged. The content is a comma-separated list of the tags of the objects.

Previous Index Next


Gnome-important.png Special copyright notice: All edits to this page need to be under two different copyright licenses:

These licenses allow the Gramps project to maximally use this wiki manual as free content in future Gramps versions. If you do not agree with this dual license, then do not edit this page. You may only link to other pages within the wiki which fall only under the GFDL license via external links (using the syntax: [http://www.gramps-project.org/...]), not via internal links.
Also, only use the known conventions