16,602
edits
Changes
m
== Design specification ==
See [[Place completion tool specification]]
Place/Location is a newer concept in GRAMPS. Many older databases only have a Place title field which is a descriptive text containing city, state, country. To distribute these values into the correct attribute fields, see Parse Title Details below
{{man warn|Warning:|DO NOT BETA TEST WITH YOUR RESEARCH DATA. EXPORT DATA FIRST TO HAVE A BACKUP, THEN RUN THE TOOL}}
no edit summary
{{out of date|page needs to be reworked and maybe split}}
{{man warn|Warning:|DO NOT BETA TEST WITH YOUR RESEARCH DATA. EXPORT DATA FIRST TO HAVE A BACKUP, THEN RUN THE TOOL}}
A tool to bring the places in your GRAMPS Gramps database in accordance with the GRAMPS Gramps requirements: batch add country, county; look-up latitude-longitude; set description (title); ...
There are versions for 3.1, 3.2, 3.3 and 3.4.x, as well as an old version that works with GRAMPS Gramps version 3.0.x or 2.2.5+ ! [[Place_completion_tool#Download|Download]].
== Place Completion tool ==
The general aims are:
*Place/Location is a newer concept in GRAMPSGramps. Many older databases only have a Place title field which is a descriptive text containing city, state, country. This should be parsed to insert the values in the correct attribute fields.
*Latitude and longitude are important to show data on a map. However, doing a look-up of this data on the internet is slow and time consuming. The tool allows to search in the free resources on the net.
*Setting of an attribute of a set of places in one go.
*Conversion of latitude and longitude to a fixed data format. On import one might obtain latitude and longitude in several different formats. A conversion tool to store them all in the same format is useful.
*Construction of a uniform title/description field, from the data in the place object.
== Manual ==
###All in degree notation: use the classical degree notation with degree, minutes and seconds.
###All in decimal notation: use the decimal system to denote lat/lon.
###Correct -50° in 50°S: a much seen error is to use - for the classical degree notation, which is wrong, and which GRAMPS Gramps will not be able to interpret. With this option this error is looked for and corrected.
# A third option is to set attributes of all selected places. You can set the country, state, county, parish, zip/postal code and city attributes of all places in one sweep.
====Part 3. Overview of the results ====
After having entered all data in Part 1 and 2, you click find for GRAMPS Gramps to search all changes that will occur. This part of the dialog shows all changes that will occur.
[[Image:place_completion_tool_results.png]]
== Example ==
Open the example file from the examples where latitude and longitude are empty: [http://grampssvn.svncode.sourceforgesf.net/viewvcp/gramps/*checkout*code/grampsbranches/trunkmaintenance/gramps2gramps34/example/gramps/example.gramps?revision=7186 example.gramps].
We will now show how the places in this file can be completed. The best thing to do is open a new family tree (.grdb), give it a name, and import the example.gramps file. This file has 852 places, which would mean a lot of manual edits if you do not use this tool!
While updating all places in step 2, you will have noticed some errors in the state information: Some places have a dubious state: eg OH-AL
You can obtain these states by choosing ''All Places'' en setting the state search box to '''-'''. Clicking Find will give you all these problem places. You can use google maps or the place dialog to sort them out. You can also use the USA country GeoNames file to search these places in the entire USA. '''Note:You will need sufficient memory for this, or you will obtain a MemoryError (see below)!'''
=== Step 4: Lat/Lon not found ===
Resource: [http://de.wikipedia.org/wiki/Wikipedia:GEOnet_Names_Server GEOnet]
== Design specification ==
*See [[Place completion tool specification]]
Place/Location is a newer concept in Gramps. Many older databases only have a Place title field which is a descriptive text containing city, state, country. To distribute these values into the correct attribute fields, see Parse Title Details below
== Troubleshooting ==
MemoryError</nowiki>
The tool has to load the datafile for latitude/longitude searching into memory. For large files like USA.txt, this might be impossible if you have limited memory. You can try to close as many programs running at together with GRAMPSGramps, and try the tool again.
* global install: <code>place_to_gramps_install/src/plugins</code>
If you use Gramps 3.2 , then you will need [http://gramps-addonssvn.svncode.sourceforgesf.net/viewvcp/gramps-addons/code/branches/gramps32/download/PlaceCompletion.addon.tgz this addon], use the [[3.2_Addons|automatic installation]]. If you use Gramps 3.3 , then you will need [http://gramps-addons.svn.sourceforge.net/viewvc/gramps-addons/branches/gramps33/download/PlaceCompletion.addon.tgz this addon], use the [[3.3_Addons|automatic installation]].
If you use Gramps 3.4 3 , then you will need [http://gramps-addonssvn.svncode.sourceforgesf.net/viewvcp/gramps-addons/code/branches/gramps34gramps33/download/PlaceCompletion.addon.tgz this addon], use the [[3.4_Addons3_Addons|automatic installation]].
If you use Gramps 3.4 , then you will need [http://svn.code.sf.net/p/gramps-addons/code/branches/gramps34/download/PlaceCompletion.addon.tgz this addon], use the [[3.4_Addons|automatic installation]].
==Also==
[[GeoCodes]]
[[Category:Proposed Tool Specifications]]
