Target audience

‍Despite the name, most datimutils functionality can be applied to any DHIS2 instance. Anyone who wants to access DHIS2 data and metadata using the R statistical programming language will benefit from this Bootcamp. To participate in this Bootcamp, participants should have a working knowledge of R and have R installed on a computer. Participants should also have an understanding of the DHIS2 data model, organization units, data elements, indicators, periods, and the Visualizer and Pivot Table apps. Participants do not need to be experienced with the DHIS2 API in order to participate. The target audience for this Bootcamp includes, but is not limited to, analysts, epidemiologists, data scientists and other R savvy data people.

Key skills you will gain

• Log into a DHIS2 instance from R
• Easily query any metadata in your DHIS2 instance
• Facilitate advanced analytics on aggregate data managed in DHIS2
  

Course description 

The team that supports the utilization of historical programmatic data for PEPFAR’s annual target setting process, Country Operational Plans (COP), developed datimutils to make their interactions with the DATIM/DHIS2 API both as performant and as easy to write and understand as possible. For instance the datimutils’  getOrgUnits function can convert an arbitrarily long vector of organization unit UIDs to organization unit names while automatically avoiding the creation of API request strings that are too long for the server to accept. If you regularly use the dplyr package in R, datimutils can be easily nested in mutate statements to recode your metadata. In this course, let the team that developed datimutils show you how the package takes care of much of the heavy lifting when interacting with the DHIS2 API from R.

This Bootcamp will cover important topics including:

• Logging in to a DHIS2 instance from R both from the terminal and R-shiny
• Several supported approaches to query DHIS2 metadata such as organization units and data element groups
• Accessing the full power of the DHIS2 aggregate analytics engine through datimutils’ getAnalytics function  
  

Training highlight

By the end of this Bootcamp you will have built a simple, interactive R-shiny application that uses datimutils to interact with a DHIS2 instance.