Gramps Data Model

Gramps data model (v4.1)

Gramps uses the pickle module to serialise object hierarchies and store them in the database.

Details of the pickle module can be found here:

• https://docs.python.org/3/library/pickle.html

Below is a diagram of the Gramps data model (v4.1). As of October 2020, this model is reported to be valid for the v5.1 of Gramps. However, there is a minor `PlaceName` objects change to contain a string, language code and date range.

The Places Model Enhancements planned for v5.2 are expected to have deeper changes. One target for that Gramps Proposal includes this documentation.

Primary objects are coloured blue. Secondary objects are coloured black. The dotted lines enclose object hierarchies that are stored in the database tables.

See also

• Prgrammer's Introduction to the Gramps database API
  • UML (svg) diagram for Gramps 4.1.x API
• Gramps data model - discussion
• GEPS_013: Gramps Django Webapp:Model overview
• 10851 : Gramps Data Model - Polish Version - Gramps 5.0.0