Difference between revisions of "Gramps and GEDCOM"

From Gramps
Jump to: navigation, search
(Provide more details about information lost)
(Information in GEDCOM 5.5 not in Gramps (lost on import))
(6 intermediate revisions by 4 users not shown)
Line 1: Line 1:
Gramps uses [[GRAMPS_XML|Gramps XML]] which is considered a superior format to [[GEDCOM]] by the Gramps developers. Although Gramps should be able to import most data from GEDCOM through its GEDCOM Import module, many of the Gramps features are not supported by the GEDCOM standard and so GEDCOM Export from a Gramps Family Tree or Gramps XML is a lossy operation. This page shall list all the information that is lost on a GEDCOM export from Gramps, so that users may choose to restrain their Gramps use to those features that GEDCOM can handle. Gramps recognizes the relevance of GEDCOM and attempts to offer the best compatibility possible. The Gramps version used as a reference is Gramps Trunk, currently Gramps 3.3.  
+
Gramps uses [[Gramps XML]] which is considered a superior format to [[GEDCOM]] by the Gramps developers. Although Gramps should be able to import most data from GEDCOM through its GEDCOM Import module, many of the Gramps features are not supported by the GEDCOM standard and so GEDCOM Export from a Gramps Family Tree or Gramps XML is a lossy operation. This page shall list all the information that is lost on a GEDCOM export from Gramps, so that users may choose to restrain their Gramps use to those features that GEDCOM can handle. Gramps recognizes the relevance of GEDCOM and attempts to offer the best compatibility possible. The Gramps version used as a reference is Gramps Trunk, which at the time was Gramps 3.3.  
  
 
The GEDCOM standard stopped evolving on 10 January 1996. There is a draft for a 5.5.1 version, of which Gramps uses several features as noted below.  
 
The GEDCOM standard stopped evolving on 10 January 1996. There is a draft for a 5.5.1 version, of which Gramps uses several features as noted below.  
 +
 +
The following assumes the standard GEDCOM export utility. However, there is also a set of common extensions that have been bundled together. See [[GEDCOM Extensions]] for more information.
  
 
__TOC__
 
__TOC__
Line 17: Line 19:
 
* '''Source Data''': no equivalent in GEDCOM.
 
* '''Source Data''': no equivalent in GEDCOM.
 
* '''Source on places''': no equivalent in GEDCOM.
 
* '''Source on places''': no equivalent in GEDCOM.
* '''Event Attributes different from age, father age, mother age, cause, agency'''. These other attributes have no equivalent in GEDCOM.
+
* '''Event Attributes different from age, father age, mother age, cause, agency'''. These other attributes have no equivalent in GEDCOM. AGNC and CAUS are exported from Agency and Cause attributes (respectively) of an event. AGE, HUSB:AGE and WIFE:AGE are exported from Age, Father's Age and Mother's Age (respectively) of an event reference. Hence these items of data should be stored in the appropriate place for export.
 
* '''Media Description''': set by user, no equivalent in GEDCOM.
 
* '''Media Description''': set by user, no equivalent in GEDCOM.
 
* '''Reference region of a media reference'''.
 
* '''Reference region of a media reference'''.
Line 42: Line 44:
  
 
== Information in GEDCOM 5.5 not in Gramps (lost on import) ==
 
== Information in GEDCOM 5.5 not in Gramps (lost on import) ==
* Multimedia object in source citation (maybe [[GEPS_023:_Storing_data_from_large_sources|available]] on 3.4?)
 
