fighting malnutrition with sms and django

Fighting Malnutrition with SMS and Django

Andy McKayclearwind consulting

[email protected]@clearwind

mailto:[email protected]


clearwind consulting

Lots of Plone sitesWrote book


Prinicpal of ClearwindBeen doing Python for about 9 yearsco-founder of Enfold Systems


existing project


rapidsms


Schuyler ErleMatt Berg

Adam McKaigand others...


deployment help?


4 days, 32 hours flight...


and yes this area is home to a certain famous family....


health care workers

for community health care workers in the field

large number of children to look after

in village (not in clinics)


identify and helpsometimes not easy to spot malnurished kids

maybe no records

let other people know the kid needs help

parents sometimes have enough trouble feeding rest of the family


disclaimerI am not a health careworked or related to development

i know the techy bits

can't speak about efficiency of the program


Robbed of vital nutrients as children, they grow up stunted and sickly, weaklings in a land that still runs on manual labor.

http://www.nytimes.com/2006/12/28/world/africa/28malnutrition.html






muacmid upper arm circumfrence

Matt Berg

children

muac


worker

django

sms


children worker

muac

clinic

sms


django

sms

children worker

muac


spomskyd

serial


spomskyd

django route

http

serial


since then spomskyd has been replaced by pygsm

pygsm do a lot of work sorting out all those sms quirks

pygsm

django route

http

serial


custom ui

pygsm

django route

http

serialworkers

django runserver


Note: test data


admins

admincustom ui

workers

django runserver

pygsm

django route

http

serial


7654321 > +26 105 d v f

child 26 MUAC 105diarrheoavomitingfever


7654321 > +26 105 d v f

7654321 < MUAC> SAM+ Patient requires IMMEDIATE inpatient care. +26 MADISON, M, F/4 (Sally). MUAC 105 mm, Diarrhea, Fever, Vomiting


7654321 > +26 105 d v f

7654321 < MUAC> SAM+ Patient requires IMMEDIATE inpatient care. +26 MADISON, M, F/4 (Sally). MUAC 105 mm, Diarrhea, Fever, Vomiting

7654322 < @jdoe reports +26: SAM+, MUAC 105 mm, Diarrhea, Fever, Vomiting


malaria


7654321 > mrdt +34 y n f

malaria rapid diagnosis

child 34y has malarin has no bednetf has a fever


7654321 > mrdt +34 y n f

7654321 < MRDT> Child +34, MADISON, Molly, F/12m has MALARIA. Child is less than 3. Please provide 1 tab of Coartem (ACT) twice a day for 3 days


Matt Berg


flew back


sleptmoved houseslept, slept

http://www.flickr.com/photos/chris_gin/2388032929/sizes/l/




technical details

some of these are based on later work for Malawi

talk about a few of the bits i worked on

interesting


rapidsms


from rapidsms.message import Message

message.text

message.person

message.send()

message.respond(text)

message.forward(identity, text=None)

rapidsms api


decorator for routing


# Register a new patient

@keyword(r'new (\S+) (\S+) ([MF]) ([\d\-]+)( \D+)?( \d+)?( z\d+)?')

@authenticated

def new_case (self, message,...[snip]):

# Do something with the new patient


i like urls.py


1. see what's going where2. route to different

its a django standard, more friendly for other users

easier to change sms without having to change the code


urlpatterns = patterns('',

(r'^new (.*)', "apps.mctc.views.joining.new_case"),

)despite the name, url patterns can be used for more than just urls


try:

callback, args, kwargs = resolver.resolve(message.text.lower())

except Resolver404:

message.respond(_("Unknown command: %(msg)s...) % {"msg":message.text[:10]})


form handling


full of checkingcode, views were full of checking and validation

in django this is done by forms


parse string into form


# NEW 70 1201 M 19102008 123124124

class NewForm(Form):

child = StringField(valid="(\d+)")

gmc = StringField(valid="(\d+)")

sex = GenderField()

dob = DateField(format="%m%d%Y")

contact = StringField(valid="(\d+)", required=False)


class based viewshttp://www.slideshare.net/simon/classbased-views-with-django

http://github.com/andymckay/django-reusable-tables/tree/master





class based view that does repetitive work→ validate form→ process form→ what to do if it goes wrongsubclassed for different country (eg. Malawi)


class MalawiNew(New): @authenticated def post_init(self): self.form = NewForm def pre_process(self): # malawi specific request years, months = years_months(self.form.clean.dob.data.strftime.data) if years > 5: raise FormFailed, "You have attempted to register child #%s. However, "\ "the date of birth entered is %s. The age of this "\ "child is above 5 years. Please resend SMS with corrected "\ "age." % (self.form.clean.child.data, self.form.clean.dob.data.strftime("%m.%d.%Y")) def post_process(self): if self.form.clean.contact.data: self.data.case.mobile = self.form.clean.contact def error_already_exists(self): # malawi specific code return "You have attempted to register child #%s in %s GMC. However, this child already exists. If this is an error, please resend SMS with correct information. If this patient is new or a replacement, please use the EXIT command first, then re-register." % (self.form.clean.child.data, self.data.provider.clinic.name)


testing


tests really matter


test_05_cancelling = """

1234567 > REPORT 70 25.2 95.5 13.5 N Y

1234567 < Thank you Mariam Coulibaly for reporting child #70, weight = 25.2 kg, height = 95.5 cm, MUAC = 13.5 cm, no oedema, yes diarrhea...[snip]

1234567 > CANCEL 70

1234567 < Report for 70 cancelcel...[snip]"""

brillianty done format

allows easy reading bynon technical users


reusable tablehttp://github.com/andymckay/django-reusable-tables/tree/master






Note: test data


liking it less


register("case", Case, [ ["Id", "ref_id", "{{object.ref_id}}"], ["Name", "last_name", "{{object.first_name}} {{object.last_name}}"],...[snip]

])


what challenges?


another framework?

designed for a non-technical audience

as a techy that can be annoying, eg settings.py

if you just want to speak to SMS and nothing else, maybe better way to go


not enough timeschuyler, adam, matt


infrastructure

this is the pavement in the main street


We have over 5000 kids in the system now and counting. It's been used to catch over 100 kids with malnutrition and about 400 with malaria.

Matt Berg


thank you, django


volunteers wanted

5-10Hour projects we would love volunteer help with


more infowww.rapidsms.org/rapidresponse

[email protected]

http://www.rapidsms.org/rapidresponse

http://www.rapidsms.org/rapidresponse




questionsAndy McKay

clearwind [email protected]

@clearwind



fighting malnutrition with sms and django

Technology

clearwind consulting

clearwind consulting

clearwind consulting

clearwind consulting

clearwind consulting

clearwind consulting

clearwind consulting

clearwind consultingclass