Difference between revisions of "Filter"

From Gramps
Jump to: navigation, search
(conversion of usefilters)
 
m (Examples: cleanup)
(9 intermediate revisions by 5 users not shown)
Line 1: Line 1:
 +
{{languages}}
 
What are filters?
 
What are filters?
 
 
[[Category:Documentation]]
 
[[Category:Documentation]]
  
Line 10: Line 10:
  
 
==How to define custom filters==
 
==How to define custom filters==
In the Edit menu, click the option <code><view> Filter Editor</code>, where <code><view></code> depends on the present view. It can be ''Person, Family, Event, Place, Media'' or ''Repository''.
+
Custom filters are relative to the active View. If you are in People View you will create a Person Filter, Event View/an Event Filter, etc. In the {{man label|Edit}} menu, click the option {{man label|<View> Filter Editor}}.
  
You can give the custom filter a name, and then add rules to the filter. The data will be filtered according to the rules.  
+
You can give the custom filter a name and add rules to the filter. The data will be filtered according to the rules.  
  
In some filters you can use regular expressions. For learning how to use these, see the  [http://www.amk.ca/python/howto/regex/regex.html Regular Expression HOWTO].
+
In some filters you can use regular expressions. For learning how to use regular expressions, see the  [http://docs.python.org/howto/regex.html Regular Expression HOWTO].
  
 
== Test a custom filter==
 
== Test a custom filter==
In the <code>Edit menu</code>, click on <code>Column Editor</code>, and select the columns you want to view. Next, activate the [[Filter Sidebar]]. This can be done by going to the <code>View menu</code>, and clicking on <code>Filter Sidebar</code>.  
+
In the {{man label|Edit}} menu, click on {{man label|Column Editor}}, and select the columns you want to view. Next, activate {{man label|Filter}}. This can be done by going to the {{man label|View}}  menu, and clicking on {{man label|Filter}}.
  
 
== Examples ==
 
== Examples ==
 
See [[Example filters]].
 
See [[Example filters]].
 +
 
To the right of the list view, a sidebar will open, allowing to filter your data. At the bottom of this, you can select the newly created Custom Filter. Click on Find, and all Persons/ Families/Events/Places/Media/Repositories matching the filter are displayed.
 
To the right of the list view, a sidebar will open, allowing to filter your data. At the bottom of this, you can select the newly created Custom Filter. Click on Find, and all Persons/ Families/Events/Places/Media/Repositories matching the filter are displayed.
At present, there is no way to print this data (Should be available in the upcoming version 2.4).
+
 
 +
At present (version 2.X), there is no way to print this data.
 +
 
 +
In the '''3.0 version''' you will have an option {{man label|Export view}} on the {{man label|Family Trees}} menu. This gives you the opportunity to export the view as a spreadsheet with following format options:
 +
*[[Gramps_3.4_Wiki_Manual_-_Manage_Family_Trees:_CSV_Import_and_Export#Export|CSV]]
 +
*Open Document Spreadsheet
 +
 
 +
Another '''3.0''' method would be that you select the {{man label|Export}} option on the {{man label|Family Trees}} menu. An '''Export Assistant''' view will be presented where you also can select the {{man button|Comma Separated Values Spreadsheet (CSV)}}. Next, click on the {{man button|Forward}} button and in the next screen you can select in the {{man label|Options}} view which filter you want to use and whether you want to include Indivuduals, Marriages and Children. Click once again on the {{man button|Forward}} button and you can save the file.
  
 
== Suggestions for filter rules==
 
== Suggestions for filter rules==
 
What you can do with a filter depends on the rules available to you in GRAMPS.
 
What you can do with a filter depends on the rules available to you in GRAMPS.
 
If you have a suggestion for a new usefull filter rule, do a [[How to report bugs|feature request]].
 
If you have a suggestion for a new usefull filter rule, do a [[How to report bugs|feature request]].

Revision as of 15:41, 13 February 2013

What are filters?

Filters

Filtering genealogical information is crucial for research, as well as for creating nice reports. Most reports of GRAMPS allow the use of filters, only displaying information about people that correspond to the filter.

On the other hand, filtered data can be all the info you need, like a self constructed mini-report.

How to define custom filters

Custom filters are relative to the active View. If you are in People View you will create a Person Filter, Event View/an Event Filter, etc. In the Edit menu, click the option <View> Filter Editor.

You can give the custom filter a name and add rules to the filter. The data will be filtered according to the rules.

In some filters you can use regular expressions. For learning how to use regular expressions, see the Regular Expression HOWTO.

Test a custom filter

In the Edit menu, click on Column Editor, and select the columns you want to view. Next, activate Filter. This can be done by going to the View menu, and clicking on Filter.

Examples

See Example filters.

To the right of the list view, a sidebar will open, allowing to filter your data. At the bottom of this, you can select the newly created Custom Filter. Click on Find, and all Persons/ Families/Events/Places/Media/Repositories matching the filter are displayed.

At present (version 2.X), there is no way to print this data.

In the 3.0 version you will have an option Export view on the Family Trees menu. This gives you the opportunity to export the view as a spreadsheet with following format options:

  • CSV
  • Open Document Spreadsheet

Another 3.0 method would be that you select the Export option on the Family Trees menu. An Export Assistant view will be presented where you also can select the Comma Separated Values Spreadsheet (CSV). Next, click on the Forward button and in the next screen you can select in the Options view which filter you want to use and whether you want to include Indivuduals, Marriages and Children. Click once again on the Forward button and you can save the file.

Suggestions for filter rules

What you can do with a filter depends on the rules available to you in GRAMPS. If you have a suggestion for a new usefull filter rule, do a feature request.