Giter VIP home page Giter VIP logo

llsim's Introduction

Main README file for LLsim package

Line lists are a common form of data used in outbreak investigation and analysis, with rows representing each known case of a disease and columns that include details about the case, such as the date of onset of symptoms and the date of reporting to a health facility.

This project provides a line list simulator for use in testing methods and practicing outbreak analysis

Flow for analysis

  • Input simulation parameters; Create population and run epidemic simulation; Output population and perfectly observed cases
  • Input perfectly observed cases and observation parameters; Determine observed cases and observation delays; Output line list

Development notes

Kinds of Inputs and Outputs

  • Inputs: parameter values (for default simulation function minimally includes incubation period mean, infectious period mean, R0, population size, cfr; optional: shape parameters)
  • Inputs: control parameters (seed, maximum simulation time)
  • Other inputs: reporting parameters (should this be part of parameter values above? probably not, as it will be a separate function and could be used on data generated outside the package)
  • Inputs could be tabluar, key value, or just function arguments... need to decide
  • Outputs: line list data (and optionally full population data) - format specified by user (options: CSV, Rdata / Rds, incidence object??, other/s?); all output is tabluar
  • Outputs: vignettes, which include examples (probably including example analysis, potentially using RECON packages incidence and epicontacts)

Intermediate Results

  • The full line list (perfect observation) is intermediate data, in some sense, falling between the simulation step and the observation step, but for testing methods will be useful data for comparison so should be available to the user

Testing and validation

  • Should test that the required input files are available (if that is how input works)
  • (What other tests are necessary? Certainly some...)
  • Should probably check dates or allow users to input various dates

llsim's People

Contributors

jrcpulliam avatar

Watchers

 avatar  avatar

Forkers

jamesmbaazam

llsim's Issues

Write unit tests

  • test that IDs are unique
  • test that number of cases <= pop_size
  • test that ... all functions work as they should

Recommend Projects

  • React photo React

    A declarative, efficient, and flexible JavaScript library for building user interfaces.

  • Vue.js photo Vue.js

    ๐Ÿ–– Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.

  • Typescript photo Typescript

    TypeScript is a superset of JavaScript that compiles to clean JavaScript output.

  • TensorFlow photo TensorFlow

    An Open Source Machine Learning Framework for Everyone

  • Django photo Django

    The Web framework for perfectionists with deadlines.

  • D3 photo D3

    Bring data to life with SVG, Canvas and HTML. ๐Ÿ“Š๐Ÿ“ˆ๐ŸŽ‰

Recommend Topics

  • javascript

    JavaScript (JS) is a lightweight interpreted programming language with first-class functions.

  • web

    Some thing interesting about web. New door for the world.

  • server

    A server is a program made to process requests and deliver data to clients.

  • Machine learning

    Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.

  • Game

    Some thing interesting about game, make everyone happy.

Recommend Org

  • Facebook photo Facebook

    We are working to build community through open source technology. NB: members must have two-factor auth.

  • Microsoft photo Microsoft

    Open source projects and samples from Microsoft.

  • Google photo Google

    Google โค๏ธ Open Source for everyone.

  • D3 photo D3

    Data-Driven Documents codes.