This is a Third-party Addon.
Please use carefully on data that is backed up, and help make it better by reporting any comments or problems to the author, or issues to the bug tracker
Please note this group of addons require an additional step to install.
Follow the installation instructions on this page.
This group of addons are designed to help Gramps users make their data compliant to Isotammi project, which is a national database of Finnish Genealogical Society.
- Gramplets are available from the:
- Dashboards add a gramplet right click menu. (Isotammi configuration / Deep Connections Graph / PropertyEditor )
- Events category add a gramplet drop down on the bottombar ( Dates )
- Tools are available under the Tools > Isotammi tools -> ... menu.
- New Rules are available as described below.
- Exporter for Isotammi XML export
- 1 Installation
- 2 Isotammi addons
- 2.1 Gramplets
- 2.2 Tools
- 2.2.1 Generate source citations from notes
- 2.2.2 Name Editor Tool
- 2.2.3 Name Merge Tool
- 2.2.4 Family Auto Merge Tool
- 2.2.5 SuperTool
- 2.2.6 FilterParams tool
- 2.2.7 ZipInstall
- 2.2.8 Import CSV sources
- 2.3 Rules
- 2.4 Exporter
- 3 See also
Click Check for updated addons now and install all shown addons or at least the Isotammi configuration Gramplet.
After downloading the Isotammi addons restore the original value of Where to check: with:
After installation go to Gramps Dashboard and add the Isotammi configuration Gramplet which will allow you to select which source to use for installing addons in the future: Gramps default or Isotammi addons
From the website
Follow the instructions to install the Gramps Isotammi addons associated with the Isotammi project.
So far, the following three gramplets, two rules, and one tool are available:
- Events with an invalid date
- Events with a valid date
- Generate source references based on more information
Here are brief descriptions of the above extensions:
Isotammi configuration Gramplet can be added to the Dashboard to allow you to select from which source the addons are installed e.g. from the default location of Gramps or from the Isotammi addons.
The Addon source radio buttons switches the Where to check URL of the Third party addons management.
The 2 supported Repositories are: the Default location (the Gramps-Project repository on GitHub):
and the Isotammi (the Taapeli repository also on GitHub):
The Gramps preferences button opens the preferences, allowing the selected Addons repository to be manually checked.
The Dates Gramplet is installed in the Events list. It can be used to manipulate event date information, especially to correct dates in the wrong format. First select one or more events to which you want to assign the function and the desired correction function and press Execute. This can be used, etc., with the rule "Events with an invalid date" so that it first generates a filter that looks for invalid dates.
The PlaceTool Gramplet can be used to manipulate multiple location data at once. It can form a hierarchy of places from comma-separated place names, the type of places can be changed, it can be used to move places (e.g., villages) inside the right keeper and to correct systematic typos. PlaceTool can be added to the bottombar in the Places category list view.
Deep Connections Graph
The Deep Relationship Chart graph produces a graphical diagram of the relationships between two people - The chart shows not only the relationships, but also, for example, sponsorships and other events connections through Associations and through links in Notes.
The Deep Connections Graph gramplet for the Dashboard category is the control for controlling a locally hosted, browser interface to charts of the Deep Connections data. It allows a LocalHost server to be created, the current Tree data to be posted. The server has a Form interface to select two Persons and options for diagramming their direct or indirect connection.
Note that many of the error messages (when the server is unable to generate a graph/chart) are in Finnish.
The Property Editor is a Source category gramplet allowing "Search and Replace" mass updates to selected subsets of Source records.
This tool was designed for use within the Isotammi collaborative Finnish genealogy project. It simplifies harmonization and merging of Source records.
Tools are available under the Tools > Isotammi tools -> ... menu.
- Tools > Isotammi tools -> Generate source citations from notes...
- Tools > Isotammi tools -> Name Editor Tool...
- Tools > Isotammi tools -> Name Merge Tool...
- Tools > Isotammi tools -> SuperTool...
- Tools > Isotammi tools -> ZipInstall...
Generate source citations from notes
The Generate source citations from notes tool is a specialized tool that can interpret a source reference obtained from a digital directory or SSHY page, which is stored in Gramps, eg for additional information about an event. The tool then forms the based on the text reference to the source, source, and archive Gramps and deletes the original additional information. The additional information must not contain other text and the source reference must be copied there as it is. The tool processes all additional information in this format at the same time. The SSHY source reference must be retrieved using a special SSHY browser extension (https://addons.mozilla.org/en-US/firefox/addon/sshy-selainlaajennus/ or https://chrome.google.com/webstore/detail/sshy-selainlaajennus/caomdaijfcdopklkecajpkoaiamaegkb) )
The Name Editor Tool standardizes family names in the family tree to eliminate random scribe practices and, to make it easier to find duplicates in the family tree and to merge. For example, Gramps' "MultiMerge" and "Family Auto Merge Tool" work more efficiently the more consistent the nomenclature. In addition, the tool maintains the primary and alternative name types of individuals.
After starting Gramps, the tool can be found in the Isotammi Tools group - The name editing tool lists the people in the family by line, alphabetically by surname and first name, after a short time. At the top left of the list window is a line of text for filtering. Its value targeting can be refined by name parts and gender as well as name type. Regular expressions (regex) can also be used. At the top right of the list window are the editing preferences, which are described in more detail below.
In the list, the person lines are alphabetically by last name and first name. The information in the line is the person's ID in Gramps (Id), gender (M = male, F = female,? = Unknown), surname Prefix, actual Surname, First names, Suffix (contains patro / matrimonial information according to Isotammi's practice), Title (person's Title) and Type (birth, marriage, known, etc.).
The following figure, which filters people with the letter "r" in the list, provides examples of the need to edit. The situation is very typical when the family tree is combined with material from several sources, in which case there is no uniform practice.
- the matronymic should be moved to the Suffix
- suffixes (patronyms and matronyms are mixed in Finnish and Swedish
- patronym is abbreviated (Joh.sson)
- the surname deviates from the recommendation of how to mark the unknown part of the name
- first name and patronymic are the same
If the filter text targets a name part, uncheck the "All" box and check the desired part (s). If gender does not matter, leave the "All" option on it, otherwise the sexual. The Regex box is checked when the corresponding rule is in the "Filter" text. Filtering is started with the "Search" button and the list then contains only the person lines that match the criteria. The "List All" button returns to the unfiltered list.
Practically worth it
- look at rows filtered, e.g., by women’s first names, because then changes to the rows may not be appropriate for men (e.g., “Christ:” can be safely interpreted as a woman’s name, “Christina,” but for men, it would be “Christer” or Christian).
- first take care of the abbreviations of the name parts. For their initial filtering, write "Filter" in the text "Filter", for example ";", ".", ";", ".sson" or other string used by scribes to abbreviate parts of names in the congregation.
- targets conversions to people selected from the list bar. The selection can be made on all rows at once or by picking individual rows. The latter method can be tedious if the original filter selected a large number of rows. This will refine the filtering text (e.g. ":" i.e. select all people's abbreviated first names and patronymics, but "men, first name," Henr: "would only list lines where the first name" Henr: "can be safely decompressed to" Henric ".
Gramps has a number of standardized name types (Birth Name, Avion Name, Known Name, Unknown), in addition to which the genealogist can define his own types (common ones include Military Name, Taken Name, Noble Name, Artist Name). A person can have several names, one of which is selected as the primary and appears in the person list, and the others are set as alternate names. However, each must have a first name and a patronymic and / or surname. See See also Quality Guidelines for Genealogists on naming conventions.
The tool loads all name types in the genealogy from the selection list and rows can be filtered and edited by name type. In the person line of the list, the primary name type is in bold.
At the top right of the list window are fields and buttons for editing. In basic operation, first select the line of the name part to be edited, write the current value ("Old value") and the desired value ("New value"). For example, in men "Joh." in the first name filtered, the current value is written Joh. and the new value Johan.
The edit only affects the rows that are selected in the list. Filtering alone does not select rows!
All rows are selected at once with the key combination CTRL + A.
The replacement affects part of the text. For example, if the first name is "Lars Sim:" and "Sim:" is to be converted to "Simon", write the old value Sim: and the new value Simon. The first name after this is "Lars Simon".
The Regex rule is available by ticking.
Editing can be activated with "Special Functions", the ticking of which opens up possibilities for moving parts of names between them. (examples of use!)
The editing is performed with the "Replace" button. The "Undo previous change" button cancels the last corrections. An incorrect conversion can also be undone by holding the selected rows and performing a counter conversion, e.g. Old = "Henricz"> New = "Henric".
Due to the possibility of cancellation, it is worth learning how to use the tool by boldly trying different variants, eg for one or a few names at a time.
Clicking on the list bar opens the respective personal editor. Point-specific changes can be made to it, i.e. only the modification necessary for the person concerned, such as transfers between the primary and alternative names, the correction of a very rare surname clerical error, or the transfer of a surname that has crept into the patronymic to the surname.
Gender is an integral part of editing. The name editing tool cannot be used to edit genders, but the "NameMerge" and "SetGender" tools are available. When used in advance or interrupted by the Name Editor, interrupting the gender encoding improves the impact of the Name Editor.
The Name Merge Tool standardizes family names by combining the same but slightly differently spelled first or last name names so that the names of the people are in the genealogy for the Genealogist's own use or for the recipients of the genealogy, either as printouts or gedcom transfer files. The merger significantly reduces the name editing work with the Name Update Tool. The Gramps MultiMerge and Family Auto Merge Tool also work more efficiently the more consistent the nomenclature.
Some common first names have been written by parish scribes in dozens of different forms, based on Swedish and German naming practices (e.g. the name family Heikki <Henric, Henrik, Heinrich, Hinnrich, Hindrick, Hen:, ...). The same variegation exists in other parts of the names (e.g., v/w/fv and f/ph spellings have been used). There is a similarity in surnames, especially in the registration of long foreign surnames.
After starting Gramps, the tool can be found in the Isotammi Tools group - NameMerge opens after a short time after thinking about the list of names of all people's first names, with their personal numbers - at the top of the list window there are gender selections,
The list shows the relevant part of the name and gender in alphabetical order. If the same part of the name has known and unknown genders, the same form of name is in the list of two, followed by the number of persons in the cases in question.
At the top is the "Set gender" checkbox, which automatically updates the gender in the merger for each person involved in the merger, if there is a single case of gender that is known to be merged.
To merge names from a list, follow these steps:
To be merged, left-click and CTRL + left-click the last name in successive names. Discontinuous names can be selected and canceled with the left mouse click of SHIFT + - you can remove the name from the selected ones with the left mouse click of SHIFT + (a good way if there are non-merged names among the ones selected in succession)
The merge is performed with the MERGE button at the top. The merge is canceled by selecting Gramps Edit> Cancel. In the picture, three "Adolf" name spellings are selected and the Merge button is pressed. The tool suggests the form with the most people as the primary one.
The Merge button opens a new window Select primary name ". Where the desired name format is selected as the primary (eg" Adolf "e instead of Adolph" in the figure). When you double-click the merged person after merging, the "Show person" window opens, listing all the people involved in the merger. When you select a person from the list, their Personal Edit window can be opened with the Open button.
In the main Gramps window, the cursor moves in the People list. to the selected person, in which case you can open the person's Relationships window (if necessary, remove the filter from the list and the transfer will take place). This is useful if, for example, the person's first name contains information about his or her parents. In this case, it is not possible to form family relationships automatically when forming huskies. Parents can be corrected in the Relationships window. Note that the most direct way to add parents is to select "add a child to an existing family" using the father's or mother's last name as the search key.
After merging, only the selected primary name format, the number of people and the set gender remain in the tool list.
There are cases at the end of surnames that require other means than merging surnames. The following image shows a few examples of these:
- The last name starts with a lowercase letter (e.g. "barck"). If the number is small, the fastest way is to select the last name from the list, open the person for editing with a right-click and correct the last name directly in the person's name.
- The part of the prefix left in the surname (eg "d." In the name "d. Pahlen") is corrected as above.
- The surname contains information about its type (e.g. "eine geborene", "f.", "Född"). The first, rare situation is corrected as above. There are usually dozens of the latter cases. The correction is made with the "Name Editor" tool at once, replacing the text "F." Or "Född" with the last names. Note that the text to be replaced includes a space and that the text is replaced by leaving the new value blank.
The tool is intended for cleaning the parish's Hiskipuut stock. The tool merges the children of the parents into one family and adds a Marriage event to the family. Only parents whose names are in exactly the same form in the marriage and baptismal events of Hezekiah are directly interpreted as the same family. The tool records how many connected families it formed. The efficiency of the tool can be improved by using the Name Merge Tool and Name Editing tools mentioned above.
The next step is the researcher's own judgment. Family reunion continues in Gramps Families view. It is first sorted by the name of the husband, after which it is easy to identify the families left behind by the tool due to small differences in the name of the wife joining. Merging families in a view is done two at a time with Gramps' "Merge" tool or "Multimerge" tool for merging multiple families at once.
Once the men have been dealt with, the Families list is further sorted by wife's name, allowing families with small differences in husband's names to be combined accordingly.
In the Gramps interface, you should add the "Kids" tab to the Bottom bar and the "Events" tab to the Sidebar. They can be used to check that there are no visible flaws in the reunited family, e.g., the children have too long a time interval or the marriage event does not fit the children’s time. These are signs that unrelated families or children have been merged into the same family.
This is a general purpose scripting tool that can be used to do "ad-hoc" queries against a Gramps family tree/database. The queries are expressed in the Python programming language so the tool is most useful for programmers. But the intent is also that the tool is easy enough to allow regular Gramps users to make use of it. The queries can be saved as script files that a user can then load into the tool without necessarily understanding the details.
This tool works in the Gramps versions 5.x and later. It will be installed in the "Isotammi tools" submenu under the Tools menu.
The tool allows arbitrary Python code so it can also be used to modify the database.
For instructions on how to use this tool please visit the SuperTool - Instructions on Github.
- Generic DB Access lib (AKA libaccess) addon - an experimental library that provides generic access to the database and the gen.lib interface(AKA The core library of Gramps objects ).
Currently in beta.
Please update or expand this section.
Please update or expand this section.
Import CSV sources
The "Import CSV sources" Tool is a specialized tool that can load Gramps sources from a csv file. For each line of the file, the tool generates an Archive (optional, source, Additional source-related Information (optional) and Property (optional) for Gramps.
The tool is installed in the Gramps Tools> Isotammi tools folder.
The tool is fed with a .csv file that reads the information under the following column headings: - title (pakollinen) - author - abbrev - pubinfo - repository - ....
Names should be written exactly like that, in lower case. The order of the columns does not matter and not everyone needs to be used. Other columns are ignored.
Each line is made a new source and given a sequential id numbering (S0001, S0002, etc.). Therefore, any gramps-id information in the file is not used. If there are already sources and archives in the database, duplicate id values may become available (but they can be renumbered later with Tools> Family Tree Processing> "Rearrange Gramps IDs to Select Source and Archive Items)
The contents of the columns title, author, abbrev, and pubinfo are stored as is in the source.
The Repository column has special handling:
- The repository can be empty, so the source is not attached to any archive.
- If the column contains an id in square brackets (format [Rxxxx]), then the source is appended to the corresponding archive if it is already in the database. If. archive does not exist, a new archive named "[Rxxxx]" is created and the source is attached to it.
- If there is another value in the column, it is interpreted as an archive name, creating a new archive with that name and appending the source to it. However, if the same name is used multiple times, the tool only creates one archive. If the name is already in a position in an existing archive, the tool cannot associate the new name with it (this can be corrected later by merging the archives in question).
Please update or expand this section.
Events with an invalid/valid date
Events with an invalid date/Events with a valid date are rules that can be used to search for events with incorrect dates. These are not exactly opposites of each other, as the event may also lack date information, in which case it does not match either rule.
Generic <Object> filter
Please update or expand this section.
Please update or expand this section.
Isotammi XML export
Exporter for Isotammi XML export expands the options available compared to the builtin Gramps XML (family tree) export(er).
Choose Menu Family Trees ->Export... then select Next and select Isotammi XML export then select Next and choose the file format specific export options you want to use and then select Next to choose your filename and location and output the file.
File format specific export options
Listed underneath the "Filters and privacy" section you have the following file format specific export options:
- Use Compression
- Include media
- Description: adds a user description to the output file.
- Material type - describes the internal annotation in the header of the export file. Used by the Isotammi project's automated processing tools to correctly route the data into their master database.
- Family tree
- Place Data
- Hiski Tree - HisKi project includes lists of christenings, marriages, burials and moves for most Finland parishes - HisKi is a portmanteau of the finnish term "historiakirjat" (in english, "historical parish books"). HisKi Trees are isolated branches related to a single citation processed by members of the Genealogical Society of Finland. (In their project, if a parish book has separate citation worthy entries for a christening, marriage and funeral; then there might be 3 duplicate Persons and duplicates for each unique associated person in the citation. Merging is processed as a separate operation from data entry.)
Please update or expand this section.
Using any of these options adds the following unsupported section entries to Gramps XML output:
<isotammi> <researcher-info> </researcher-info> <material_type>Family Tree</material_type> <user_description> This is my family tree test with Isotammi addons </user_description> </isotammi>
- Isotammi, the national database of the Finnish Genealogical Society.
- stk-addons - Additional modules and programs for the genealogy application Gramps.
- Search Matt's Gramps Addon List for Isotammi contributions.
Webpage originally duplicated from Isotammi and translated to English and expanded.
Collected 11 May 2021