Incorporate inspection effectiveness as a simulation parameter

[mshukuno]

The effectiveness of an inspection is an important aspect of cargo inspection for pests at borders. This is often overlooked in tools designed to optimize inspections. We are adding this to the model to more accurately and realistically simulate cargo inspections.

[mshukuno]

@wenzeslaus Would you please explain the variables? I am looking at inspection.py "box or boxes" inspection and having a bit of confusion. Once "detected" is set to True, it seems to never change.

popsborder/popsborder/inspections.py

Line 504 in adfd3d8

elif unit in ["box", "boxes"]:

• boxes_opened_completion: Number of boxes to inspect (sample size).
• boxes_opened_detection - (???)
• items_inspected_completion - boxes_opened_completion * inspect_per_box
• items_inspected_detection - (???)
• contaminated_items_completion - Number of contaminated items in a box
• contaminated_items_detection - (???)

[wenzeslaus]

The difference between *_completion and *_detection variables is that completion is how many boxes were open (items inspected, ...) total while detection is how many would be opened (inspected, ...) if we stopped inspecting when seeing first contamination.

Here is an example:

[.x.x..]

. clean
x contaminated

items inspected (to) completion = 6
items inspected (to first) detection = 2

contaminated items detected (to) completion = 2
contaminated items detected (to first) detection = 1

I hope this help. If not let's meet.