Changes

Da:Gramps 6.0 brugsanvisning - Gramplets

67,117 bytes added, 12:36, 17 October 2025

→‎Alder på datoen

=== Alder på datoen ===

[[File:AgeOnDate-Gramplet-detached-50.png|right|thumb|450px|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} Age On Date Gramplet - detached example]]

The {{man label|Age on Date}} Gramplet allows you to enter a [https://en.wikipedia.org/wiki/Calendar_date Calendar date] in the {{man label|Date:}} entry field. If you select the {{man button|Run}} the Gramplet will compute the ages for everyone in your Family Tree living on that Date and will show the results in a separate {{man label|People and their ages (the/on) <date>}} Quick View report dialog. The date must be entered in a calendar format that Gramps accepts eg: YYYY-MM-DD .

* No configuration options are available for this gramplet.

* You can also drag a date to from [[Gramps_6.0_Wiki_Manual_-_Gramplets#Calendar|Calendar Gramplet]] to the {{man label|Age on Date}} Gramplets {{man label|Date:}} entry field to enter that date.

* See also the [[Third-party_Addons|Third-party Addon]] [[Addon:DateCalculator|Date Calculator Gramplet]] which allows you to do date math.

==== People and their ages (the/on) <date> Quick View report dialog ====

[[File:AgeOnDate-Gramplet-QuickView-example-result-50.png|right|thumb|450px|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} Age On Date Gramplet - Quick View - result example]]

From the resulting {{man label|People and their ages (the/on) <date>}} Quick View report dialog you can sort by the Person, Age or Status columns. Right clicking the row opens a context menu that allows you to ''Copy all'' rows to the clipboard; or to ''See the person details'' in the Person Editor, or ''Make the person active''.

See also:

* [[Gramps_6.0_Wiki_Manual_-_Reports_-_part_8#Quick_Views|Quick_Views]]

=== Age Stats ===

[[File:AgeStats-Gramplet-detached-51.png|right|thumb|450px|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} Age Stats Gramplet - detached example]]

The {{man label|Age Stats}} Gramplet shows statistics in the form of three graphs grouped in 5 years age span breakdowns (use the vertical scroll bar to see the other two graphs or detach and maximize the Gramplet):

* '''Lifespan Age Distribution''' - for all people having valid birth and death dates.

* '''Father - ''Child Age Diff Distribution''''' - shows the age difference between child and father where both individuals have valid birth dates.

* '''Mother - ''Child Age Diff Distribution''''' - shows the age difference between child and mother where both individuals have valid birth dates.

Rolling the mouse cursor over a chart row will display a hint with the count of offspring matching the row's range.

Double-clicking a row in any of the statistics graphs opens a Quick View report of the offspring categorized by that row. You can sort the Quick View report by the Name, Birth Date and Name Type columns.

Right-clicking the Quick View report row displays a context menu for copying the list, opening the Person Editor or activating the person.

====Quick View====

{{stub}}

=====⚙ Configurable Options=====

[[File:AgeStats-Gramplet-configuration-tab-60.png|right|thumb|450px|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} "Age Stats" Gramplet - from People category Configuration tab defaults]]

Adjustable graph scaling limits

* {{man label|Max age:}} (<code>110</code> default) - Maximum age ranging between 1-150.

* {{man label|Max age of Mother at birth:}} (<code>55</code> default) - Maximum age ranging between 1-150.

* {{man label|Max age of Father at birth:}} (<code>70</code> default) - Maximum age ranging between 1-70.

Select the {{man button|Save}} button to apply your changes.

In the Dashboard View, the Gramplet may be detached by clicking the {{man button|Configure active view}} button.

=== Ancestors ===

[[File:Ancestors-Gramplet-detached-example-60.png|right|thumb|450px|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} Ancestors Gramplet - detached example]]

Use the {{man label|Ancestors}} Gramplet to show ancestors of the active person. It is intended to be used as a navigation help, an alternative way to move through your family tree in Gramps . If you detach the Gramplet, and place it next to Gramps, it will allow you to use it to easily change the content of the current "Person view".

Hovering the mouse over a person shows a tooltip with details for them.

Using the context menu to:

* {{man label|Edit}} - the selected person.

* {{man label|Copy All}} - the contents of the gramplet to the OS clipboard

See also:

* {{man label|[[Gramps_6.0_Wiki_Manual_-_Gramplets#Relatives|Relatives]]}} Gramplet - relatives of the active person navigation aid.

=== Attributes ===

[[File:Attributes-Gramplet-detached-50.png|right|thumb|450px|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} Attributes Gramplet]]

The Attributes Gramplet shows all of the attributes for the current, active person. Double click on the name of the attribute, and you will run a Quick View that shows all of the people that have that attribute, and the values for it. You can sort the Quick View by the attribute value by clicking on the column name.

=====Quick View=====

{{stub}}

[[File:Atttribute-Gramplet-QuickView-example-result-50.png|right|450px|thumb|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} Attributes Gramplet - Quick View example result]]

In the Quick View, highlight the entry to change the active person (which will then change the Attributes Gramplet), and double-click the Quick View entry to bring up the Edit Person dialog window.

====Person Attributes====

See [[Gramps_6.0_Wiki_Manual_-_Gramplets#Attributes|Attributes]]

====Family Attributes====

See [[Gramps_6.0_Wiki_Manual_-_Gramplets#Attributes|Attributes]]

====Event Attributes====

See [[Gramps_6.0_Wiki_Manual_-_Gramplets#Attributes|Attributes]]

====Source Attributes====

See [[Gramps_6.0_Wiki_Manual_-_Gramplets#Attributes|Attributes]]

====Citation Attributes====

See [[Gramps_6.0_Wiki_Manual_-_Gramplets#Attributes|Attributes]]

====Media Attributes====

See [[Gramps_6.0_Wiki_Manual_-_Gramplets#Attributes|Attributes]]

=== Calendar ===

[[File:CalendarGramplet-detached-example-60.png|right|thumb|450px|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} "Calendar Gramplet" - detached example]]

The '''Calendar Gramplet''' shows a monthly calendar.

Surrounding the {{man label|''month''}} label at the top left corner, the {{man button|<}} {{man tooltip|previous}} and {{man button|>}} {{man tooltip|next}} buttons can be used to change the month.

Surrounding the {{man label|''year''}} label at the top right corner, the {{man button|<}} {{man tooltip|previous}} and {{man button|>}} {{man tooltip|next}} buttons can be used to change the year.

Double-click a '''day''' to run the {{man label|[[Gramps_6.0_Wiki_Manual_-_Reports_-_part_8#On_This_Day|On This Day]]}} Quick View. The Quick View window shows up to 3 table sections, the events (if any exist) of: the exact date, other events on the same month/day in history, and events in that year.

You can also drag a day from the Calendar to the date fields (such as for the [[Gramps_6.0_Wiki_Manual_-_Entering_and_editing_data:_detailed_-_part_2#New_Event_dialog|Event Editor]] or the [[Gramps_6.0_Wiki_Manual_-_Gramplets#Age on Date|Age on Date Gramplet]]) to enter that date. Similarly, a calendar day may also be dragged to the [[Gramps_6.0_Wiki_Manual_-_Navigation#Using_the_Clipboard|Clipboard]] where it will be stored in a plain text format.

{{man tip|Localized Day of the week headers|The customary first day of the week can be shown on calendar and which vary culturally. The calendar adapts to the language setting. The feature will be included in the 6.0 release but can patched manually. ''See the [https://gramps.discourse.group/t/built-in-calendar-gramplet/2080 Discourse forum discussion on the Calendar Gramplet]''}}

{{man tip|The calendar columns are localized|The customary first day of the week shown on calendars varies culturally. The calendar adapts to the locality. If the first calendar column is for the wrong day of the week, contact the translator for your language and refer them to the [https://github.com/gramps-project/gramps/pull/1319#issuecomment-1002039348 <code>gtk/gtkcalendar</code> translation string].}}

=== Children ===

[[File:ChildrenGramplet-PeopleCategoryView-detached-example-60.png|right|thumb|450px|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} Children Gramplet - detached example with tooltip]]

Gramplet showing the active persons children from '''all marriages'''. Children are displayed as ordered in the family record(s).

Double-click on a row to edit the selected child.

Select a column title to sort temporarily until you exit Gramps.

[[Gramps_6.0_Wiki_Manual_-_FAQ#How_do_I_change_the_order_of_children.3F|How do I change the order of children?]]

* Use the [[Gramps_6.0_Wiki_Manual_-_Entering_and_editing_data:_detailed_-_part_1#Children|Children]] tab in the Family Editor to change the order of children in the active family.

* Use the third-party addon {{man label|[[Addon:BirthOrderTool|Sort Children in Birth order]]}} tool which allows bulk updates of the children order.

See also:

* This [[Gramps_6.0_Wiki_Manual_-_Gramplets#Children|Children]] gramplet in the [[Gramps_6.0_Wiki_Manual_-_Categories#People_Category|People Category]] views displays all children from '''all marriages''' for the active person. Children are displayed as ordered in the family record(s).

====Person Children====

See [[Gramps_6.0_Wiki_Manual_-_Gramplets#Children|Children]]

Also the <code>Spouse</code> column shows if present which other parent the active person had the child with. (and is not the spouse of the listed child!)

====Family Children====

See [[Gramps_6.0_Wiki_Manual_-_Gramplets#Children|Children]]

=== Citations ===

[[File:Citation-Gramplet-detached-50.png|right|thumb|450px|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} Citation Gramplet - detached example]]

Gramplet showing the active persons citations.

====Person Citations====

See [[Gramps_6.0_Wiki_Manual_-_Gramplets#Citations|Citations]]

====Family Citations====

See [[Gramps_6.0_Wiki_Manual_-_Gramplets#Citations|Citations]]

====Event Citations====

See [[Gramps_6.0_Wiki_Manual_-_Gramplets#Citations|Citations]]

====Place Citations====

See [[Gramps_6.0_Wiki_Manual_-_Gramplets#Citations|Citations]]

====Media Citations====

See [[Gramps_6.0_Wiki_Manual_-_Gramplets#Citations|Citations]]

=== Descendant Fan Chart===

[[File:DescendantFan-Gramplet-detached-50.png|right|thumb|450px|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} Descendant Fan (chart) Gramplet - detached example]]

Gramplet showing active person's direct descendants as a fan chart.

'''See also:'''

=== Descendants ===

[[File:Descendants-Gramplet-detached-50.png|thumb|right|450px|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} Descendants Gramplet - detached example]]

The Descendants Gramplet shows the direct descendants of the active person.

The order of the spouses and children is that given in the Gramps editor. To change the order of spouses, click on ''Order'' on the Relationship view. To change the order of children, [http://en.wikipedia.org/wiki/Drag-and-drop drag and drop] them in the correct order in the Family edit window.

This Gramplet is based on the [[Gramps_6.0_Wiki_Manual_-_Reports_-_part_6#Descendant_Report|Descendant Report]], available from the Textual Reports.

The Descendants Gramplet will update when you change the active person, or change family trees. It does not update automatically for edits or additions because this report is time-consuming to run.

Minimizing a Gramplet will prevent it from updating.

Moving the mouse over a person will show a tooltip summary which includes the death date.

=== Details ===

[[File:Details-Gramplet-detached-50.png|right|thumb|450px|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} Details Gramplet - detached example]]

Gramplet showing details of the active person.

Provides a brief non editable summary of the selected person for example:

* ''Name'': of person

* ''Also Known As:''

* ''Other Name:''

* ''Father:''

* ''Mother:''

* ''Birth:''

* ''Death:''

* ''Burial:''

* ''Image'': If available the primary image will be shown to the right of the details, otherwise a cross will indicate the image is missing, you may double click the image to open it in an external viewer. To change the primary active image see: [[Gramps_6.0_Wiki_Manual_-_Entering_and_editing_data:_detailed_-_part_1#Gallery|Edit Person Editors - Gallery tab]]

You may highlight and copy the individual text fields.

* [[Gramps_6.0_Wiki_Manual_-_Settings#Missing_Media_Objects_.27broken_link.27_icon_of_a_box_with_a_red_.27x.27|Missing Media Objects 'broken link' icon of a box with a red 'x']]

====Person Details====

See [[Gramps_6.0_Wiki_Manual_-_Gramplets#Details|Details]]

====Place Details====

See [[Gramps_6.0_Wiki_Manual_-_Gramplets#Details|Details]]

====Repository Details====

See [[Gramps_6.0_Wiki_Manual_-_Gramplets#Details|Details]]

=== Encloses ===

[[File:Encloses-Gramplet-detached-example-50.png|right|thumb|450px|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} Encloses Gramplet - detached example]]

Gramplet showing the hierarchical locations of a place it encloses over time.

* See also [[Gramps_6.0_Wiki_Manual_-_Entering_and_editing_data:_detailed_-_part_2#Enclosed_By|Enclosed By]] tab

====Encloses Place Locations====

See [[Gramps_6.0_Wiki_Manual_-_Gramplets#Enclosed_By|Enclosed By]]

=== Enclosed By===

[[File:EnclosedBy-Gramplet-detached-example-50.png|right|thumb|450px|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} Enclosed By Gramplet - detached example]]

Gramplet showing the locations hierarchically enclosed by a place over time.

* See also [[Gramps_6.0_Wiki_Manual_-_Entering_and_editing_data:_detailed_-_part_2#Enclosed_By|Enclosed By]] tab

====Enclosed By Place Locations====

See [[Gramps_6.0_Wiki_Manual_-_Gramplets#Encloses|Encloses]]

=== Events ===

[[File:Events-Gramplet-detached-50.png|right|thumb|450px|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} Events Gramplet - detached example]]

Primarily designed as an alternative to opening a Edit Object dialog layout tab .

Double click a row to edit the event.

See [[Gramps_6.0_Wiki_Manual_-_Gramplets#Events|Events]]

====Family Events====

Gramplet added in the Person category will show the events for the active Family.

====Person Events====

Gramplet added in the Person category will show the events for the active person.

===Events Coordinates===

Primarily designed to verify that the key data exists to plot the Events in the Geography view. Beyond the coordinates, a date and event type are needed for some of the animated views.

Right-click a row to open a context menu to edit the event or place.

==== Family Events Audit ====

[[File:EventsCoordinates-Gramplet-detached-50.png|right|thumb|450px|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} Events Coordinates Gramplet - detached example]]

Gramplet added in the Family category will show the Events for the active Family.

====Person Events Audit====

Gramplet added in the Person category will show the Events for the active person.

=== Fan Chart ===

[[File:FanChart-detached-gramplet-50.png|thumb|right|450px|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} Fan Chart Gramplet]]

The Fan Chart Gramplet shows the direct ancestors of the active person in a circular format. It is similar to the Pedigree View, but shown around the center/active person, and further generations spiralling out.

Click on a parent in the chart and they will expand or contract above their child. Right-click on a person and you can:

* select that person to be the active person

* edit the person which allows through Person Editor add children to person's families

* select from among the person's relatives to be the active person

* add partners (families) to person

* copy name, birth and death of person into clipboard

Clicking in an open area (non-person) and dragging the mouse will allow you to rotate the chart about the center. You may also left-click and drag in the center to reposition the fan chart.

A black edge on the outer radius of the chart indicates more parents for that person. A black circle in the center indicates that the center person has children.

The Fan Chart Gramplet will update when you change the active person, or change family trees.

Minimizing a Gramplet will prevent it from updating.

'''See also:'''

=== FAQ ===

[[File:FAQ-Gramplet-detached-50.png|right|thumb|450px|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} FAQ Gramplet - detached example]]

The {{man label|FAQ Gramplet}} (Frequently Asked Questions) shows a list of common questions, and links to their answers from the Gramps Wiki (requires an internet connection).

This gramplet shows a manually curated list of '''Frequently Asked Questions''' hyperlinked to answers in articles of the Gramps wiki. The list is collated from new user postings to the [[Contact#Forum|Gramps User Forum]] that must be answered repeatedly.

The idea is to make the answers to the most common question easier to find, the primary objective is to let new users start using Gramps more quickly.

====See Also====

* Bug Report {{bug|11997}}: how to add/update FAQs

=== Filter ===

Gramplet providing a filter specific to the Category:

* {{man label|[[Gramps_6.0_Wiki_Manual_-_Gramplets#People_Filter|People Filter Gramplet]]}}

* {{man label|[[Gramps_6.0_Wiki_Manual_-_Gramplets#Families_Filter|Families Filter Gramplet]]}}

* {{man label|[[Gramps_6.0_Wiki_Manual_-_Gramplets#Charts_Filter|Charts Filter Gramplet]]}} - ''Interface is the same as the {{man label|[[Gramps_6.0_Wiki_Manual_-_Gramplets#People_Filter|People Filter Gramplet]]}}''

* {{man label|[[Gramps_6.0_Wiki_Manual_-_Gramplets#Events_Filter|Events Filter Gramplet]]}}

* {{man label|[[Gramps_6.0_Wiki_Manual_-_Gramplets#Places_Filter|Places Filter Gramplet]]}}

* {{man label|[[Gramps_6.0_Wiki_Manual_-_Gramplets#Geography_Filter|Geography Filter Gramplet]]}} - ''Interface is the same as the {{man label|[[Gramps_6.0_Wiki_Manual_-_Gramplets#People_Filter|Places Filter Gramplet]]}}''

* {{man label|[[Gramps_6.0_Wiki_Manual_-_Gramplets#Sources_Filter|Sources Filter Gramplet]]}}

* {{man label|[[Gramps_6.0_Wiki_Manual_-_Gramplets#Citations_Filter|Citations Filter Gramplet]]}}

* {{man label|[[Gramps_6.0_Wiki_Manual_-_Gramplets#Repositories_Filter|Repositories Filter Gramplet]]}}

* {{man label|[[Gramps_6.0_Wiki_Manual_-_Gramplets#Media_Filter|Media Filter Gramplet]]}}

* {{man label|[[Gramps_6.0_Wiki_Manual_-_Gramplets#Notes_Filter|Notes Filter Gramplet]]}}

======General usage ======

{{stub}}

======See Also ======

*[[Gramps_6.0_Wiki_Manual_-_Filters#Which_filters_in_which_Category.3F|Which filters (rules) in which Category?]]

*Gramps Glossary term: [[Gramps_Glossary#regex|Regular Expressions]] for pattern matching in searches

*Third party ''Isotammi'' [[Addon:Isotammi_addons#Filter.2B|Filter+ gramplet addon]]

====People Filter====

[[File:FilterGramplet-Person-detached-default-60.png|right|thumb|450px|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} People - "Filter Gramplet" - detached - default]]

Equivalent to the [[Gramps_6.0_Wiki_Manual_-_Filters#toc|built-in Custom Filter rules]]:

*{{man label|Name}} : [[Gramps_6.0_Wiki_Manual_-_Filters#People_with_the_.3Cname.3E|People with a name matching <text>]]

*{{man label|ID}} : [[Gramps_6.0_Wiki_Manual_-_Filters#People_with_.3Cid.3E|People with Id containing <text>]]

*{{man label|Gender}} : [[Gramps_6.0_Wiki_Manual_-_Filters#Males|Male]] • [[Gramps_6.0_Wiki_Manual_-_Filters#Females|Female]] • [[Gramps_6.0_Wiki_Manual_-_Filters#People_with_unknown_gender|People with unknown gender]]

*{{man label|Birth date}} : [[Gramps_6.0_Wiki_Manual_-_Filters#People_with_the_.3Cbirth_data.3E|People with the <birth data>]]

** Date selection editor

*{{man label|Death date}} : [[Gramps_6.0_Wiki_Manual_-_Filters#People_with_the_.3Cdeath_data.3E|People with the <death data>]]

** Date selection editor

*{{man label|Event}} : [[Gramps_6.0_Wiki_Manual_-_Filters#People_with_the_personal_.3Cevent.3E|People with the personal <event>]]

*{{man label|Note}} : [[Gramps_6.0_Wiki_Manual_-_Filters#People_having_notes_containing_.3Ctext.3E|People having notes containing <text>]]

*{{man label|Tag}} : [[Gramps_6.0_Wiki_Manual_-_Filters#Families_with_the_.3Ctag.3E|People with the <tag>]]

*{{man label|Custom filter}} : [[Gramps_6.0_Wiki_Manual_-_Filters#People_matching_the_.3Cfilter.3E|People matching the <filter>]]

** Define filter editor

*{{checkbox|0}}{{man label|Use regular expressions}} :

*{{checkbox|0}}{{man label|Case sensitive}} :

* {{man button|Find}} :

* {{man button|Reset}} :

* {{man button|Define filter}} button that automatically creates a custom filter based on the given criteria. This makes it easy to create simple custom filters. {{new|6.0 [https://github.com/gramps-project/gramps/pull/1721]}}

{{stub}}

=====People Filter example=====

Some simple regular expressions to filter out persons with surnames spelled slightly different.

With this regular expression in the sidebar filter {{man label|Name:}} entry:

eri[ck](s|ss)on

or

eri[ck]ss?on

or

eri[ck]s+on

You get all four versions as result:

Ericson

Ericsson

Erikson

Eriksson

{{man note|''Use of regular expressions'' only works on '''some''' fields}}

====Families Filter====

[[File:FilterGramplet-Family-detached-default-60.png|right|thumb|450px|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} Families - "Filter Gramplet" - detached - default]]

Equivalent to the [[Gramps_6.0_Wiki_Manual_-_Filters#toc|built-in Custom Filter rules]]:

* ID : [[Gramps_6.0_Wiki_Manual_-_Filters#Families_having_child_with_id_containing_.3Ctext.3E|Families with Id containing <text>]]

* Father :[[Gramps_6.0_Wiki_Manual_-_Filters#Families_with_father_with_the_.3Cname.3E|Families with father matching the <regex_name>]]

* Mother : [[Gramps_6.0_Wiki_Manual_-_Filters#Families_with_mother_with_the_.3Cname.3E|Families with mother matching the <regex_name>]]

* Child : [[Gramps_6.0_Wiki_Manual_-_Filters#Families_with_child_with_the_.3Cname.3E|Families with child matching the <regex_name>]]

* Relationship : [[Gramps_6.0_Wiki_Manual_-_Filters#Families_with_the_relationship_type|Families with the relationship type]]

* Family Event : [[Gramps_6.0_Wiki_Manual_-_Filters#Families_with_the_.3Cevent.3E|Families with the <event>]]

* Family Note : [[Gramps_6.0_Wiki_Manual_-_Filters#Families_having_notes_containing_.3Ctext.3E|Families having notes containing <text>]]

* Tag : [[Gramps_6.0_Wiki_Manual_-_Filters#Families_with_the_.3Ctag.3E|Families with the <tag>]]

* Custom filter : [[Gramps_6.0_Wiki_Manual_-_Filters#Families_matching_the_.3Cfilter.3E|Families matching the <filter>]]

====Charts Filter====

[[File:FilterGramplet-Person-detached-default-60.png|right|thumb|450px|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} Charts - Filter Gramplet - detached - default (Same as People Filter)]]

The diagrams in Charts need the context of connecting records to define the connections between blocks. So rather than only displaying ''only'' the matching records in the Charts view modes, Filters for the Charts still displays all the records but dims the non-matching ones.

''Interface is the same as the {{man label|[[Gramps_6.0_Wiki_Manual_-_Gramplets#People_Filter|People Filter Gramplet]]}}''

====Events Filter====

[[File:FilterGramplet-Event-detached-default-60.png|right|thumb|450px|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} Events - Filter Gramplet - detached - default]]

Equivalent to the [[Gramps_6.0_Wiki_Manual_-_Filters#toc|built-in Custom Filter rules]]:

* ID : [[Gramps_6.0_Wiki_Manual_-_Filters#Events_with_Id_containing_.3Ctext.3E|Events with Id containing <text>]]

* Description : [[Gramps_6.0_Wiki_Manual_-_Filters#Events_matching_parameters|Events matching parameters]]

* Type : ''Events matching parameters''

* Participants : ''Events matching parameters''

* Date : ''Events matching parameters''

* Place : ''Events matching parameters''

* Note : [[Gramps_6.0_Wiki_Manual_-_Filters#Events_having_notes_containing_.3Ctext.3E|Events having notes containing <text>]]

* Tag : [[Gramps_6.0_Wiki_Manual_-_Filters#Events_with_the_.3Ctag.3E|Events with the <tag>]]

* Custom filter : [[Gramps_6.0_Wiki_Manual_-_Filters#Events_matching_the_.3Cfilter.3E|Events matching the particular <filter>]]

====Places Filter====

[[File:FilterGramplet-Place-detached-default-60.png|right|thumb|450px|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} Places - Filter Gramplet - detached - default]]

Equivalent to the [[Gramps_6.0_Wiki_Manual_-_Filters#toc|built-in Custom Filter rules]]:

* ID : [[Gramps_6.0_Wiki_Manual_-_Filters#Places_with_Id_containing_.3Ctext.3E|Places with Id containing <text>]]

* Name : [[Gramps_6.0_Wiki_Manual_-_Filters#Places_matching_parameters|Places matching parameters]]

* Type : ''Places matching parameters''

* Code : ''Places matching parameters''

* Enclosed By : [[Gramps_6.0_Wiki_Manual_-_Filters#Places_enclosed_by_another_place|Places enclosed by another place]]

* Within : [[Gramps_6.0_Wiki_Manual_-_Filters#Places_within_an_area|Places within an area]]

* Note : [[Gramps_6.0_Wiki_Manual_-_Filters#Places_having_notes_containing_.3Ctext.3E|Places having notes containing <text>]]

* Tag : [[Gramps_6.0_Wiki_Manual_-_Filters#Places_with_the_.3Ctag.3E|Places with the <tag>]]

* Custom filter : [[Gramps_6.0_Wiki_Manual_-_Filters#Places_matching_the_.3Cfilter.3E|Places matching the <filter>]]

====Geography Filter====

[[File:FilterGramplet-Place-detached-default-60.png|right|thumb|450px|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} Geography - Filter Gramplet - detached - default (Same as Places Filter)]]

''Interface is the same as the {{man label|[[Gramps_6.0_Wiki_Manual_-_Gramplets#Places_Filter|Places Filter Gramplet]]}}''

====Sources Filter====

[[File:FilterGramplet-Source-detached-default-60.png|right|thumb|450px|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} Sources - Filter Gramplet - detached - default]]

Equivalent to the [[Gramps_6.0_Wiki_Manual_-_Filters#toc|built-in Custom Filter rules]]:

* ID : [[Gramps_6.0_Wiki_Manual_-_Filters#Sources_with_Id_containing_.3Ctext.3E|Sources with Id containing <text>]]

* Title : [[Gramps_6.0_Wiki_Manual_-_Filters#Sources_matching_parameters|Sources matching parameters]]

* Author : ''Sources matching parameters''

* Abbreviation : ''Sources matching parameters''

* Publication : ''Sources matching parameters''

* Note : [[Gramps_6.0_Wiki_Manual_-_Filters#Sources_having_notes_containing_.3Ctext.3E|Sources having notes containing <text>]]

* Tag : [[Gramps_6.0_Wiki_Manual_-_Filters#Sources_with_the_.3Ctag.3E|Sources matching the <tag>]]

* Custom filter : [[Gramps_6.0_Wiki_Manual_-_Filters#Sources_matching_the_.3Cfilter.3E|Sources matching the <filter>]]

====Citations Filter====

[[File:FilterGramplet-Citation-detached-default-60.png|right|thumb|450px|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} Citations - Filter Gramplet - detached - default]]

Equivalent to the [[Gramps_6.0_Wiki_Manual_-_Filters#toc|built-in Custom Filter rules]]:

'''Source:'''

* ID : [[Gramps_6.0_Wiki_Manual_-_Filters#Citations_with_Id_containing_.3Ctext.3E|Sources with Id containing <text>]]

* Title : [[Gramps_6.0_Wiki_Manual_-_Filters#Sources_matching_parameters|Sources matching parameters]]

* Author : ''Sources matching parameters''

* Abbreviation : ''Sources matching parameters''

* Publication : ''Sources matching parameters''

* Note : [[Gramps_6.0_Wiki_Manual_-_Filters#Citations_having_source_notes_containing_.3Ctext.3E|Citations having source notes containing <text>]]

'''Citation:'''

* ID : [[Gramps_6.0_Wiki_Manual_-_Filters#Citations_with_Id_containing_.3Ctext.3E|Citations with Id containing <text>]]

* Volume/Page : [[Gramps_6.0_Wiki_Manual_-_Filters#Citations_matching_parameters|Citations matching parameters]]

* Date : ''Citations matching parameters''

* Min. Conf. : ''Citations matching parameters''

* Note : [[Gramps_6.0_Wiki_Manual_-_Filters#Citations_having_notes_containing_.3Ctext.3E|Citations having notes containing <text>]]

* Tag : [[Gramps_6.0_Wiki_Manual_-_Filters#Citations_with_the_.3Ctag.3E|Citations with the <tag>]]

* Custom filter : [[Gramps_6.0_Wiki_Manual_-_Filters#Citations_matching_the_.3Cfilter.3E|Citations matching the <filter>]]

====Repositories Filter====

[[File:FilterGramplet-Repository-detached-default-60.png|right|thumb|450px|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} Repositories - "Filter Gramplet" - detached - default]]

Equivalent to the [[Gramps_6.0_Wiki_Manual_-_Filters#toc|built-in Custom Filter rules]]:

* ID : [[Gramps_6.0_Wiki_Manual_-_Filters#Repositories_with_Id_containing_.3Ctext.3E|Repositories with Id containing <text>]]

* Name : [[Gramps_6.0_Wiki_Manual_-_Filters#Repositories_matching_parameters|Repositories matching parameters]]

* Type : ''Repositories matching parameters''

* Address : ''Repositories matching parameters''

* URL : ''Repositories matching parameters''

* Note : [[Gramps_6.0_Wiki_Manual_-_Filters#Repositories_having_notes_containing_.3Ctext.3E|Repositories having notes containing <text>]]

* Tag : [[Gramps_6.0_Wiki_Manual_-_Filters#Repositories_with_the_.3Ctag.3E|Repositories with the <tag>]]

* Custom filter : [[Gramps_6.0_Wiki_Manual_-_Filters#Repositories_matching_the_.3Cfilter.3E|Repositories matching <filter>]]

====Media Filter====

[[File:FilterGramplet-Media-detached-default-60.png|right|thumb|450px|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} Media - Filter Gramplet - detached - default]]

Equivalent to the [[Gramps_6.0_Wiki_Manual_-_Filters#toc|built-in Custom Filter rules]]:

* ID : [[Gramps_6.0_Wiki_Manual_-_Filters#Media_objects_with_Id_containing_.3Ctext.3E|Media objects with Id containing <text>]]

* Title : [[Gramps_6.0_Wiki_Manual_-_Filters#Media_objects_matching_parameters|Media objects matching parameters]]

* Type : ''Media objects matching parameters''

* Path : ''Media objects matching parameters''

* Date : ''Media objects matching parameters''

* Note : [[Gramps_6.0_Wiki_Manual_-_Filters#Media_objects_having_notes_containing_.3Ctext.3E|Media objects having notes containing <text>]]

* Tag : [[Gramps_6.0_Wiki_Manual_-_Filters#Media_objects_with_the_.3Ctag.3E|Media objects with the <tag>]]

* Custom filter : [[Gramps_6.0_Wiki_Manual_-_Filters#Media_objects_matching_the_.3Cfilter.3E|Media objects matching the <filter>]]

====Notes Filter====

[[File:FilterGramplet-Notes-detached-default-60.png|right|thumb|450px|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} Notes - Filter Gramplet - detached - default]]

Equivalent to the [[Gramps_6.0_Wiki_Manual_-_Filters#toc|built-in Custom Filter rules]]:

* ID : [[Gramps_6.0_Wiki_Manual_-_Filters#Notes_with_Id_containing_.3Ctext.3E|Notes with Id containing <text>]]

* Text : [[Gramps_6.0_Wiki_Manual_-_Filters#Notes_matching_parameters|Notes matching parameters]]

* Type : ''Notes matching parameters''

* Tag : [[Gramps_6.0_Wiki_Manual_-_Filters#Notes_with_the_.3Ctag.3E|Notes with the <tag>]]

* Custom filter : [[Gramps_6.0_Wiki_Manual_-_Filters#Notes_matching_the_.3Cfilter.3E|Notes matching the <filter>]]

=== Gallery ===

[[File:Gallery-Gramplet-detached-example-60.png|thumb|right|450px|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} Gallery Gramplet - detached example]]

Gramplet showing media objects. The first image is the primary active media object that is used in reports and the {{man label|[[Gramps_6.0_Wiki_Manual_-_Entering_and_editing_data:_detailed_-_part_1#Edit_Person_dialog|Edit Person dialog]]}}.

You can use the context menu to right click and {{man menu|Make Active Media}}

Double-click on the picture to view it in the default image viewer application.

See also:

* To change the primary media object for reports etc... use the {{man label|[[Gramps_6.0_Wiki_Manual_-_Entering_and_editing_data:_detailed_-_part_1#Edit_Person_dialog|Edit Person dialog]]}}s [[Gramps_6.0_Wiki_Manual_-_Entering_and_editing_data:_detailed_-_part_1#Gallery|Gallery]] tab.

====Person Gallery====

See [[Gramps_6.0_Wiki_Manual_-_Gramplets#Gallery|Gallery]]

====Family Gallery====

See [[Gramps_6.0_Wiki_Manual_-_Gramplets#Gallery|Gallery]]

====Event Gallery====

See [[Gramps_6.0_Wiki_Manual_-_Gramplets#Gallery|Gallery]]

====Place Gallery====

See [[Gramps_6.0_Wiki_Manual_-_Gramplets#Gallery|Gallery]]

====Source Gallery====

See [[Gramps_6.0_Wiki_Manual_-_Gramplets#Gallery|Gallery]]

====Citation Gallery====

See [[Gramps_6.0_Wiki_Manual_-_Gramplets#Gallery|Gallery]]

=== Given Name Cloud ===

[[File:GivenNameCloud-Gramplet-detached-example-60.png|thumb|right|450px|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} Given Name Cloud Gramplet - detached example]]

The {{man label|Given Name Cloud}} Gramplet shows the top most popular given names in your family tree. The font size of the name indicates how popular it is. Mouse over the name to see the exact count, and the percent of people in the family tree that have that name.

The Gramplet splits up given names into words (broken up by spaces). For example "Sarah Elizabeth" would appear under both "Sarah" and "Elizabeth".

Double-click on the given name to bring up a Quick View of all of the matching people.

See also:

* [[#Surname_Cloud|Surname Cloud Gramplet]]

====Quick View====

{{stub}}

=== Image Metadata ===

[[File:ImageMetadata-Gramplet-detached-50.png|thumb|right|450px|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} Image Metadata Gramplet - example]]

The {{man label|Image Metadata}} Gramplet offers an interface to look at [https://en.wikipedia.org/wiki/Exchangeable_image_file_format Image Exif Metadata] from your images (*.jpg, *.png. *.tiff, *.exv, *.nef, *.psd, *.pgf).

See also:

* [[Gramps_6.0_Wiki_Manual_-_Categories#Notes_Category|Notes Category]]

* [[Gramps_6.0_Wiki_Manual_-_Entering_and_editing_data:_detailed_-_part_2#Editing_information_about_notes|Editing information about notes]]

* [[Addon:NoteGramplet|Note Gramplet]] - Third party Addon

====Person Notes====

See [[Gramps_6.0_Wiki_Manual_-_Gramplets#Notes|Notes]]

====Family Notes====

See [[Gramps_6.0_Wiki_Manual_-_Gramplets#Notes|Notes]]

====Event Notes====

See [[Gramps_6.0_Wiki_Manual_-_Gramplets#Notes|Notes]]

====Place Notes====

See [[Gramps_6.0_Wiki_Manual_-_Gramplets#Notes|Notes]]

====Source Notes====

See [[Gramps_6.0_Wiki_Manual_-_Gramplets#Notes|Notes]]

====Citation Notes====

See [[Gramps_6.0_Wiki_Manual_-_Gramplets#Notes|Notes]]

====Repository Notes====

See [[Gramps_6.0_Wiki_Manual_-_Gramplets#Notes|Notes]]

====Media Notes====

See [[Gramps_6.0_Wiki_Manual_-_Gramplets#Notes|Notes]]

=== Pedigree ===

[[File:Pedigree-Gramplet-detached-example-60.png|thumb|right|450px|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} Pedigree Gramplet - detached example]]

The {{man label|Pedigree}} Gramplet shows a compressed view of the active person's direct ancestors. It defaults to going back 100 generations. The names can be clicked to change the active person, right-click to edit the person. At the bottom of the Gramplet the number of people per generation is listed. Birth and death dates are shown next to each person's name. Double-click the Generation number to see the matching individuals in a Quick View report.

Using the content of the Pedigree in another program requires a bit of effort Open a contextual pop-up menu by right-clicking anywhere in the gramplet except a hotlink. Or, you can begin a drag selection from the same inert areas. Copy the highlighted text the OS clipboard from that same context menu. (The keybinding for 'Copy' will not work.) When you paste the text into another text editing program, you may need change the font to a non-proportional font to preserve the indentation. Some online services collapse leading spaces when you post a chunk of text. Preserving the indentation for such services may require replacing doubled spaces with doubled placeholder characters... like periods/full stops.

====⚙ Configurable Options====

* {{man label|Max generations:}} 1 to 100 limit; (default: ''100'') - Maximum generations to display.

* {{man label|[x]}} {{man label|Show dates}} (default: checkbox selected)

* {{man label|Line type:}}

** <abbr title="Unicode Transformation Format graphical symbols">'''UTF'''</abbr> (default)

** <abbr title="American Standard Code for Information Interchange text symbols">''ASCII''</abbr>

=== Python Evaluation ===

{{man warn|Warning! Diagnostic Tool|Do not use this '''[[Gramps_6.0_Wiki_Manual_-_Tools#Debug|Debug]]''' feature on your working Family Tree. Always create a new empty Family Tree or a copy of your existing Family Tree for testing. This option is only available when Gramps has been started using a developer [[Gramps_6.0_Wiki_Manual_-_Command_Line#Python_options|mode switch]]. It is not intended for general use and has limited safeguards.}}

[[File:PythonEvaluationGramplet-detached-example-60.png|right|thumb|450px|Fig {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} "Python Evaluation Gramplet" - detached example]]

The {{man label|Python Evaluation}} Gramplet tool is intended to test Python scripts with Gramps data.

{{stub}}

==== Example usage ====

Sample code for listing Gramps internal "[https://github.com/gramps-project/gramps/blob/master/gramps/gen/const.py constants]":

<pre>

import os

import sys

from gramps.gen.const import *

# Get all uppercase variables from the current namespace

ENV = {

name: value for name, value in locals().items()

if name.isupper() and not name.startswith('_') and isinstance(value, str)

}

# Print each item in the dictionary, indicating if it's a hidden directory

for key, value in ENV.items():

try:

if os.path.isdir(value):

if sys.platform.startswith('win'):

import ctypes

attrs = ctypes.windll.kernel32.GetFileAttributesW(value)

hidden_status = "HIDDEN" if attrs != -1 and bool(attrs & 2) else "NOT HIDDEN"

else:

hidden_status = "HIDDEN" if os.path.basename(value).startswith('.') else "NOT HIDDEN"

print(f"({hidden_status}) {key} : {value}")

else:

print(f"{key} : {value} (NOT A DIRECTORY)")

except Exception as e:

print(f"{key} : {value} (ERROR : {str(e)})")

</pre>

==== See Also ====

* [[Addon:Python_Shell_Gramplet|Python Shell]] addon gramplet. Where possible, use the '''Python Shell''' instead of '''Python Eval'''. It has extra garbage collection functionality

* Debug submenu in the [[Gramps_6.0_Wiki_Manual_-_Navigation#Tools|Tools]] menu before version 4.0.2

* [[Contact#Mailing_lists|Gramps-devel]] maillist: [https://sourceforge.net/p/gramps/mailman/gramps-devel/thread/524D973D.9000604%40hotmail.com/#msg31477962 Converting tools to gramplets] - Oct 2013

* Discourse -- Sample scripts:

** [https://gramps.discourse.group/t/need-some-json-parsing-tools/6855/7 sample script to Parse selected JSON to CSV]

** [https://gramps.discourse.group/t/troubleshooting-gramps-paths-and-environmental-variables/5692 troubleshooting Gramps paths and environmental variables]

* [[Gramps_6.0 Wiki Manual - Command Line#Python options|Command Line: Python options]]

* [[Gramps_6.0_Wiki_Manual_-_Gramplets#Uncollected_Objects|Uncollected Objects]] Gramplet

=== Quick View ===

[[File:QuickView-Gramplet-detached-50.png|thumb|right|450px|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} Quick View Gramplet - detached example]]

The Quick View Gramplet allows the selected [[Gramps_6.0_Wiki_Manual_-_Reports_-_part_8#Quick_Views|Quick View report]] to be updated dynamically as active records are changed. Instead of a window with a static report, the gramplet updates as different active records are selected within the target Category. (When this Gramplet was introduced, it only offered choosing Quick View Reports from the People category. A Configuration pop-up menu to select View categories has since been added.)

You can run any of the builtin [[Gramps_6.0_Wiki_Manual_-_Reports_-_part_8#Quick_Views|Quick Views]] or [[6.0_Addons#Addon_List|addon]] QuickView reports.

[[File:QuickView-Gramplet-Configuration-tab-50.png|thumb|right|450px|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} Quick View Gramplet - Configuration tab shown]]

You can change the options by clicking the Option button (top, left hand button of the Gramplet) which will detach the Gramplet and bring it up an a window. Select {{man label|Options}} on the top row, and a list of options will appear. Press {{man button|Save}} to apply the changes to the Quick View. You may then close the window to reattach the Gramplet.

See the following developer information if you are interested in creating your own:

* [[Gramps_6.0_Wiki_Manual_-_Reports_-_part_8#Making_your_own_Quick_Views|Making your own Quick Views]].

=== Records ===

[[File:Records-Gramplet-detached-50.png|right|thumb|450px|Fig {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} Records Gramplet - detached example]]

The Records Gramplet shows a number of interesting facts about the records (mostly age related) from your database. The list shows the top three for each element.

* Person Records:

** Youngest living person

** Oldest living person

** Person died at youngest age

** Person died at oldest age

** Person married at youngest age

** Person married at oldest age

** Person divorced at youngest age

** Person divorced at oldest age

** Youngest father

** Youngest mother

** Oldest father

** Oldest mother

* Family Records

** Couple with most children

** Living couple married most recently

** Living couple married most long ago

** Shortest past marriage

** Longest past marriage

The list is not only interesting on its own, it is also a good sanity check of the data. For some items you have to fill in some additional information.

This following example shows that there was a marriage event (thus calculation of the offset) but none of the persons had a death event. Even if the date is not known, just enter a death event for one of the partners and the list will be corrected.

'''Living couple married most long ago'''

# van Dosselaere, Egidius and Rechters, Petronella (382 years, 1 month)

# de Richter, Petrus and Asscericx, Catharina (379 years, 9 months)

An identical [[Gramps_6.0_Wiki_Manual_-_Reports_-_part_6#Records_Report|Records Report]] is also available.

=== References ===

[[File:References-Gramplet-detached-50.png|right|thumb|450px|Fig {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} References Gramplet - detached example]]

Gramplet showing the active persons References.

====Person References====

* Person References : Gramplet showing the backlink references for a person