* EVENT_TYPE_CITED_FROM and ROLE_IN_EVENT in source citation. ''Available on 3.4, see {{bug|2918}}''
 
 
    INDIVIDUAL_RECORD: =
 
        n @<XREF:INDI>@  INDI                          {1:1}
 
          +1 RESN <RESTRICTION_NOTICE>                  {0:1}
 
          +1 <<PERSONAL_NAME_STRUCTURE>>                {0:M}
 
          +1 SEX <SEX_VALUE>                            {0:1}
 
          +1 <<INDIVIDUAL_EVENT_STRUCTURE>>            {0:M}
 
          '''+1 <<INDIVIDUAL_ATTRIBUTE_STRUCTURE>>        {0:M}'''
 
          +1 <<LDS_INDIVIDUAL_ORDINANCE>>              {0:M}
 
          +1 <<CHILD_TO_FAMILY_LINK>>                  {0:M}
 
          +1 <<SPOUSE_TO_FAMILY_LINK>>                  {0:M}
 
          '''+1 SUBM @<XREF:SUBM>@                        {0:M}'''
 
          +1 <<ASSOCIATION_STRUCTURE>>                  {0:M}
 
          +1 ALIA @<XREF:INDI>@                        {0:M}
 
          +1 ANCI @<XREF:SUBM>@                        {0:M}
 
          +1 DESI @<XREF:SUBM>@                        {0:M}
 
          +1 <<SOURCE_CITATION>>                        {0:M}
 
          +1 <<MULTIMEDIA_LINK>>                        {0:M}
 
          +1 <<NOTE_STRUCTURE>>                        {0:M}
 
          +1 RFN <PERMANENT_RECORD_FILE_NUMBER>        {0:1}
 
          +1 AFN <ANCESTRAL_FILE_NUMBER>                {0:1}
 
          +1 REFN <USER_REFERENCE_NUMBER>              {0:M}
 
            '''+2 TYPE <USER_REFERENCE_TYPE>              {0:1}'''
 
          +1 RIN <AUTOMATED_RECORD_ID>                  {0:1}
 
          +1 <<CHANGE_DATE>>                            {0:1}
 
   
 
    INDIVIDUAL_ATTRIBUTE_STRUCTURE: =
 
        n  CAST <CASTE_NAME>                            {1:1}
 
          +1 <<EVENT_DETAIL>>                          {0:1}
 
              etc.
 
   
 
    EVENT_DETAIL: =
 
        n  TYPE <EVENT_DESCRIPTOR>                      {0:1}
 
        '''n  DATE <DATE_VALUE>                            {0:1}'''
 
        n  <<PLACE_STRUCTURE>>                          {0:1}
 
        '''n  <<ADDRESS_STRUCTURE>>                        {0:1}'''
 
        '''n  AGE <AGE_AT_EVENT>                          {0:1}'''
 
        '''n  AGNC <RESPONSIBLE_AGENCY>                    {0:1}'''
 
        '''n  CAUS <CAUSE_OF_EVENT>                        {0:1}'''
 
        n  <<SOURCE_CITATION>>                          {0:M}
 
          +1 <<NOTE_STRUCTURE>>                        {0:M}
 
          +1 <<MULTIMEDIA_LINK>>                        {0:M}
 
        '''n  <<MULTIMEDIA_LINK>>                          {0:M}'''
 
        n  <<NOTE_STRUCTURE>>                          {0:M}
 
 
* individual record, individual attribute structure, some event detail is ignored (as shown above), except for the individual attributes EDUC (Scholastic achievement), NMR (Count of marriages), OCCU (Occupation), PROP (Possessions), RELI (Religious affiliation), RESI and TITL (Nobility title), which are all treated in Gramps as 'events's
 
* Individual record, link to submitter ignored
 
