< Digikam‎ | GSoC2010
Revision as of 19:07, 10 June 2010 by Mghansen256 (talk | contribs) (More properties)


Digikam GSoC 2010 Database Schema Changes

This page is meant to gather ideas and information and the schema changes needed for the three Digikam GSoC projects.

Requirements and Considerations


Whenever possible I would like to preserve upwards compatibility, that is digikam 0.10 - 1.3 should just work with the schema-updated database, even if not using new features.

Non-Destructive Editing

We will store the version history of a file in an XML format in its metadata. The same information need also be stored in the database.

One approach is to take the history, break it into individual steps, groups steps to changesets, and assign a changeset to two images (describing the development between them). This is a relatively complex design requiring at least three tables. Another problem appears when images in the line of history are deleted; then changesets need to be merged. We need a more simple approach that does not break when images in the line of history disappear.

The simplest approach is to store the history XML, starting from the original, for each picture. The XML could be the same as stored in the metadata, containing hints at intermediate versions. But one advantage we have in the database over metadata is keeping track of file identities over changes of filename, file size or unique hash (the database is simply updated in these cases). We must make use of and preserve this advantage for storing changes as well.
Assigning unique ids (UUIDs) to edited images, as already described, can help us here. We can keep a table of imageid, UUID, history XML where the XML only contains UUID hints at files. Whenever filename/size/uniqueHash change, the database is kept up to date.

For fast searching, I propose additionally a thin table about image relations. For each image, all images it relates to, as original or intermediate, are then available fast and this information can be used for search queries.

Face recognition

For face recognition, we need to assign extra information to a tag and to a tag assignment:

For a tag, we want to add information which person is represented, link with the identifier in the face recognition data collected with libface, and ideally refer to this person in the Nepomuk storage (which will, sooner or later but invariably, give full integration with Akonadi, thus addressbook, email, appointments etc.). I suggest a TagProperties table which can contain arbitrary information about a tag.

For a tag assignment, we want now to tag not the picture as a whole but only a certain region of the picture. We cannot yet know if this part will always be a rectangle, so I suggest not to limit ourselves in the schema in this regard. Instead, we can use SVG-style XML or other text to describe the region(s). Similarly to above, I suggest an ImageTagProperties table which can contain arbitrary information about a tag assignment.

Reverse Geocoding

This project can also make use of extra information on a tag, "giving tags a meaning" as it is termed in a long-standing bug report. This includes describing a tag named "Paris" as a City or linking it to the Nepomuk storage (where the Pimo ontology should allow it to be described as a city). A more straightforward option would be to store coordinates along with the tag, and possibly a radius.

Miscellaneous bug reports

Miscellaneous bug reports that request feature which would require changes to the database:

  • 149372 Comments on tags
  • 181708 Fast tags, which are not written to the database
  • 190935 Translations for tags. This would be nice to have, as we could easily make the reverse geocoding look up place names in different languages.
  • 192447 Allow tags to have a meaning.
  • Another idea on nepomuk integration: Maybe the identifier (URI) of the tag used in Nepomuk could be stored in the image as well? This could be used to rename a tag in the database without updating all the images. Since the tags are then also identified by the identifier, displayed and stored tag name can be different. Quite useful when someone marries and changes his/her name (this was requested on the mailing list once).


Image History


uuid TEXT,
history TEXT,);

CREATE INDEX uuid_index ON ImageHistory (uuid); CREATE TABLE ImageRelations (subject INTEGER,

object INTEGER,
type INTEGER);

CREATE INDEX subject_relations_index ON ImageRelations (subject); CREATE INDEX subject_relations_index ON ImageRelations (object); I am pondering whether to use INTEGER or TEXT for the type attribute. If we want a small and concise table, INTEGER seems better currently.


CREATE TABLE TagProperties (tagid INTEGER,

property TEXT,
value TEXT

CREATE INDEX tagproperties_index ON TagProperties (tagid); CREATE TABLE ImageTagProperties (imageid INTEGER,

tagid INTEGER,
property TEXT,
value TEXT

CREATE INDEX imagetagproperties_index ON ImageTagProperties (imageid, tagid); There is deliberately no UNIQUE constraint on (tagid), and (imageid, tagid) respectively, to allow multiple entries per tag or assignment.

Property string Datatype Meaning
dc.title[lang] Text Title in different languages
dc.description[lang] Text Long description of the tag
org.digikam.coordinates geo-url Center coordinate for the tag
org.digikam.geopolygon lat,lon,lat,lon,... Polygon outlining the shape of the tag
org.digikam.libfacetag ? Libkface id, if necessary
org.digikam.databaseonly bool "Database-only" tag which should not be written to images
org.digikam.privatelevel int Specify the level of privacy under which images with this tag should be shown
org.digikam.url URL URL associated with a tag
org.dc.date? date Date associated with a tag
org.digikam.oldtitle[lang] Text Old title of this tag, to be able to correctly recognize this tag in images where the tag was written before it was renamed.
org.digikam.nepomukid URL? Link to nepomuk id of the tag
org.digikam.recognizeid URL? IDs of this tag given by other digikam instances, to make it possible to have the tag recognized when other people create tag ids on their computers, which may have different titles, but refer to the same "thing"
Property string Datatype Meaning
... ... Outline of an area

This page was last edited on 15 June 2010, at 19:58. Content is available under Creative Commons License SA 4.0 unless otherwise noted.