Checking formatting of input data frame

[caitlinch]

New function checkInputData() in script checkInputData.R.
New tests for checkInputData() in script checkInputData.R (see #26)

Function includes the following checks:
Warnings
Check whether empty rows are present
Check whether rows containing only NA are present
Check whether rows have one or more missing value

Errors
Check that the result column is present
Check that the poolSize column is present
Check that results column values are numeric or integer
Check that poolSize column values are numeric or integer
Check that result column contains only 0 and 1

[caitlinch]

For hierarchical data, want to check that the Site column has unique variables.
Difficult - can't just check names as even if the Site column has unique names for each location, there could be multiple pools for that location.
Check how Angus handles this within PoolTestR

[caitlinch]

Managing hierarchical data:

• Update doco - users should enter hierarchical variables in order of largest to smallest
• Add check to test for uniqueness in hierarchical variables (each Site should only appear in one Village, each Village should only appear in each Region)
  • Should work no matter how many columns are input
  • Check if something similar is implemented in PoolTools
• Add new helper function to create unique identifiers for each location, given the full hierarchical sampling scheme
• Document helper function
• Add tests for helper function
• Add examples for helper function
• Export helper function (make it available to users)

[caitlinch]

Internal functions to check data: CheckInputData(), CheckClusterVars()
Exported function for users to check data with hierarchical/clustered sampling scheme: PrepareClusterData()

[caitlinch]

See file tests/testthat/test-CheckInputData.R on test-suite branch for completed tests.