[tracker] NMM: Explanation translated to docbook



commit 26f26c398256ddbec3fbe9982c560852c7c5f13f
Author: Ivan Frade <ivan frade nokia com>
Date:   Wed Jan 27 20:40:52 2010 +0200

    NMM: Explanation translated to docbook

 docs/ontologies/nmm/explanation.html |   38 ------------------------
 docs/ontologies/nmm/explanation.xml  |   54 ++++++++++++++++++++++++++++++++++
 2 files changed, 54 insertions(+), 38 deletions(-)
---
diff --git a/docs/ontologies/nmm/explanation.xml b/docs/ontologies/nmm/explanation.xml
new file mode 100644
index 0000000..5d230fb
--- /dev/null
+++ b/docs/ontologies/nmm/explanation.xml
@@ -0,0 +1,54 @@
+<section id="nmm-explanation">
+<title>Description</title>
+<sect2>
+<title>Introduction</title>
+
+<para>This ontology extends NIE (Nepomuk Information Element ontology) and NFO (Nepomuk File Ontology) into the domains of multimedia, including Images, Videos, Music and Radio, and includes a couple of properties to support uPnP sharing.</para>
+
+<para>This ontology replaces/complements NID3 and NEXIF. Those ontologies are a direct map of the respective metadata standards, which makes very difficult to map cleanly other standards (like gstreamer metadata, mp4, ogg, and so on). Besides, those ontologies contain a lot of very low level technical information that is useless to the average user of the desktop.</para>
+
+<para>Our approach in NMM is to keep the minimum properties that make sense for the user, and are present in all (or almost all) specific metadata formats. A profesional photographer (or musician) who needs more fine-grained details for its documents, is free to add also nID3 information or other extensions to the ontology.</para>
+</sect2>
+
+<sect2>
+  <title>Images domain</title>
+
+<para>The core of images in NMM ontology is the class <link linkend="nmm-Photo">nmm:Photo.</link> It is (through a long hierarchy) a <link linkend="nie-InformationElement">nie:InformationElement</link>, an interpretation of some bytes. It has properties to store the basic information (camera, metering mode, white balance, flash), and inherits from <link linkend="nfo-Image">nfo:Image</link> orientation (<link linkend="nfo-orientation">nfo:orientation</link>) and resolution (<link linkend="nfo-verticalResolution">nfo:verticalResolution</link> and <link linkend="nfo-horizontalResolution">nfo:horizontalResolution</link>).</para>
+
+<para>Note that for tags, nie:keywords (from nie:InformationElement) can be used, or the <link linkend="nao-ontology">NAO</link> ontology.</para>
+
+<figure id="nmm-image-graph">
+ <title>Graphical Overview (images domain)</title>
+ <graphic fileref="images-overview.png" format="PNG"></graphic>
+ <para>Notation defined <link linkend="ontology-notation">in this page</link></para>
+</figure>
+</sect2>
+
+<sect2>
+  <title>Music domain</title>
+
+<!-- Dont forget to mention the wa... uPnP -->
+
+<figure id="nmm-music-graph">
+ <title>Graphical Overview (music domain)</title>
+ <graphic fileref="music-overview.png" format="PNG"></graphic>
+ <para>Notation defined <link linkend="ontology-notation">in this page</link></para>
+</figure>
+
+</sect2>
+
+
+<sect2>
+  <title>Radio domain</title>
+<para>NMM includes classes and properties to represent analog and digital radio stations. There is a class <link linkend="nmm-RadioStation">nmm:RadioStation</link> on the <link linkend="nie-InformationElement">nie:InformationElement</link> side of the ontology, representing what the user sees about that station (genre via PTY codes, icon, plus title inherited from nie:InformationElement)</para>
+<para>A <link linkend="nmm-RadioStation">nmm:RadioStation</link> can have one or more <link linkend="nmm-carrier">nmm:carrier</link> properties representing the different frequencies (or links when it is digitial) it can be tuned. This property links the station with <link linkend="nfo-MediaStream">nfo:MediaStream</link>, but usually it will point to one of the subclasses: <link linkend="nmm-DigitalRadio">nmm:DigitalRadio</link> (if digital) or <link linkend="nmm-AnalogRadio">nmm:AnalogRadio</link> (if analog). An analog station has properties as modulation and frequency, while the digial station has streaming bitrate, encoding or protocol.</para>
+<para>Note that nfo:MediaStream refers to a flux of bytes/data, and it is on the <link linkend="nie-DataObject">nie:DataObject</link> side of the ontology</para>
+
+<figure id="nmm-radio-graph">
+ <title>Graphical Overview (radio domain)</title>
+ <graphic fileref="radio-overview.png" format="PNG"></graphic>
+ <para>Notation defined <link linkend="ontology-notation">in this page</link></para>
+</figure>
+
+</sect2>
+</section>
\ No newline at end of file



[Date Prev][Date Next]   [Thread Prev][Thread Next]   [Thread Index] [Date Index] [Author Index]