Using the Mothbot UI to Detect Organisms

Now that you’ve opened up the Mothbot UI, you should see a web page that looks like this:

mothbotAI

The first thing you need to do is upload the deployment folder you would like to analyse. Click the orange button that says “Pick Deployment Folder”

selectingdeploymentfolder

Note: on a Mac, you may not have a pop up window appear. Instead, you will see the Python application jumping up and down at the bottom of your desktop screen in your Dock. Click on it and it will open a window.

Then select the nightly folders you want to analyse.

nightlyfolders

Then you can scroll down on the page and hit the big “Run Detection” button.

rundetection

Note: If you have already ran a detection for a deployment before, but would like to override your existing detections, you can select the checkbox that says “Overwrite any previous Bot Detections (Create new detection files)”

For now, you don’t need to worry about changing what is in the field “Yolo processing img size.” I’ll get to that below.

When the detections have finished, you will see a green checkbox next to text that reads “Detection completed”

detectionsfinished

Additional Processing Files

By default, the Mothbot UI automatically uploads a species list for Insects in Panama and a metadata sheet that we have been using here in Panama. Depending on your needs, you may want to upload your own species list and metadata sheet to be used with your data (See the Organizing Data step for more information on how to organize these files for your project).

additionalfilesdetect

You do not need to worry about selecting a yolo model path. YOLO is the object detection algorithm that we use in the Detect Script, and is usually something the Mothbox team will update on our end.

Next Step: Identifying Detected Organisms

We can now move to the next step of data processing, which is identifying all the organisms we’ve just detected. Head to the next step “Identify Detections” to continue.

Run this Script Manually

The Python Script we use to run detections is called Mothbot_Detect. This script tries to find any creatures in your photos. It takes two inputs:

  • a folder pointing to the data you want to analyze
  • a yolo11 AI model trained for detecting creatures

You can set these inputs in the top couple lines of the code as defaults (arrows shown in red): image

When you run the program, it will also ask you if you want to enter different paths, or use these defaults. image

Also if you look at the variable SKIP_PREVIOUS_GENERATED (underlined in green above), leaving this option as “True” means that if you already created detections for your images previously, it will skip them and finish quicker. If you want the script to redo any detections, just set this to false.

Note: the script is also set up to detect any HUMAN generated detections and not overwrite those ever.

Results

This process can take 5-20 minutes for a normal night’s dataset (depending on the number of creatures and the speed of your computer).

image

At the end it will produce little “detection” json files for each image in the folder(s) you gave it. image

These currently store information about where insects likely are. You can visualize these detections if you wish by looking at them in the program X-anylabelling: image

Note how there is no ID information yet. All detections are simply labelled as “creature.”