OpenSRP Client Growth Monitoring

OpenSRP Client Growth Monitoring Application

License	The Apache Software License, Version 2.0
Categories	CLI User Interface Monitoring Application Testing & Monitoring
GroupId	org.smartregister
ArtifactId	opensrp-client-growth-monitoring
Last Version	1.0.6
Release Date	Apr 26, 2018
Type	aar
Description	OpenSRP Client Growth Monitoring OpenSRP Client Growth Monitoring Application
Project URL	https://github.com/OpenSRP/opensrp-client-growth-monitoring
Source Code Management	https://github.com/OpenSRP/opensrp-client-growth-monitoring

Download opensrp-client-growth-monitoring

Filename	Size
opensrp-client-growth-monitoring-1.0.6.pom
opensrp-client-growth-monitoring-1.0.6.aar	263 KB
opensrp-client-growth-monitoring-1.0.6-sources.jar	261 bytes
opensrp-client-growth-monitoring-1.0.6-javadoc.jar	261 bytes

How to add to project

Apache Maven

<!-- https://jarcasting.com/artifacts/org.smartregister/opensrp-client-growth-monitoring/ -->
<dependency>
    <groupId>org.smartregister</groupId>
    <artifactId>opensrp-client-growth-monitoring</artifactId>
    <version>1.0.6</version>
    <type>aar</type>
</dependency>

Gradle Groovy

// https://jarcasting.com/artifacts/org.smartregister/opensrp-client-growth-monitoring/
implementation 'org.smartregister:opensrp-client-growth-monitoring:1.0.6'

Gradle Kotlin

// https://jarcasting.com/artifacts/org.smartregister/opensrp-client-growth-monitoring/
implementation ("org.smartregister:opensrp-client-growth-monitoring:1.0.6")

Apache Buildr

'org.smartregister:opensrp-client-growth-monitoring:aar:1.0.6'

Apache Ivy

<dependency org="org.smartregister" name="opensrp-client-growth-monitoring" rev="1.0.6">
  <artifact name="opensrp-client-growth-monitoring" type="aar" />
</dependency>

Groovy Grape

@Grapes(
@Grab(group='org.smartregister', module='opensrp-client-growth-monitoring', version='1.0.6')
)

Scala SBT

libraryDependencies += "org.smartregister" % "opensrp-client-growth-monitoring" % "1.0.6"

Leiningen

[org.smartregister/opensrp-client-growth-monitoring "1.0.6"]

Dependencies

compile (8)

Group / Artifact	Type	Version
com.android.support » appcompat-v7	jar	22.1.1
com.android.support » multidex	jar	1.0.1
com.google.code.gson : gson	jar	2.3
org.apache.commons : commons-csv	jar	1.4
com.mcxiaoke.volley : library	jar	1.0.19
org.smartregister : opensrp-client-core	aar	1.2.3
com.android.support » design	jar	22.2.1
com.github.lecho » hellocharts-android	jar	v1.5.8

Project Modules

There are no modules declared in this project.

TABLE OF CONTENTS

• Introduction
• Features
• Z-Score
• App Walkthrough
• Developer Documentation
  • Pre-requisites
  • Installation Devices
  • How to install

Introduction

This OpenSRP Module/app provides Growth Monitoring (Weight, Height) recording, updating, editing and charting capabilities. It also provides the z-score of a patient from their Growth Monitoring (Weight, Height).

Features

The app has the following features:

1. It enables one to record the current or past Growth Monitoring (Weight, Height)
2. It enables one to edit a patient's Growth Monitoring (Weight, Height) record
3. It enables one to view the patient's Growth Monitoring (Weight, Height) over time on a graph
4. It enables one to view the z-score
5. It enables one to determine a patient's Growth Monitoring (Weight, Height) status from the z-score

Z-Score

The z-score is a score calculated from the Growth Monitoring (Weight, Height) & age of a patient to determine their Growth Monitoring (Weight, Height) status i.e. overweight, underweight, average Growth Monitoring (Weight, Height) ...

This score is calculated using values provided by WHO.

Z-score color codes

Color	Meaning	Appropriate Z-score
Red	Underweight/Overweight	-2 and above OR +2 and above
Green	Good! 👍	Between -2 and +2
Dark Blue	Dangerous Growth Monitoring (Weight, Height)	Over +3 or below -3

You can easily tell the Growth Monitoring (Weight, Height) status by checking the z-score line on the graph and where it falls within the z-score indicators. The z-score line indicators use the same color-codes above

App Walkthrough

The app is easy to use and has five important screens

1. When you open the app, the following page is displayed.

• The Top Section has two buttons:

  • Record Weight Button which enables one to record current or past Growth Monitoring (Weight, Height)

  

  • Weight Graph Button which displays a dialog with the patient's weight-for-age, height-for-age and weight-for-height z-scores plotted in a line graph, (depending on the provided app configurations in the properties file). The specific values are also displayed below the graph. See below screenshot for a weigh-for-age graph.
    

• The Bottom Section displays the last 5 Growth Monitoring (Weight, Height)s recorded in the patient's lifetime.

  • Each row has:

    • The Patient Age eg. 0d
    • The Patient Weight eg. 3.8 unit
    • The Edit Weight Button except the birth Growth Monitoring (Weight, Height) which cannot be changed

    

Configuring charts

By default the library displays the Weight-For-Age graph but for the other 2 charts, that is the Height-For-Age and Weight-For-Height charts, you MUST provide configurations in the app.properties file. Use the following configs to achieve this:

monitor.height=true
monitor.weight.for.height=true

Developer Documentation

This section will provide a brief description how to build and install the application from the repository source code.

Pre-requisites

1. Make sure you have Java 1.7 to 1.8 installed
2. Make sure you have Android Studio installed or download it from here

Installation Devices

1. Use a physical Android device to run the app
2. Use the Android Emulator that comes with the Android Studio installation (Slow & not advisable)
3. Use Genymotion Android Emulator
   • Go here and register for genymotion account if none. Free accounts have limitations which are not counter-productive
   • Download your OS Version of VirtualBox at here
   • Install VirtualBox
   • Download Genymotion & Install it
   • Sign in to the genymotion app
   • Create a new Genymotion Virtual Device
     • Preferrable & Stable Choice - API 22(Android 5.1.0), Screen size of around 800 X 1280, 1024 MB Memory --> eg. Google Nexus 7, Google Nexus 5

How to install

1. Import the project into Android Studio by: Import a gradle project option All the plugins required are explicitly stated, therefore it can work with any Android Studio version - Just enable it to download any packages not available offline
2. Open Genymotion and Run the Virtual Device created previously.
3. Run the app on Android Studio and chose the Genymotion Emulator as the Deployment Target

OpenSRP

Open Smart Register Platform

Versions

Version
1.0.6 Apr 26, 2018
1.0.5 Apr 25, 2018
1.0.4 Mar 27, 2018
1.0.3 Mar 5, 2018
1.0.2 Nov 6, 2017
1.0.0 Oct 3, 2017