4,862
edits
Changes
m
{{stub}}<!-- mention how to use-->
This The {{man label|Find database loop}} utility allows you to verify if you have ancestral loops in the database.
These tools allow This tool allows you to only modify the records within your Gramps database. If you want to move or rename the files then you need to do it on your own, outside of Gramps. Then you can adjust the paths using this tool so that the media objects store the correct file locations.}}
{{stub}}<!-- add keybindings etc -->
{{stub}}
Clear stub template from locked old user manual page in support of https://gramps.discourse.group/t/gramps-5-1-wiki-manual-stub-eradication/2938
Once the report finishes the {{man label|Name and title extraction tool}} dialog results window will be shown.
{{-}}
The {{man label|Find Possible Duplicate People}} dialog will be shown and you can adjust the following options:
*{{man label|Match Threshold}} : choose between '''Low'''(default), Medium and High from the drop down menu.(Note:This calculates a chance of matching as a floating point number. For each piece of information that matches the chance is increased. If the chance is greater than the threshold then a match is reported. The thresholds are Low=0.25, Medium=1.0 and High=2.0. So with the threshold set to High less matches are expected.)
{{man label|Options}}*{{checkbox|1}} {{man label|Options}} : Enable or disable the use of Use [[Gramps_5.0_Wiki_Manual_-_Gramplets#SoundEx_Gramplet|soundex]] codes }} for matching possible duplicate people. (checkbox checked by default)
The following buttons are present: {{man button|Help}} brings you to this page, {{man button|Cancel}} to stop processing and an {{man button|OK}} button to start processing the data.
In a next step unused IDs' are searched for and assigned.
During this process the tool will examine each ID to see if it looks like it has been 'customized', if it doesn't look like the previous ID format or the default ID format. This might be the case if the user had entered his own text in the ID field for the object when editing it. It might also occur if the third party [[Addon:GetGOV|GetGOV Addon]] or [[Addon:GeoName|GeoName Addon]] has been used, as that tool stores the GOV ID in the ID field. If a 'customized' ID is found, it will ask the user if he really wants to replace the ID. The dialog also allows the user to use the same answer for other customized IDs found.
===<u>Sort Events</u>===
*{{checkbox|1}} {{man label|Search for events}} (checkbox checked by default)
*{{checkbox|1}} {{man label|Search for sources}} (checkbox checked by default)
*{{checkbox|1}} {{man label|Search for citations}} (checkbox checked by default)
*{{checkbox|1}} {{man label|Search for places}} (checkbox checked by default)
*{{checkbox|1}} {{man label|Search for media}} (checkbox checked by default)
[[File:FindDatabaseLoop-dialog-example1-50.png|right|thumb|400px|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} Find possible loop]]
Select this via the menu {{man menu|Tools->Utilities->Find database loop...}} you will get a {{man label|Find database loop}} window. The window has five tabs; {{man label|Gramps_ID}},{{man label|Parent}}, {{man label|Gramps_ID}}, {{man label|Child}}, {{man label|Family ID}}.
[[File:FindDatabaseLoop-dialog-example2-50.png|right|thumb|600px|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} Find possible loop in a complex example]]
In the following complex example, we have multiple ancestral loops :
If we look at the second line, we have :
#We continue with his son : [I0000] Child, Child.
#We continue with his son : [I0001] Father, Father.
#We continue with his son : [I0002] Father, Child2 ==> '''HERE, we have a ancestral loop'''.
{{-}}
To read more about ancestral loops see:
* [https://www.tamurajones.net/FindingAncestralLoops.xhtml Finding Ancestral Loops : Modern Software Experience]
* [http://www.beholdgenealogy.com/blog/?p=1309 Ancestral Loops : Louis Kessler's Behold Blog]
===<u>Media Manager</u>===
[[ImageFile:xxxIntroduction-page-MediaManager-50.png|right|thumb|450px|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} xxxIntroduction - page for "Gramps Media Manager" - Tool wizard]]
The {{man label|Gramps Media Manager}} is a group of four separate tools accessed via a wizard like dialog that you can access via the menu {{man menu|Tools->Utilities->Media Manager...}} which will show the first '''Introduction''' dialog page with the following information on the tools abilities.
{{man note|Introduction|These tools allow This tool allows [http://en.wikipedia.org/wiki/Batch_processing batch operations] on media objects stored in Gramps. An important distinction must be made between a Gramps media object and its file.
The Gramps media object is a collection of data about the media object file: its filename and/or path, its description, its ID, notes, source references, etc. These data '''do not include the file itself'''.
The files containing image, sound, video, etc. exist separately on your hard drive. These files are not managed by Gramps and are not included in the Gramps database. The Gramps database only stores the path and file names.
{{-}}
From the '''Introduction''' page selecting the {{man button|Next}} button (or using the keyboard shortcut {{man key press|Alt|N}}) you will be shown the '''Selection''' page window.
[[ImageFile:xxxSelection-page-MediaManager-default-50.png|right|thumb|450px|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} xxxSelection - page for "Gramps Media Manager" - Tool wizard - default]]
From the '''Selection''' page window select from one the four options the actions you want to take and then select the {{man button|Next}} button:
====Replace substrings in the path====
[[ImageFile:xxxReplaceSubstringSettings-page-MediaManager-default-50.png|right|thumb|450px|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} xxxReplace substring settings - page for "Gramps Media Manager" - Tool wizard - default]]
This tool allows replacing specified substring in the path of media objects with another substring. This can be useful when you move your media files from one directory to another.
====Convert paths from relative to absolute====
[[ImageFile:ConvertPathsFromRelativeToAbsolute-FinalConfirmation-page-MediaManager-FinalConfirmationWindowexample-4050.png|right|thumb|400px450px|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} Final confirmation window - 'Convert paths from relative to absolute':"Final Confirmation" page for "Gramps Media Manager" - Tool wizard - example]]
This tool allows converting relative media paths to the absolute ones. It does this by prepending the base {{man label|Base path for relative media paths:}} as given in the [[Gramps_5.0_Wiki_Manual_-_Settings#General|Edit > Preferences> General ]] tab, or if that is not set, it prepends userthe default [[Gramps_5.0_Wiki_Manual_-_User_Directory|User's directoryDirectory]].
{{-}}
====Convert paths from absolute to relative====
[[ImageFile:xxxConvertPathsFromAbsoluteToRelative-FinalConfirmation-page-MediaManager-50.png|right|thumb|450px|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} xxx'Convert paths from absolute to relative':"Final Confirmation" page for "Gramps Media Manager" - Tool wizard - example]]
This tool allows converting absolute media paths to a relative path. The relative path is relative viz-a-viz the base path as given in the Preferences, or if that is not set, user's directory. A relative path allows to tie the file location to a base path that can change to your needs.
{{-}}
====Add images not included in database====
[[ImageFile:xxxAddImagesNotIncludedInDatabase-FinalConfirmation-page-MediaManager-example-50.png|right|thumb|450px|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} xxx'Add images not included in database':"Final Confirmation" page for "Gramps Media Manager" - Tool wizard - example]]
Check directories for images not included in database, this tool adds images in directories that are referenced by existing images in the database. You will have to import one media item from each sub directory manually. Media Manager does not include sub-directories automatically. All the directory paths shown in the tool will be searched through.
This test tool will create many people showing all different date variants as birth. The death date is created by parsing the result of the date displayer for the birth date. This way you can ensure that dates printed can be parsed back in correctly.
{{-}}
Will dump the statistics for the gender guessing from the first name.
{{-}}
===Generate Testcases for Persons and Families===
[[File:GenerateGenerateTestcases-testcasesdialog-toolGenerateTestcasesForPersonsAndFamilies-dialogTool-4250.png|right|thumb|450px|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} "Generate testcases" dialog - for "Generate Testcases for Persons and Families " - dialogTool - default]]
The testcase generator will generate some persons and families that have broken links in the database or data that is in conflict to a relation.
The {{man label|[[Gramps_5.0_Wiki_Manual_-_Error_and_Warning_Reference#Undo_history_warning|Undo history warning]]}} dialog will be shown and you can either {{man button|Stop}} or {{man button|Proceed with the tool}}.
{{-}}
===Populate Sources and Citations===
[[File:PopulatePopulateSourcesAndCitationsTool-sources-and-citationsdialog-tooldefault-dialog-4250.png|right|thumb|400px450px|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} "Populate Sources sources and Citations citations tool" dialog - dialogdefault]]
This tool generates sources and citations for each source in order to populate the database for testing with significant numbers of sources and citations.
{{-}}