* Individual record, REFN:TYPE ignored (note: REFN, RFN and AFN '''are'' stored as attributes)
 
 
    FAMILY_RECORD:=
 
        n @<XREF:FAM>@  FAM                            {1:1}
 
          +1 <<FAMILY_EVENT_STRUCTURE>>                {0:M}
 
          +1 HUSB @<XREF:INDI>@                        {0:1}
 
          +1 WIFE @<XREF:INDI>@                        {0:1}
 
          +1 CHIL @<XREF:INDI>@                        {0:M}
 
          +1 NCHI <COUNT_OF_CHILDREN>                  {0:1}
 
          +1 SUBM @<XREF:SUBM>@                        {0:M}
 
          +1 <<LDS_SPOUSE_SEALING>>                    {0:M}
 
          +1 <<SOURCE_CITATION>>                        {0:M}
 
          +1 <<MULTIMEDIA_LINK>>                        {0:M}
 
          +1 <<NOTE_STRUCTURE>>                        {0:M}
 
          +1 REFN <USER_REFERENCE_NUMBER>              {0:M}
 
            '''+2 TYPE <USER_REFERENCE_TYPE>              {0:1}'''
 
          '''+1 RIN <AUTOMATED_RECORD_ID>                  {0:1}'''
 
          +1 <<CHANGE_DATE>>                            {0:1}
 
 
* Family record, REFN:TYPE and RIN ignored (note: REFN '''is''' stored as an attribute)
 
 
    SOURCE_RECORD:=
 
        n @<XREF:SOUR>@ SOUR                            {1:1}
 
          '''+1 DATA                                      {0:1}'''
 
            '''+2 EVEN <EVENTS_RECORDED>                  {0:M}'''
 
              '''+3 DATE <DATE_PERIOD>                    {0:1}'''
 
              '''+3 PLAC <SOURCE_JURISDICTION_PLACE>      {0:1}'''
 
            '''+2 AGNC <RESPONSIBLE_AGENCY>                {0:1}'''
 
            '''+2 <<NOTE_STRUCTURE>>                      {0:M}'''
 
          +1 AUTH <SOURCE_ORIGINATOR>                  {0:1}
 
            +2 [CONT|CONC] <SOURCE_ORIGINATOR>          {0:M}
 
          +1 TITL <SOURCE_DESCRIPTIVE_TITLE>            {0:1}
 
            +2 [CONT|CONC] <SOURCE_DESCRIPTIVE_TITLE>  {0:M}
 
          +1 ABBR <SOURCE_FILED_BY_ENTRY>              {0:1}
 
          +1 PUBL <SOURCE_PUBLICATION_FACTS>            {0:1}
 
            +2 [CONT|CONC] <SOURCE_PUBLICATION_FACTS>  {0:M}
 
          +1 TEXT <TEXT_FROM_SOURCE>                    {0:1}
 
            +2 [CONT|CONC] <TEXT_FROM_SOURCE>          {0:M}
 
          +1 <<SOURCE_REPOSITORY_CITATION>>            {0:1}
 
          +1 <<MULTIMEDIA_LINK>>                        {0:M}
 
          +1 <<NOTE_STRUCTURE>>                        {0:M}
 
          +1 REFN <USER_REFERENCE_NUMBER>              {0:M}
 
            +2 TYPE <USER_REFERENCE_TYPE>              {0:1}
 
          '''+1 RIN <AUTOMATED_RECORD_ID>                  {0:1}'''
 
          +1 <<CHANGE_DATE>>                            {0:1}
 
 
* Source record, DATA (EVEN etc.) ignored
 
* Source record, RIN is ignored (Note: REFN and REFN:TYPE '''are''' stored)
 
 
    REPOSITORY_RECORD: =
 
        n @<XREF:REPO>@ REPO                            {1:1}
 
          +1 NAME <NAME_OF_REPOSITORY>                  {0:1}
 
          +1 <<ADDRESS_STRUCTURE>>                      {0:1}
 
          +1 <<NOTE_STRUCTURE>>                        {0:M}
 
          '''+1 REFN <USER_REFERENCE_NUMBER>              {0:M}'''
 
            '''+2 TYPE <USER_REFERENCE_TYPE>              {0:1}'''
 
          '''+1 RIN <AUTOMATED_RECORD_ID>                  {0:1}'''
 
          +1 <<CHANGE_DATE>>                            {0:1}
 
 
* Repository record, REFN, REFN:TYPE and RIN ignored
 
 
    MULTIMEDIA_RECORD:=
 
        n @<XREF:OBJE>@ OBJE                            {1:1}
 
          +1 FORM <MULTIMEDIA_FORMAT>                  {1:1}
 
          +1 TITL <DESCRIPTIVE_TITLE>                  {0:1}
 
          +1 <<NOTE_STRUCTURE>>                        {0:M}
 
          +1 <<SOURCE_CITATION>>                        {0:M}
 
          '''+1 BLOB                                      {1:1}'''
 
            '''+2 CONT <ENCODED_MULTIMEDIA_LINE>          {1:M}'''
 
          +1 OBJE @<XREF:OBJE>@    /* chain to continued object */  {0:1}
 
          '''+1 REFN <USER_REFERENCE_NUMBER>              {0:M}'''
 
            '''+2 TYPE <USER_REFERENCE_TYPE>              {0:1}'''
 
          '''+1 RIN <AUTOMATED_RECORD_ID>                  {0:1}'''
 
 
* Multimedia record, REFN, REFN:TYPE and RIN are ignored
 
* Multimedia record, BLOB is ignored
 
 
    NOTE_RECORD:=
 
        n @<XREF:NOTE>@ NOTE <SUBMITTER_TEXT>          {1:1}
 
          +1 [ CONC | CONT] <SUBMITTER_TEXT>            {0:M}
 
          '''+1 <<SOURCE_CITATION>>                        {0:M}'''
 
          '''+1 REFN <USER_REFERENCE_NUMBER>              {0:M}'''
 
            '''+2 TYPE <USER_REFERENCE_TYPE>              {0:1}'''
 
          '''+1 RIN <AUTOMATED_RECORD_ID>                  {0:1}'''
 
          +1 <<CHANGE_DATE>>                            {0:1}
 
 
* note record, source citation ignored
 
* Note record, REFN, REFN:TYPE and RIN are ignored
 
 
    SUBMITTER_RECORD:=
 
        n @<XREF:SUBM>@  SUBM                          {1:1}
 
          +1 NAME <SUBMITTER_NAME>                      {1:1}
 
          +1 <<ADDRESS_STRUCTURE>>                      {0:1}
 
          '''+1 <<MULTIMEDIA_LINK>>                        {0:M}'''
 
          '''+1 LANG <LANGUAGE_PREFERENCE>                {0:3}'''
 
          '''+1 RFN <SUBMITTER_REGISTERED_RFN>            {0:1}'''
 
          '''+1 RIN <AUTOMATED_RECORD_ID>                  {0:1}'''
 
          +1 <<CHANGE_DATE>>                            {0:1}
 
 
* Submitter record, Mutimedia link is ignored
 
* Submitter record, LANG is ignored
 
* Submitter record, RFN and RIN are ignored
 
  
 +
{{man note|Gramps 4.1 GEDCOM Import|Details of GEDCOM import for Gramps 4.1 are provided in the [[Gramps_4.1_Wiki_Manual_-_Manage_Family_Trees#Importing_data|Gramps 4.1 manual]], '''not here'''}}
  
 +
Details for earlier versions of Gramps.
 +
* Multimedia object in source citation
 +
* EVENT_TYPE_CITED_FROM and ROLE_IN_EVENT in source citation
  
 
[[Category:Documentation]]
 
[[Category:Documentation]]

Revision as of 04:00, 26 May 2015

Gramps uses Gramps XML which is considered a superior format to GEDCOM by the Gramps developers. Although Gramps should be able to import most data from GEDCOM through its GEDCOM Import module, many of the Gramps features are not supported by the GEDCOM standard and so GEDCOM Export from a Gramps Family Tree or Gramps XML is a lossy operation. This page shall list all the information that is lost on a GEDCOM export from Gramps, so that users may choose to restrain their Gramps use to those features that GEDCOM can handle. Gramps recognizes the relevance of GEDCOM and attempts to offer the best compatibility possible. The Gramps version used as a reference is Gramps Trunk, which at the time was Gramps 3.3.

The GEDCOM standard stopped evolving on 10 January 1996. There is a draft for a 5.5.1 version, of which Gramps uses several features as noted below.

The following assumes the standard GEDCOM export utility. However, there is also a set of common extensions that have been bundled together. See GEDCOM Extensions for more information.

Lost information on a GEDCOM export from Gramps

  • Bookmarks
  • Preformatted flag on notes
  • Markup in notes. Most other genealogy programs have markup in notes, but GEDCOM has no support.
  • Roles on events
  • One gender on same sex relation: GEDCOM does not support same sex relation.
  • Children status: GEDCOM only uses child-family relationships, ex: adoption as event not a relation.
  • County County fields in Locations
  • Parish Church Parish fields in Locations
  • Media Attributes: no equivalent in GEDCOM.
  • Source Data: no equivalent in GEDCOM.
  • Source on places: no equivalent in GEDCOM.
  • Event Attributes different from age, father age, mother age, cause, agency. These other attributes have no equivalent in GEDCOM. AGNC and CAUS are exported from Agency and Cause attributes (respectively) of an event. AGE, HUSB:AGE and WIFE:AGE are exported from Age, Father's Age and Mother's Age (respectively) of an event reference. Hence these items of data should be stored in the appropriate place for export.
  • Media Description: set by user, no equivalent in GEDCOM.
  • Reference region of a media reference.
  • Tags: an organizational tool for data analysis. This is not real genealogical data.
  • Shared Events: will generate the same event for each record. On import Gramps tries to merge equal events.
  • Shared Places in events: GEDCOM does not know the concept of sharing places, so places are duplicated in the GEDCOM. On import, Gramps will automatically merge places with the same title and street, so this should be of no influence.
  • Call Name: no equivalent in GEDCOM.
  • Family Nickname: no equivalent in GEDCOM. Use an alternate name.
  • Date on Name
  • Group names: Used by Gramps for sorting.
  • Sort As on names: Used by Gramps for sorting.
  • Alternate Locations: This full data on alternate locations is not exported as GEDCOM has no support for this.
  • Private objects
  • Persian, Islamic, Swedish calendars
  • Dual date and non 31/12 new year
  • Some Gramps' Types (Note, Repository, Repository reference, etc ...)

Information written in other form on GEDCOM export

  • Compound surnames: all name grouping info is present using comma-seperated lists. Using the Extract Information from Names tool, such a GEDCOM can be converted again in grouped names.

Information available in GEDCOM 5.5.1 form

  • Coordinates: Latitude and Longitude use MAP.LONG and MAP.LATI fields of GEDCOM 5.5.1
  • Custom attributes on Person, Family: FACT tag is used of GEDCOM 5.5.1

Information in GEDCOM 5.5 not in Gramps (lost on import)

Gramps-notes.png
Gramps 4.1 GEDCOM Import

Details of GEDCOM import for Gramps 4.1 are provided in the Gramps 4.1 manual, not here

Details for earlier versions of Gramps.

  • Multimedia object in source citation
  • EVENT_TYPE_CITED_FROM and ROLE_IN_EVENT in source citation