Skip to content

epicentre-msf/outbreak-tools

Repository files navigation

Quickly build a linelist from an excel designer 🐌

Download All Download All Dev Download Latest version of setup file

How it works?

In three steps:

1- Download the setup file and add the configurations of your linelist in it. The setup file is basically an excel file with sheets referring to differents configurations to take in account when bulding the linelist. Remember to check the setup for eventual errors before importing it in the designer.

2- Use a geobase related to your linelist. You can choose to generate a linelist without a geobase which is optional. You can also import a geobase in the created linelist if you want.

3- Feed the designer with a valid setup file (a setup file without errors in it) with/without a geobase and it generates a linelist using the configurations you have defined.

For more informations about the setup, please browse elements of the setup repository, read the setup wiki or browse the outbreak-tools showcase repo.

The linelist designer requires Excel >= Excel 2010 and works on both Windows and Mac operating sytems.

Automation

Automation of the work can be done on R (only works on a windows machine) using the provided R script as example. It sends the required parameters for the designer to a vbscript which in turn opens excel and runs the routines for linelist creation.

Structure of the repo

  • automation: Codes for automating linelist creation and development process in R
  • docs: Documentation in html format
  • src: Source codes in flat files used in the designer, and compressed version of the materials (setup, designer, ribbon)
  • designer.xlsb is the designer file.

Limitations

Outbreak tool is limited by Excel's limitations. Using Excel 2010, here are your limitations:

  • Maximum Number of variables in HList: 16384 (including hidden columns for geo variables)
  • Maximum number of dropdowns you can use : 8184 (including at least one geo variable)
  • Maximum length of data validation messages: 255