------------------------------------------------------------
revno: 1045
committer: Lars Helge Øverland <larshe...@gmail.com>
branch nick: dhis2-docbook-docs
timestamp: Tue 2014-04-22 22:28:40 +0200
message:
Indicator org unit group counts docs
modified:
src/docbkx/en/dhis2_user_man_indicators.xml
src/docbkx/en/resources/images/maintainence/indicator_numerator_denominator.png
--
lp:~dhis2-documenters/dhis2/dhis2-docbook-docs
https://code.launchpad.net/~dhis2-documenters/dhis2/dhis2-docbook-docs
Your team DHIS 2 developers is subscribed to branch
lp:~dhis2-documenters/dhis2/dhis2-docbook-docs.
To unsubscribe from this branch go to
https://code.launchpad.net/~dhis2-documenters/dhis2/dhis2-docbook-docs/+edit-subscription
=== modified file 'src/docbkx/en/dhis2_user_man_indicators.xml'
--- src/docbkx/en/dhis2_user_man_indicators.xml 2014-04-08 04:59:31 +0000
+++ src/docbkx/en/dhis2_user_man_indicators.xml 2014-04-22 20:28:40 +0000
@@ -6,7 +6,7 @@
<screenshot>
<mediaobject>
<imageobject>
- <imagedata width="100%" fileref="resources/images/maintainence/data_element_main.png" format="PNG"/>
+ <imagedata fileref="resources/images/maintainence/data_element_main.png" format="PNG"/>
</imageobject>
</mediaobject>
</screenshot>
@@ -25,7 +25,7 @@
<screenshot>
<mediaobject>
<imageobject>
- <imagedata width="80%" fileref="resources/images/maintainence/indicator_maintenance_main.png" format="PNG"/>
+ <imagedata fileref="resources/images/maintainence/indicator_maintenance_main.png" format="PNG"/>
</imageobject>
</mediaobject>
</screenshot>
@@ -51,7 +51,7 @@
<screenshot>
<mediaobject>
<imageobject>
- <imagedata width="70%" fileref="resources/images/maintainence/indicator_add.png" format="PNG"/>
+ <imagedata fileref="resources/images/maintainence/indicator_add.png" format="PNG"/>
</imageobject>
</mediaobject>
</screenshot>
@@ -86,11 +86,13 @@
<screenshot>
<mediaobject>
<imageobject>
- <imagedata width="80%" fileref="resources/images/maintainence/indicator_numerator_denominator.png" format="PNG"/>
+ <imagedata fileref="resources/images/maintainence/indicator_numerator_denominator.png" format="PNG"/>
</imageobject>
</mediaobject>
</screenshot>
- <para>Essentially, an indicator is a formula that can be composed of multiple data elements, constant factors, and mathematical operators. In order to define a new indicator proceed with the following steps. </para>
+ <para>Essentially, an indicator is a formula that can be composed of multiple data elements,
+ constants, organisation unit group counts and mathematical operators. In order to define a
+ new indicator proceed with the following steps. </para>
<orderedlist>
<listitem>
<para>A description of the numerator/denominator must be provided in the "Description field". This should provide a clear description of the numerator/denominator. This field is required.</para>
@@ -105,9 +107,40 @@
<para>Follow the same procedure in order to define the denominator. </para>
</listitem>
</orderedlist>
+ <para>The components of an indicator formula are listed below.</para>
+ <itemizedlist>
+ <listitem>
+ <para>Data elements: Will be substituted by the data value captured for the data
+ element.</para>
+ </listitem>
+ <listitem>
+ <para>Constants: Constants are numerical values which will remain the same for all
+ indicator calculations. This is useful in order to have a single place to change values
+ that might change over time.</para>
+ </listitem>
+ <listitem>
+ <para>Days: A special operator "D" is available in formulas. This operator will
+ always provide the number of days for a given indicator calculation. As an example, if
+ you wish to calculate the "Percentage of time vaccine refrigerator was
+ non-functional", you could define the numerator as ("D-"Number of days
+ vaccine refrigerator was available"")/"D". For example, if the
+ fridge was available 25 days in June, the indicator would be calculated as
+ (30-25/25)*100=17%. If you were however to calculate the total for Quarter 1, the number
+ of days ("D") would be equal to 31+28+31=90. Thus, the "D" paramater
+ will always be the number of days in the period of interest.</para>
+ </listitem>
+ <listitem>
+ <para>Org unit group counts: Org unit groups can be utilized in formulas and will be
+ substitued by the number of organisation units in the group. During aggregation, the org
+ units in the group will be intersected with the part of the org unit hierarchy being
+ requested. As an example, this lets you use the number of public facilities in a
+ specific district in indicators. This is useful e.g. when creating facility
+ infrastructure surveys and reports.</para>
+ </listitem>
+ </itemizedlist>
<note>
- <para>Indicators may make use of constants. Constants are numerical values which will remain the same for all indicator calculations.</para>
- <para>A special operator "D" is also available. This operator will always provide the number of days for a given indicator calculation. As an example, if you wish to calculate the "Percentage of time vaccine refrigerator was non-functional", you could define the numerator as ("D-"Number of days vaccine refrigerator was available"")/"D". For example, if the fridge was available 25 days in June, the indicator would be calculated as (30-25/25)*100=17%. If you were however to calculate the total for Quarter 1, the number of days ("D") would be equal to 31+28+31=90. Thus, the "D" paramater will always be the number of days in the period of interest. </para>
+ <para>Indicators may make use of constants. </para>
+ <para/>
</note>
</section>
<section id="indicatorType">
@@ -118,7 +151,7 @@
<screenshot>
<mediaobject>
<imageobject>
- <imagedata width="50%" fileref="resources/images/maintainence/indicator_type.png" format="PNG"/>
+ <imagedata fileref="resources/images/maintainence/indicator_type.png" format="PNG"/>
</imageobject>
</mediaobject>
</screenshot>
@@ -140,7 +173,7 @@
<screenshot>
<mediaobject>
<imageobject>
- <imagedata width="80%" fileref="resources/images/maintainence/indicator_group_sets.png" format="PNG"/>
+ <imagedata fileref="resources/images/maintainence/indicator_group_sets.png" format="PNG"/>
</imageobject>
</mediaobject>
</screenshot>
=== modified file 'src/docbkx/en/resources/images/maintainence/indicator_numerator_denominator.png'
Binary files src/docbkx/en/resources/images/maintainence/indicator_numerator_denominator.png 2014-02-12 05:31:07 +0000 and src/docbkx/en/resources/images/maintainence/indicator_numerator_denominator.png 2014-04-22 20:28:40 +0000 differ
_______________________________________________
Mailing list: https://launchpad.net/~dhis2-devs
Post to : dhis2-devs@lists.launchpad.net
Unsubscribe : https://launchpad.net/~dhis2-devs
More help : https://help.launchpad.net/ListHelp
