Gedcom Map Program – "PrepMaps" Preparing tsv-files for interactive Online Maps from ged-files Table of Content 1 Main Screen ..................................................................................................................................................... 3 1.1 Functionality ............................................................................................................................................ 3 1.2 Prerequisites ............................................................................................................................................ 4 1.3 Description............................................................................................................................................... 4 1.3.1 Program sequence ........................................................................................................................... 4 1.3.2 Definition file (mmsd-file) ................................................................................................................ 5 1.3.3 Program start by command line ...................................................................................................... 5 1.3.4 Search criteria .................................................................................................................................. 6 1.3.5 Options ............................................................................................................................................ 6 1.3.6 Selection of the Databases .............................................................................................................. 7 1.3.7 Buttons ............................................................................................................................................ 8 1.3.8 Tab "Options / Header line tsv-file" ................................................................................................ 8 1.4 Method for compression ......................................................................................................................... 9 1.5 Extract from a log file ............................................................................................................................ 10 2 Appendix ........................................................................................................................................................ 11 2.1 Copyrights, License agreements, Program error and others ................................................................ 11 2.2 Setup of the tsv-file ............................................................................................................................... 11 2.2.1 File name ....................................................................................................................................... 11 2.2.2 Description of the columns ........................................................................................................... 11 2.2.3 Examples of tsv-files ...................................................................................................................... 13 2.3 Processable MAP + _GOV Structures of ged-files ................................................................................. 14 2.3.1 Standard Structure ........................................................................................................................ 14 2.3.2 "_LOC – Records" ........................................................................................................................... 14 2.3.3 "0 _PLAC" ....................................................................................................................................... 14 2.3.4 "0 _PLAC_DEFN" ............................................................................................................................ 14 2.3.5 Programs without MAP, LATI, LONG and _GOV ............................................................................ 14 2.4 Characteristics of the databases ........................................................................................................... 15 2.4.1 CompGen DB ................................................................................................................................. 15 2.4.2 TNG DB........................................................................................................................................... 15 2.4.3 Webtrees DB .................................................................................................................................. 15 2.4.4 Geneanet DB .................................................................................................................................. 15 2.4.5 OFB Type 3 ..................................................................................................................................... 15 Diedrich Hesmer 31.12.2020 Seite 1 von 15 Gedcom Map Program – "PrepMaps" Changes to the last issue highlighted in yellow. Diedrich Hesmer 31.12.2020 Seite 2 von 15 Gedcom Map Program – "PrepMaps" 1 Main Screen 1.1 Functionality This program helps to show genealogists graphically on a world map • Where do our ancestors come from? • Where are their descendants? It creates up to 8 tsv files from a ged file, which must be UTF-8 encoded, to create interactive maps with OpenStreetMap background or Google Maps to be integrated into the own website. There, markers are placed in each location found and the frequency of the respective surnames can be displayed. The ged files must therefore include the coordinates specified by the tags MAP with LATI and LONG. If these data are missing, they can be supplemented with the Map program ModPlac. A linking of the persons to the following databases is possible: • CompGen DB: OFB data of "ofb.genealogy.net"1 or • TNG2 DB: private databases on external or internal server or • Webtrees DB: private databases on external or internal server or • Geneanet DB: private databases on external server or • OFB Type 3: directory of the html files of OFB type 3 report on external server or • No DB: processes the data without link to a person DB In all cases, a link to the CompGen GOV data of "gov.genealogy.net"3 is possible. 1 OFB: Online Heritage Books, a project of the "Society for Computergenealogy, e.V." (CompGen) 2 TNG: The Next Generation of Genealogy Sitebuilding, a genealogy software running as a web application 3 GOV: Historic Gazetteer, a project of the "Society for Computergenealogy, e.V." (CompGen) Diedrich Hesmer 31.12.2020 Seite 3 von 15 Gedcom Map Program – "PrepMaps" The ancestors and/or descendants of an individual or a group of persons born in a specified place within a defined period are selected and transmitted in compressed form. All INDI and FAM records are evaluated for this purpose. The surnames with a key date are listed for each location found. For the ancestors, the most distant date is displayed. The most recent date is shown for the descendants. The main difference between the maps that can be created with the tsv files and a local family book is the assignment of where the persons came from and where they moved to. This results in a completely different point of view. You can sees which surnames are found from or up to a date at this place. This in extension with the surrounding places forms an unusual perception of the own data. Example maps with OpenStreetMap: Example maps with Google Maps: German http://krasna-o-de.otto-riehl.de German http://krasna-g-de.otto-riehl.de English http://krasna-o-en.otto-riehl.de English http://krasna-g-en.otto-riehl.de For details, see the report "Serving Online Maps with PrepMaps" from Otto Riehl. An exemplary application may be found here for Krasna, a colony with German inhabitants in Bessarabia. Both are accessible by the Homepage. All examples are based on links to CompGen databases. During the process, a log file is created that can be opened with any text editor. The log file has the name of the ged file, extended by "_pm" and the file extension ".log" and is stored in the directory of the ged file. 1.2 Prerequisites For the output, only persons will be taken into account, who are containing in the ged-file: • information of date of birth, christening, death or burial and additionally • location data (PLAC) with their coordinates (MAP.LATI/LONG) Persons with the entry "DEAT Y" and a PLAC text are also included, even without a date. See paragraph "Processible MAP + _GOV structures of ged files" on page 12 for details of the programs concerned. It is also necessary that the INDI ID in the linked DB is the same as in the ged file, as these are used as the key field for linking. Without this, no link from the map to the person is possible. Without this, no link to the person is possible from the map. See also the notes in the appendix at 2.4 "Characteristics of the databases" on page15. This means for the respective ged file: • CompGen DB: It must be the same as the one loaded to " ofb.genealogy.net". • TNG DB: It must be exported from TNG. • Webtrees DB: It must be exported from Webtrees. • Geneanet DB: A ged file exported from Geneanet cannot be used because it contains neither MAP nor _GOV. More details in the appendix. • OFB Type 3: It must be the same as the one used by the OFB. 1.3 Description The following describes the program sequence, the mmsd definition files, the search criteria, the options, the effect of the buttons, the logic and the log file. 1.3.1 Program sequence After