Difference between revisions of "Gramps Data Model"

From Gramps
Jump to: navigation, search
m (See also)
m (push Place Enhancements to 5.3)
 
(8 intermediate revisions by 4 users not shown)
Line 8: Line 8:
 
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 in 4.2 to contain a string, language code and date range.  
 
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 in 4.2 to contain a string, language code and date range.  
  
The [[GEPS_045:_Place_Model_Enhancements|Places Model Enhancements]] planned for v5.2 are expected to have deeper changes.  [[GEPS_045:_Place_Model_Enhancements#Documentation|One target for that Gramps Proposal]] includes this documentation.  
+
The [[GEPS_045:_Place_Model_Enhancements|Places Model Enhancements]] planned for v5.3 are expected to have deeper changes.  [[GEPS_045:_Place_Model_Enhancements#Documentation|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.
 
Primary objects are coloured blue.  Secondary objects are coloured black.  The dotted lines enclose object hierarchies that are stored in the database tables.
Line 17: Line 17:
 
== See also ==
 
== See also ==
 
* [[Using database API|Programmer's Introduction to the Gramps database API]]
 
* [[Using database API|Programmer's Introduction to the Gramps database API]]
** [https://gramps-project.org/wiki/images/2/2e/API.svg  UML (svg) diagram for Gramps 4.1.x API]
+
** [https://gramps-project.org/wiki/images/2/2e/API.svg  UML (svg) diagram for Gramps 4.1.x API]<br />[[File:API.svg|3 revisions]] Created using the following command: <code>pyreverse -A -S $HOME/gramps/tree/master/gramps/gen/lib/*.py -o jpeg</code>
 
* [https://sourceforge.net/p/gramps/mailman/message/32882646/ Gramps data model] - discussion
 
* [https://sourceforge.net/p/gramps/mailman/message/32882646/ Gramps data model] - discussion
 
* [[GEPS_013:_Gramps_Webapp#Model_overview|GEPS_013: Gramps Django Webapp:Model overview]]
 
* [[GEPS_013:_Gramps_Webapp#Model_overview|GEPS_013: Gramps Django Webapp:Model overview]]
 
* {{bug|10851}} : Gramps Data Model - Polish Version - Gramps 5.0.0
 
* {{bug|10851}} : Gramps Data Model - Polish Version - Gramps 5.0.0
 +
* More graphs available, see [https://gramps.discourse.group/t/core-classes-in-gramps-gen-lib/2241 posts on discourse].
 +
* [[History_of_Gramps|History of Gramps]]
 +
* [[Database_Formats|Database formats]]
  
 
[[Category:Developers/General]]
 
[[Category:Developers/General]]
 
[[Category:Developers/Reference]]
 
[[Category:Developers/Reference]]
 
[[Category:GEPS]]
 
[[Category:GEPS]]

Latest revision as of 21:38, 17 February 2024

Gramps-notes.png
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:

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 in 4.2 to contain a string, language code and date range.

The Places Model Enhancements planned for v5.3 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.


GrampsDataModel.svg

See also