How to Use Scout: A Complete Tutorial
Prepare imagery, run tree detection, train a detector, and keep the results you need.
In this tutorial
- 1 Choose the right workflow
- 2 Sign in and find your projects
- 3 Prepare your imagery and boundary files
- 4 Understand credits before processing
- 5 Run inference on an existing TIFF
- 6 Generate an orthophoto and run inference
- 7 Read uploads queues and progress correctly
- 8 View the map and download results
- 9 Change models or boundaries and rerun
- 10 Train your own detector
- 11 Use Run on training TIFF
- 12 Retention deletion and keeping your own copies
- 13 Troubleshoot common problems
- 14 Two worked walkthroughs
- 15 Checklists for everyday use
- 16 Glossary
A practical guide to inference, orthophotos and training your own detector
Open the portal at TreeTools Scout.
TreeTools Scout helps you detect and count objects in aerial imagery, review detections over an orthophoto, download GIS results, and train a detector using your own examples. This tutorial follows the current user interface. Button names appear in bold so you can match each instruction to the screen.
You do not need to install desktop processing software to use the portal. You need a TreeTools website account, suitable imagery, an internet connection and, for a new chargeable inference project, a positive available credit balance. Sign in through WordPress on treetools.ai; the Scout workspace uses that account automatically. Keep your own copies of important source imagery and download any results you need before they expire.
1 Choose the right workflow
The two main work areas are Inference and Detector. Inference applies an existing model to imagery. Detector is where you prepare examples and train a model of your own.
| What you want to do | Where to start | What you need |
|---|---|---|
| Detect objects in an existing orthophoto | Inference → + New project | One orthophoto TIFF and an available model |
| Create an orthophoto from flight images, then detect objects | Inference → + New project | A folder of JPG/JPEG images and an available model |
| Train a detector for your imagery | Detector → Create detector | One training TIFF, areas of interest and annotations |
| Apply a trained detector to its original training image | Open the detector → Run on training TIFF | A successfully trained, active detector |
| Compare another model on an existing inference project | Change Detector selected in that project's row | A completed, unexpired inference project |
An orthophoto is a single image assembled and corrected so that locations correspond to positions on the ground. A folder of raw flight images is not an orthophoto yet. Choose the source that matches the files you actually have: an existing TIFF uses Inference; a raw-image folder uses Ortho & inference.
A boundary patch limits inference to the area you want to assess. It is different from a training AOI. The boundary belongs to an inference project; training AOIs divide a detector's training image into smaller example areas.
If you already have a suitable model, start with inference. Train your own detector when you need to supply examples of the objects and imagery conditions you want it to learn.
2 Sign in and find your projects
- Open TreeTools Scout in a current browser on a computer with a stable internet connection.
- If you see a login message, use the website's Login link and sign in to your TreeTools account. New users can use Register on the TreeTools website to create an account.
- Return to the Scout product page. If your dashboard shows a Scout card, Open Scout opens the same portal.
- Wait for the embedded Scout workspace to open. You do not need to enter a second Scout username or password.
- Check the name beside Hi, in the workspace, then use Inference or Detector. Confirm you are using the intended account before uploading imagery or starting a run.
Your projects and trained detectors are associated with the signed-in account. Another account's projects do not become available simply because both accounts use the same portal.
The credit balance is displayed with an ha label and one decimal place. Click it to refresh the balance. New accounts start with 0 credits. Use Add credits to purchase a pack before starting chargeable inference. Read the pricing explanation in section 4 before processing, particularly if you plan to use Nursery. A displayed balance of 0.0 can be a rounded value; the server checks the underlying balance when you submit work.
Close workspace closes your Scout session. Use the TreeTools website's Logout option to sign out of WordPress as well, especially on a shared computer.
On the inference page, All shows your project list. Use the star beside a project to mark it, then use Starred to return to marked projects. A star helps you organise the list; it does not extend storage retention.
For large uploads, connect the laptop to power and prevent it from sleeping. Keep the browser tab open until the upload has finished and the project has been submitted. You can move between pages within TreeTools Scout while an inference upload continues. Avoid refreshing, closing the tab or signing out during that transfer.
If your session expires, sign in again. Before repeating a submission, check whether the project already appears in your list. This helps avoid creating a second project for an upload that was already accepted.
3 Prepare your imagery and boundary files
Check the limits before starting
| Item | Current limit or accepted format |
|---|---|
| Existing orthophoto | One .tif or .tiff, up to 20 GiB |
| Detector training image | One .tif or .tiff, up to 20 GiB |
| Raw-image folders for Ortho & inference | JPG/JPEG images; up to 20,000 files and 20 GiB total across all selected folders |
| Inference boundary upload | ZIP, GeoJSON/JSON, or shapefile components; up to 50 MiB total |
| Map preview source | TIFF and required sidecar files up to 20 GiB total |
GiB and MiB are binary file-size units. A 20 GiB limit is approximately 21.47 GB in decimal units. Use the file properties on your computer to check size; the portal also validates uploads.
Prepare an existing orthophoto
Choose the original georeferenced TIFF rather than a screenshot, PDF or JPEG export of the map. The image needs valid ground coordinates for boundary alignment and area measurement. If you are unsure whether it is georeferenced, ask the person who created it or check it in your GIS software.
Use a recognisable filename and a project name that includes the site, block or survey date. The project name can be changed in the creation form without renaming the local file. For example, North Block — October 2026 is easier to identify later than image_final_2.
Prepare folders of raw images
You can combine several raw-image folders in one inference project. Click Add image folder for each folder you want to include, or select a parent folder to include its subfolders in one step. Each addition keeps the folders already selected. Scout selects JPG/JPEG images and skips other file types.
Check the folder list and combined image count before processing. Use Remove to exclude a folder or Clear all to start the selection again. The combined selection must contain no more than 20,000 images and 20 GiB in total; this limit applies to the whole project, rather than separately to each folder.
All selected images are uploaded into one flat image set for orthophoto generation. Scout adds unique numbered prefixes to the upload filenames, so Flight1/IMG_001.JPG and Flight2/IMG_001.JPG can both be included. Your local files and the images' contents, including camera metadata, remain unchanged. Keep an unchanged backup of the originals.
Raw imagery must be suitable for reconstructing an orthophoto. Check that the images belong to the intended survey and have the coverage needed for that reconstruction. A raw folder's compressed size does not predict the final TIFF size: the generated orthophoto can be larger, and the 20 GiB preview limit still applies to it.
Prepare a boundary patch
For a shapefile, keep the matching files together. At minimum include .shp, .shx and .dbf. Include .prj so the coordinate reference system is declared. Other matching companion files, such as .cpg, may also be included. A ZIP containing one complete shapefile set is a convenient way to share the boundary without losing a component.
Use one intended boundary geometry. Check that it covers the assessment area and overlaps the orthophoto in the correct ground location. A boundary drawn in the wrong location can produce missing detections or an invalid-patch error.
The coordinate reference system, or CRS, tells the application what the coordinates mean. A shapefile's .prj is therefore important. In this workflow a GeoJSON without an explicit usable CRS declaration is treated as having no CRS; do not rely on a GIS program's assumed default. If in doubt, provide a shapefile set with its .prj.
Boundary files are checked when processing starts. Patch pending after upload is normal. If a boundary has no usable CRS, it is not applied and inference continues on the full TIFF. The project can show Patch not applied with an explanation. Unreadable or invalid geometry can stop processing and must be corrected.
For Ortho & inference, a generated orthophoto is converted to a valid uploaded boundary's CRS when the systems differ. If there is no boundary or no usable boundary CRS, the orthophoto is left unchanged. There is no automatic requirement for every project to use EPSG:2193.
4 Understand credits before processing
Buy and top up credits
WordPress holds your Scout credit balance, and MemberPress handles checkout. Every new account starts with 0 credits. Choose Scout 1,000 ha, Scout 2,000 ha or Scout 2,500 ha using Scout Plans or Add credits in the Scout workspace.
These are one-time credit packs. Each successful purchase adds its hectares to your remaining balance; it does not replace the existing balance or start an automatic renewal. You can buy the same pack again or choose a different pack. A purchase also adds to a negative balance: for example, a 1,000 ha pack added to a balance of −20 leaves 980 credits.
After payment, return to Scout and click the credit balance to refresh it. If a completed purchase has not appeared, contact TreeTools support with the information shown in your MemberPress account. There is no need to buy the same pack again while asking about an unconfirmed payment.
Scout warns when your available credits are below 100 ha. This uses the balance after reservations for work already in progress. Add credits before starting a new chargeable project if the available balance is zero or negative. You can still open the workspace and access projects when the balance is not positive.
How inference uses credits
Credits are based on hectares, with a model-specific rate. For standard inference, one hectare uses one credit. Nursery uses 900 credits per hectare. The balance may still be displayed with a ha label; when using Nursery, the same numerical balance is consumed at the 900-times rate.
The first successful inference on a project charges the usable boundary area when available. If no boundary can be applied, it uses the TIFF area. This is why a carefully prepared boundary can prevent paying for irrelevant ground around the area you need.
Each inference project records its largest paid area. A later run is charged only for growth beyond that maximum. Changing the selected model alone does not incur another area charge, including a switch between standard and Nursery models. The rate for any newly added area is the selected model's rate for that run.
| Example action on one project | Additional charge |
|---|---|
| First successful standard run on 10 ha | 10 credits |
| Change model and process the same 10 ha again | 0 credits |
| Reduce the boundary from 10 ha to 8 ha | 0 credits |
| Expand the paid maximum from 10 ha to 12 ha using a standard model | 2 credits |
| Instead, expand from the same 10 ha paid maximum to 12 ha using Nursery | 1,800 credits |
The last two rows are alternative examples. Once the project has paid for 12 ha, a later model change at 12 ha is free. Reducing the area does not undo the earlier charge; the project retains its largest paid area.
A new project or an increase in paid area requires a positive balance when admitted. The application permits that run to leave a negative balance. For example, an account with 5 credits can start a standard 10 ha project and finish at −5 credits. It will then need additional credits for a new project or further area growth.
An existing project's model-only rerun within its paid area is allowed at zero or a negative balance. If you replace its boundary, the application checks the actual area before permitting additional unpaid area to proceed.
The Paid area displayed with a project is the paid maximum in hectares. It is not a union map of all earlier boundary shapes. Charges are tracked per project: creating another project with the same imagery does not carry the first project's paid area across.
Credits can be reserved while work is running; the charge is committed after successful inference. A confirmed failed or cancelled job releases its reservation. If processing fails, read the error and correct the cause before retrying. Use Add credits to top up, or contact TreeTools support to clarify a balance, then click the balance in the header to refresh it.
5 Run inference on an existing TIFF
- Open Inference and click + New project.
- In Create inference project, enter a Project name. Use a site or survey name you will recognise later; the limit is 100 characters.
- Set Imagery source to Orthophoto TIFF.
- Click Choose TIFF and select one
.tifor.tiff. Check that the selected filename is correct. - Under Patch / boundary files, click Choose patch files and select your ZIP, GeoJSON or complete shapefile set. Confirm the filenames shown beneath the button.
- Choose the Detection AI model.
- Check Inference type. With an existing TIFF it is Inference.
- Review the credit information, then click Process once.
- If no boundary is selected, read Process without a boundary patch?. Choose Add boundary to return to the files, or Continue without boundary if you deliberately want the whole image processed.
- Watch the upload card above the project list. Keep the browser tab open until the transfer and submission finish.
The form may suggest a project name from the TIFF filename. You can replace that suggestion before clicking Process. Choosing the file does not run inference immediately; the Process action records your complete settings and starts the upload.
Current built-in model names are Age 3-4 V3 (Built-in), Post Thinning V8 (Built-in), Nursery V1 (Built-in) and Cutover V2 (Built-in). Your account's available trained detectors can also appear. Choose the model appropriate to the imagery and objects you want to detect; review results on a representative area before relying on a large assessment.
If the model list is still loading, wait for it to finish. If it reports an error, use Retry loading models. An unavailable model cannot be used simply by retaining an old selection.
Once the upload is verified, the project enters the processing queue automatically. You do not need to wait for the upload to finish and then click Inference a second time. Check the project's status to confirm whether it is queued, running or completed.
6 Generate an orthophoto and run inference
- Open Inference → + New project.
- Enter the Project name.
- Set Imagery source to Folder of raw images.
- Click Add image folder and select a survey folder. Repeat to add more folders from the same survey, or select a parent folder containing them.
- Review the selected folders and combined JPG/JPEG image count. Remove unwanted folders and check the total size. These images will be combined into one orthophoto, so include only images belonging to the intended assessment.
- Add the optional boundary under Patch / boundary files. Use a boundary with a declared CRS.
- Select the Detection AI model, taking account of the Nursery rate if applicable.
- Confirm Inference type is Ortho & inference. Raw images use this mode automatically.
- Click Process, respond to any no-boundary warning, and leave the browser tab open while the files upload.
- Wait for submission, orthophoto generation, inference and final publication to complete.
This workflow does more work than inference on an existing TIFF. It first reconstructs an orthophoto and then applies the selected model. A large number of photographs can take substantial time to transfer and process. Progress may move differently through the orthophoto and detection phases; it is not a reliable countdown.
View stays unavailable until an orthophoto exists. When it becomes available, you can request the preview. If another operation on the same project is unfinished, preview preparation may wait for it.
After a verified orthophoto is stored, the original raw images are removed from the project's application storage. Keep your original survey photos in your own archive. The retained orthophoto allows a later inference retry to use the generated TIFF, including when detection fails after orthophoto generation.
Use Download ortho to obtain the retained TIFF when available. Generated orthophotos include the project name in the filename: for example, a project called North Block produces North_Block_orthophoto.tif. Spaces and characters that are unsuitable for filenames are replaced with underscores. An existing TIFF that you upload keeps its original filename.
If the generated orthophoto exceeds the preview size limit, its successful generation does not guarantee that the interactive map can be prepared. Ask your administrator about a suitable smaller image or processing arrangement rather than repeatedly uploading the same folder.
7 Read uploads queues and progress correctly
There are three separate progress displays: transferring files from your computer, processing the job, and preparing map tiles for interactive viewing. Finishing one does not necessarily finish the others.
| Display or status | What it means | What to do |
|---|---|---|
| Uploading imagery or Uploading patch files | Files are still transferring from your browser | Keep the tab open and computer awake |
| Verifying files and submitting for processing | Transfer has finished; the portal is checking and registering the upload | Wait for submission confirmation |
| Upload incomplete | The project does not yet have a completed upload | Check the upload card or retry action |
| Queued | Work is accepted and waiting for processing capacity | Leave it queued; avoid submitting duplicates |
| In Progress with a percentage | Imagery preparation, orthophoto generation, detection or saving results is underway | Follow the percentage and wait for Completed before downloading final results |
| Completed | The inference outputs are ready | Open View or download the files |
| Failed | A processing step stopped | Read the error, correct the cause and use Retry |
| Expired | Retained inference files are no longer available | Upload imagery as a new project if needed |
Processing capacity is shared. If another user has a job running, your project can be added to the queue. Accounts take turns, with eligible work within an account processed in submission order. The queue may explain that it is waiting for another job, processing to start, a worker, or a retry.
The same project cannot start a second unfinished operation. If you see an unfinished-job message, inspect its current status instead of clicking repeatedly. A preview request can also occupy processing time.
The inference project list shows In Progress and its percentage. It does not display processing-stage or tile-count details. The percentage covers work such as imagery preparation, detection and saving results; it can pause at a value while a long step finishes. The upload progress and map-preview progress are separate displays.
Training has its own epoch and early-stopping information, explained in section 10. Neither inference nor training percentages guarantee a completion time. A large first preview can also take much longer than a small one.
8 View the map and download results
Open the inference viewer
- Find the project in Inference projects.
- Wait until View is enabled. For raw images this requires the orthophoto to exist.
- Click View to open Inference Viewer.
- On the first visit, wait while preview preparation is queued or running. The Tiles panel shows status, progress and available detail.
- Use the pan tool to move around, Zoom in and Zoom out to inspect different scales, and Reset view to return to the initial view.
- Review the Summary and switch layers in Layer controls.
The first View generates display tiles when needed. Opening the project list alone does not start that preview pipeline. Once the tiles have been generated, later visits reuse them. Preview preparation and inference are separate: completed inference can still have a first preview to prepare.
Use Show boxes to inspect detection extents and Show centroids to see object centres. Show patch boundary is available when a boundary was applied. Show polygons displays polygon results where those results exist; toggling a layer does not generate missing geometry.
The summary reports Total detections, or Total detections (within patch) when the applied boundary limits the assessment. Look at representative dense, sparse, shaded and edge areas. Model output needs review; a displayed total is not a guarantee that every object has been detected correctly.
Download the deliverables
Return to the project list and open its three-dot menu:
- Download ortho downloads the retained source or generated orthophoto TIFF when available.
- Download output downloads the completed inference output ZIP, named with the project name; for example,
North_Block_output.zip. - Delete starts project deletion; use it only after saving anything you need.
The output ZIP contains final deliverables such as merged boxes and centroids shapefile sets and summaries. Applied-boundary outputs are included where generated. Intermediate per-tile TIFFs and per-tile detection outputs are not part of the user download.
The project name in the download filename helps distinguish results from different sites. Existing projects remain downloadable; an orthophoto generated before this naming update may keep its earlier filename. Save earlier ZIPs before rerunning a project if you want to compare results, because the current download contains the latest published output.
Extract the ZIP before opening a shapefile in GIS. Keep its .shp, .shx, .dbf, .prj and other companion files together. Copying only the .shp can lose attributes or coordinate information. Download the ortho separately if you also want a local raster for GIS review.
If viewing fails, Retry loading preview reloads the viewer. If tile generation itself failed, use Retry tiles after checking the error. Repeatedly creating a new inference project is not the normal way to recover a preview-loading problem.
9 Change models or boundaries and rerun
Use an existing inference project when comparing models on the same imagery. This retains its paid-area history and avoids uploading the same TIFF again.
- Wait for the project's current inference or preview operation to finish.
- Change Detector selected to the model you want to try.
- To change the assessment area, use Replace patch or Upload patch in the project's row.
- Confirm the new boundary filename and expect Patch pending until processing checks it.
- Click Inference, Ortho/Inference, or Retry, depending on the project's state.
- Read any no-boundary warning and wait for the new run to finish.
The list also shows Last used detector and Inferred on. These help distinguish a newly selected model from the one that produced the current completed result. Selecting another model does not immediately replace the results; processing must succeed first.
A completed project's run button can be disabled when the model and boundary have not changed. That prevents an identical duplicate run. Choose a different model or upload a replacement boundary when you intend to make a change.
Within the largest paid area, model-only reruns do not charge again. An expanded boundary can add a charge; shrinking it does not refund previous area. Check the credit rules before expanding an area using Nursery.
Download any earlier result you want to compare before rerunning. The portal's current view and download refer to the project's latest published outputs; do not rely on it as an interface for selecting historical result versions.
10 Train your own detector
Create a detector and upload the training TIFF
- Open Detector and click Create detector.
- In Create Your Own Detector, enter Detector Name.
- Leave Detector Type as General, the currently offered choice.
- Add an optional Description explaining the site, imagery or target objects.
- Click Create.
- In Upload Imagery, select one training
.tifor.tiffand click Upload TIFF. - Keep the browser tab open until transfer and verification finish and the upload dialog closes. Then wait for the separate imagery preparation job.
- Begin drawing when the map is available and Training Image reports Imagery ready.
If the upload dialog closes and the map is still preparing, that does not mean the TIFF must be uploaded again. The worker is making display tiles. If that step fails, read the message and use Retry tiling where appropriate.
Plan your AOIs
Open Preparing training data on the detector page. Follow its three principles: draw AOIs of similar size; aim for object widths around 1/10 to 1/5 of AOI width; and annotate every object fully or partly inside each AOI.
For example, a 50 m wide AOI suits objects roughly 5–10 m wide. This illustrates the relative scale, not a requirement that every AOI measure 50 m. The drawing aid recommends 640 × 640 px; use that alongside the object-to-AOI proportion and consistent sizes.
Prepare at least 8 training AOIs, 2 validation AOIs and 1 test AOI. Training areas provide learning examples, validation areas help check the model during training, and test areas support final evaluation. Choose representative areas across the image, including meaningful variation in conditions. Keep the sets distinct so that evaluation is useful.
Draw rectangular AOIs with two clicks
- Choose Draw training AOI from the left toolbar.
- Click one corner of the intended rectangle.
- Move the pointer to the opposite corner. Check the displayed width and height.
- Click the opposite corner to finish. This is a two-click action, not a click-and-drag gesture.
- Wait for the area to save and appear in AOI Areas.
- Repeat until you have at least eight training areas.
- Use Draw validation AOI for at least two validation areas.
- Use Draw test AOI for at least one test area.
Press Escape to cancel an unfinished drawing. Use the cursor tool when you want to select rather than draw. Select a saved AOI on the map or in AOI Areas before adding annotations to it.
Create a label and annotate the objects
- Expand Label List and click + Add.
- In Create a label, enter Label name, choose a Color, and click Create.
- Select the saved AOI you want to work in.
- Select the relevant label in Label List.
- Choose Draw circle annotation.
- Click the centre of an object.
- Move to the object's edge and click again to finish the circle.
- Repeat for every target object fully or partly inside that AOI.
- Work through the remaining training, validation and test AOIs.
Use consistent labels and cover each object's visible extent as carefully as possible. A partially included object still needs an annotation; do not annotate only the easiest objects and leave other target objects unlabelled in the same AOI. Review crowded areas and objects touching AOI edges before training.
Circle annotation is the available drawing method in this interface. Do not plan a workflow around disabled tools. The Magic annotation and polygon annotation buttons are currently disabled.
Check that your work has saved
AOIs and annotations save automatically. New shapes can appear immediately while the save finishes. The training button may show Saving ... areas or Saving ... annotations. Wait for those pending saves to clear before training, leaving the page or closing the browser.
If a message says that a save could not be confirmed, reload the detector and inspect what is actually present before drawing it again. An interrupted response can make the outcome uncertain; immediately redrawing risks duplicates.
To remove an annotation, select it and use the delete-selection button or the Delete/Backspace key. To remove an AOI, select it using the appropriate selection tool and confirm deletion. Deleting an AOI also removes its annotations, so review the confirmation carefully.
Start and monitor training
- Confirm the minimum 8/2/1 AOI counts.
- Confirm there are saved annotations in the training, validation and test groups. Meeting that minimum is only a starting point: fully label each AOI.
- Wait until pending area and annotation saves have cleared.
- Click Train Detector.
- If eligibility information appears, correct the stated requirement and try again.
- Wait for Training queued, preparation, training, validation and model upload to finish.
- On success, check that the detector is Active and review the reported accuracy.
Editing is locked during queued/running training so that the training inputs remain consistent. Progress can show epochs, the maximum epoch limit, the best epoch and an early-stopping count. Training can finish before the maximum because it may stop after enough epochs without improvement. The epoch-limit percentage is not an estimate of remaining time.
Accuracy is a model evaluation metric, not a promise that the same percentage of trees in every new survey will be correct. Review the model on imagery that represents your intended use.
After adding more annotations, Train Detector trains using all current AOIs and annotations, including existing examples, with the configured preset weights. It is not an instruction to train only on the newest circles. Successful training publishes the model and makes the detector active automatically; there is no separate activation switch to find.
If training fails, the dialog offers Cancel, View logs/details and Retry. Read the details before retrying unchanged data repeatedly.
11 Use Run on training TIFF
This action is a convenient way to assess a trained detector over its original image. It creates a separate inference project; it does not overwrite your AOIs or annotations.
- Open the trained detector and wait for training to finish successfully.
- Confirm it is active and the training imagery is available.
- Click Run on training TIFF.
- Review the Create inference project dialog. Its source is Use this detector's training TIFF and its model is initially the trained detector.
- Edit Project name if desired.
- Add optional Patch / boundary files to limit the assessment area.
- Change Detection AI model if you want to compare another available model.
- Click Process and respond to any boundary warning.
- Follow the new project on Inference projects and review it using View when ready.
You do not need to choose the same TIFF from your computer again. The detector's original imagery is kept. Any newly selected boundary still needs to upload, so keep the browser tab open until submission is complete.
If the button is unavailable, read the nearby explanation. Common causes are training still running, no successfully published active model, or missing imagery. Credits are checked in the new project's settings and submission; insufficient credits can prevent processing after the settings dialog opens.
The new project starts its own paid-area record and follows inference retention. Free model changes within an older inference project's paid area do not make a newly created training-TIFF inference project free.
12 Retention deletion and keeping your own copies
Inference imagery and result files expire 14 days after the latest successful inference. The project displays its expiry using your browser's local time. A successful rerun starts a new retention interval; simply viewing, starring or downloading the project does not.
Download the orthophoto and output ZIP before expiry if you need them for reporting, GIS work or long-term records. After expiry, View, downloads and inference reruns are unavailable. To process the imagery again, upload it as a new project.
Detector projects, including their training data, remain until you delete them. Keep your own originals and any important exports: the application should not be your only archive.
To delete an inference project, open its three-dot menu, choose Delete and confirm. To delete a detector, use the detector card's menu and confirm Delete detector?. Both actions are intended to be permanent from the user's perspective.
Deletion removes the project from the interface and schedules removal of its private storage files. Storage cleanup may continue in the background. If deletion is refused, wait for the project's uploads or processing to finish. A detector can also be protected while queued or running inference is using its model.
Keep a simple local archive containing the survey source, final ortho, downloaded result ZIP, project name and date. For raw-image projects, remember that the original photographs are removed from application storage after the verified orthophoto is generated.
13 Troubleshoot common problems
| What you see | Likely meaning | What to do |
|---|---|---|
| Sign-in stays pending or fails | Connection, account or session issue | Check your connection, retry once, and ask your administrator if it persists |
| Project is not in the list yet | Upload/submission may still be in progress | Check the upload card; do not immediately create a duplicate |
| Upload incomplete | Upload was not completed or submitted | Use the available retry action; if no upload remains, delete the incomplete project and create it again |
| Retry upload / submission | A background transfer or submission failed | Keep the source files available, check the error and retry |
| Retry submission after all files transferred | Final registration failed, rather than the image transfer itself | Retry submission before starting another full upload |
| Duplicate filename error | Selected folders contain repeated names | Rename duplicates, including names differing only by case |
| Patch pending | Boundary awaits processing-time validation | Start the intended inference; pending alone is not an error |
| Patch not applied | Boundary could not be used, such as missing CRS | Check the message and upload a boundary with a declared CRS before a further run |
| Patch invalid | Geometry is not acceptable | Correct the boundary and its companion files, then replace it |
| Queued for a while | Another job or worker startup is ahead of yours | Wait and read the queue reason; avoid repeated submissions |
| This project already has an unfinished job | An operation is already queued or running | Wait for that operation and inspect its status |
| View is disabled | Upload is incomplete, orthophoto unavailable or project expired | Check upload, orthophoto and retention status |
| Preview progress continues after upload | Display tiles are being generated | Follow the Tiles status; do not reupload merely because tiling is slow |
| Retry tiles or Retry tiling | Preview generation failed | Read the error and retry that step; ask for help if it fails again |
| A model cannot be selected | It is unavailable or not successfully published for your account | Check the model list and completed detector training |
| Run button is disabled on a completed project | Nothing changed, processing is busy, patch invalid or credits blocked | Check the model/boundary changes and any explanation beside the action |
| Training is unavailable | Minimum AOIs/annotations missing, saves pending or training already active | Check 8 training, 2 validation, 1 test AOI and saved annotations in every group |
| Save could not be confirmed | The browser cannot confirm whether the shape reached storage | Reload and inspect before redrawing |
| New processing blocked by credits | Available balance is not positive for a new project/additional area | Use Add credits to buy a pack; already-paid model reruns can still be permitted |
| Download unavailable or Expired | File is not ready or retention ended | Check status; expired imagery must be submitted as a new project |
When reporting a problem, provide the project or detector name, the action you clicked, the time, the exact visible error and a screenshot if useful. State whether the transfer, processing or preview failed. Do not share your password or private download links.
14 Two worked walkthroughs
Example A Count an existing block and compare models
You have a georeferenced North_Block.tif and a complete boundary shapefile representing 10 ha. Your account has 30 credits and you want to compare standard models.
- Check that the TIFF is within 20 GiB and the boundary includes
.shp,.shx,.dbfand.prj. - Create an inference project called
North Block — model comparison. - Choose Orthophoto TIFF, select the image, add the boundary and choose your first standard model.
- Click Process and keep the browser open until submission finishes.
- Wait for Completed. If the measured usable boundary is 10 ha, the first successful run uses 10 credits and the balance becomes 20.
- Download the first output ZIP and save it under a model-specific local name.
- Open View, wait for the first preview if needed, and inspect boxes and centroids across representative locations.
- Return to the list, change Detector selected to a second model, and run inference again using the same boundary.
- The model-only rerun adds no area charge. Download its results and compare the two local outputs.
- Save the required files before the displayed expiry date.
If you later expand the paid maximum to 12 ha using a standard model, the additional charge is 2 credits. If you instead expand from 10 to 12 ha using Nursery, the additional charge is 1,800 credits. Check the chosen model before expanding.
Example B Train from examples and test the whole image
You have one suitable training TIFF and want to build a detector from examples.
- Create a detector called
South Block detectorand upload its training TIFF. - Wait for Imagery ready, then open Preparing training data.
- Draw eight training, two validation and one test AOI using similar sizes and two clicks per rectangle.
- Create a label, select the first saved AOI and use two-click circles to annotate every target fully or partly inside it.
- Complete all AOIs, including the validation and test examples. Inspect crowded locations and boundary objects.
- Wait for all pending saves to finish and click Train Detector.
- Follow training, validation and publication until the detector is active. Review its accuracy as a model metric.
- Click Run on training TIFF. Name the new inference project
South Block — trained model reviewand add a boundary around the ground you need. - Review credits and click Process. The TIFF does not need a new local upload.
- Open the completed inference View and compare detections against the image. Keep downloaded results and note where the detector misses objects or makes false detections.
- If needed, return to the detector, add representative examples, wait for saves, and train again using the current dataset.
15 Checklists for everyday use
Before a new inference project
- I am signed into the intended account.
- I selected the correct TIFF or raw-image folders, and reviewed the combined image count and size.
- The files meet the size/count limits and filenames are unique.
- My boundary covers the intended ground and declares a usable CRS.
- I checked the selected model and its credit rate.
- I have a positive balance for a new project or added area.
- I can keep the tab open and computer awake until uploading finishes.
Before Train Detector
- The training image is ready.
- I have at least 8 training, 2 validation and 1 test AOI.
- AOIs have similar sizes and objects are about 10–20% of AOI width.
- Every target fully or partly inside each AOI is annotated.
- Labels are consistent and all three groups contain annotations.
- All pending area and annotation saves have finished.
Before closing a project or leaving the portal
- Uploads and any annotation saves have completed.
- I know whether the job is queued, processing, completed or failed.
- I downloaded the ortho and final output ZIP if I need local copies.
- I saved all shapefile components together.
- I checked the inference expiry date.
- I kept original photos outside the application before any ODM cleanup.
16 Glossary
| Term | Meaning in TreeTools Scout |
|---|---|
| Annotation | A labelled example drawn around an object to help train a detector |
| AOI | Area of interest: a small training, validation or test area in detector imagery |
| Boundary / patch | Uploaded geometry limiting an inference assessment area |
| Centroid | A point representing the centre of a detected object |
| CRS | Coordinate reference system defining how image or boundary coordinates correspond to the ground |
| Detector | A model used to identify objects; it can be built in or trained in your account |
| Epoch | One training cycle through the learning data |
| Early stopping | Ending training before its maximum epoch limit when improvement has stalled |
| Georeferenced | An image or geometry with coordinates locating it on the ground |
| GiB / MiB | Binary units for file size; used by the portal's upload limits |
| Hectare / ha | Ground-area unit equal to 10,000 square metres |
| Inference | Applying a detector to imagery to produce detections |
| ODM / orthophoto generation | Reconstructing an orthophoto from raw aerial photographs |
| Orthophoto / ortho | Corrected aerial image that can be used as a ground-referenced map |
| Paid area | The largest number of hectares already charged to one inference project |
| Preview tiles | Small display images used to load and navigate a large raster interactively |
| Shapefile | GIS vector data stored as a matching set of files, not just the .shp component |
| TIFF / GeoTIFF | Raster image format; a GeoTIFF includes geographic reference information |
| Validation / test | Separate example groups used to check training and evaluate the resulting model |