Reports

By submitting periodic reports of a patient’s growth measurements, a reporter can monitor the health of a child over time. Each growth report contains the following information:

Parameter Format Description
patient_id String The patient’s unique identifier.
weight Number The patient’s weight today, in kg.
height Number The patient’s height today, in cm.
muac Number The patient’s mid-upper arm circumference today, in cm.
oedema Y/N Whether the patient has oedema today.

To make a report for an existing patient via SMS, send NUTRITION REPORT <patient_id> W <weight> H <height> M <muac> O <oedema>. If any measurement is not available, you may omit it or send ‘X’ or ‘x’ in its place.

To cancel a patient’s most recent report, send NUTRITION CANCEL <patient_id>.

As an example, the following conversation could occur:

You:      NUTRITION REPORT
RapidSMS: To create a nutrition report, send: NUTRITION REPORT
          <patient_id> W <weight (kg)> H <height (cm)> M <muac (cm)> O
          <oedema (Y/N)>
You:      NUTRITION REPORT zyx-321 W 18.5 H 110 O N
RapidSMS: Thanks Jordan Brown. Nutrition report for Sam Green (zyx-321):
          weight: 18.5 kg
          height: 110 cm
          muac: unknown
          oedema: no
You:      NUTRITION REPORT mno-456 W 15 H 90 M 18 O Y
RapidSMS: Sorry, an error occurred while processing your message:
          Nutrition reports must be for a patient who is registered and
          active.
You:      NUTRITION CANCEL zyx-321
RapidSMS: Thanks Jordan Brown. The most recent nutrition report for
          Sam Green (zyx-321) has been cancelled.

Report Statuses

Reports may have the following statuses:

  • Unanalyzed. This is the default status when a report has been receieved but analysis has not yet been attempted.
  • Incomplete. Analysis failed (partially or completely) because one or more pieces of information was missing:
    • patient sex
    • patient birth date
    • reported weight
    • reported height
  • Suspect. Analysis failed completely, because reported measurements were outside of reasonable bounds.
  • Error. Analysis failed completely, for some other reason. For example, the patient might be old enough that there is no CDC data against which to analyze, or maybe an internal error occurred.
  • Analyzed. Analysis completed in full, and the report has z-scores for weight vs. height, weight vs. age, and height vs. age.

Table Of Contents

Related Topics

This Page