Difference between revisions of "Addon:Isotammi addons"

From Gramps
Jump to: navigation, search
(Tools: Import CSV sources does not appear in the menu?)
(Tools)
Line 97: Line 97:
  
 
* {{man menu|[[#Generate_source_citations_from_notes|Tools > Isotammi tools -> Generate source citations from notes...]]}}
 
* {{man menu|[[#Generate_source_citations_from_notes|Tools > Isotammi tools -> Generate source citations from notes...]]}}
* {{man menu|[[#Tools|Tools > Isotammi tools -> Name Editor Tool...]]}}
+
* {{man menu|[[#Name_Editor_Tool|Tools > Isotammi tools -> Name Editor Tool...]]}}
 
* {{man menu|[[#Tools|Tools > Isotammi tools -> Name Merge Tool...]]}}
 
* {{man menu|[[#Tools|Tools > Isotammi tools -> Name Merge Tool...]]}}
 
* {{man menu|[[#Tools|Tools > Isotammi tools -> SuperTool...]]}}
 
* {{man menu|[[#Tools|Tools > Isotammi tools -> SuperTool...]]}}

Revision as of 01:58, 29 July 2021

Gramps-notes.png

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
Unless otherwise stated on this page, you can download this addon by following these instructions.
Please note that some Addons have prerequisites that need to be installed before they can be used.
This Addon/Plugin system is controlled by the Plugin Manager.

Gnome-important.png
Please note this group of addons require an additional step to install.

Follow the installation instructions on this page.

Isotammi Tools menu

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.

Once installed:

  • 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
Available Isotammi addons (Gramps 5.1.3)

Installation

Isotammi addons installation to get started for Gramps 5.1.x go to Gramps preferences (Edit > Preferences) and replace the value of Where to check: with:

https://raw.githubusercontent.com/Taapeli/isotammi-addons/master/addons/gramps52

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:

https://raw.githubusercontent.com/gramps-project/addons/master/gramps52

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

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:

Gramplets:

Rules:

  • Events with an invalid date
  • Events with a valid date

Tool:

  • Generate source references based on more information


Here are brief descriptions of the above extensions:

Gramplets

Isotammi configuration

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.

Fig. .1 Isotammi Configuration

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):

https://raw.githubusercontent.com/gramps-project/addons/master/gramps52

and the Isotammi (the Taapeli repository also on GitHub):

https://raw.githubusercontent.com/Taapeli/isotammi-addons/master/addons/gramps52


Fig. .2 General Preferences (Linux)

The Gramps preferences button opens the preferences, allowing the selected Addons repository to be manually checked.


Dates

Dates Gramplet - detached

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.


Place tool

PlaceTool Gramplet - detached

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

Gramps-notes.png

This article's content is incomplete or a placeholder stub.
Please update or expand this section.


PropertyEditor

Gramps-notes.png

This article's content is incomplete or a placeholder stub.
Please update or expand this section.


Tools

Isotammi Tools menu

Tools are available under the Tools > Isotammi tools -> ... menu.


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) )

Name Editor Tool

Name editor - tool

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.

Usage

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
Use

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 ".
Name type

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.

Editing rules

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.

Please note

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.

Name Merge Tool

Name Merge tool

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.

Usage

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.

Use

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.

Tip

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.

Family Auto Merge Tool

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.


SuperTool

SuperTool

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.


ZipInstall

Gramps-notes.png

This article's content is incomplete or a placeholder stub.
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).

Rules

Gramps-notes.png

This article's content is incomplete or a placeholder stub.
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

Gramps-notes.png

This article's content is incomplete or a placeholder stub.
Please update or expand this section.


Exporter

Gramps-notes.png

This article's content is incomplete or a placeholder stub.
Please update or expand this section.


Isotammi XML export

Exporter for Isotammi XML export

Gramps-notes.png

This article's content is incomplete or a placeholder stub.
Please update or expand this section.


See also

  • Isotammi, the national database of the Finnish Genealogical Society.
  • stk-addons - Additional modules and programs for the genealogy application Gramps.
Gramps-notes.png
Webpage originally duplicated from Isotammi and translated to English and expanded.

Collected 11 May 2021
http://wiki.isotammi.net/wiki/Gramps-laajennukset