Skip to content

Update matching-faq.md #137

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Open
goddesswarship wants to merge 1 commit into
base: main
Choose a base branch
from
Open

Update matching-faq.md #137

Changes from all commits
Commits
Show all changes
1 commit
Select commit
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
16 changes: 5 additions & 11 deletions docs/faq/matching-faq.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -8,27 +8,27 @@ Machine learning (ML) jobs in Wildbook run in a shared, serial queue. Detection

## How can I tell if a detection job has completed?

You can tell if a detection job has completed by visiting the encounter page. If the images in the gallery have an annotation (dashed green line) around the animal, detection has completed. You will need to refresh the page to see the annotation appear.
You can tell if a detection job has completed by visiting the encounter page. If the images in the gallery have an Annotation box around the animal, detection has completed. You will need to refresh the page to see the Annotation appear.

## How can I tell if an identification job has completed?

You can tell if an identification job has completed by clicking the hamburger menu on an image in the encounter gallery and checking for “View Match Results”. If, instead, the menu says “Waiting on results”, the job is still processing. You will need to refresh the page to see the menu option change. If the menu says “Cannot start match” let us know in the [Community Forum](https://community.wildme.org/).
You can tell if an identification job has completed by clicking the Match Results button on an image in the Encounter.

## How do I manually start a match?

You may want to re-run your match if you corrected an annotation, got an error message in your previous match results, want to compare to a bigger or smaller list of location IDs, or want try different identification algorithms. You can [manually start a match](../data/matching-process.md#manually-starting-a-match) from the Encounter page. From here, you can modify the location and identification algorithms used.
You may want to re-run your match if you edited an annotation, got an error message in your previous match results, want to adjust the location IDs to check for matches, or want try different identification algorithms. You can [manually start a match](../data/matching-process.md#manually-starting-a-match) from the Encounter page. From here, you can modify the location and identification algorithms used.

## Where are my match results?

* "**No matchable detection**" means that due to the image quality or the animal being obscured, the animal wasn't detected. You can add a [manual annotation](../data/manual-annotation-beta.md) and [start your match](../data/matching-process.md#manually-starting-a-match). Note: If you see this appear when attempting to match whale sharks or sand tiger sharks, you need to select "spot mapping" from the menu instead.
* "**Error initiating IA job**" means there was in issue with detection that's preventing identification from starting. If you see this message when starting a new match from your manual annotation after seeing "No matchable detection" in the image menu, WBIA may be down. Let us know in the [Community Forum](https://community.wildme.org/).
* "**Error initiating IA job**" means there was an issue with detection that's preventing identification from starting. If you see this message when starting a new match from your manual annotation after seeing "No matchable detection" in the image menu, WBIA may be down. Let us know in the [Community Forum](https://community.wildme.org/).
* "**Attempting to fetch results**" or “**Gave up trying to match**” usually means that matching is still in progress. If you don't see match results within 24 hours, something may be wrong. Let us know in the [Community Forum](https://community.wildme.org/).
* "**Image Analysis has returned and no match was found**", "**No match confirmed**", or "**No match results**" means that there are no potential matches for that animal based on the location ID you selected.
* If you see "**Unknown error**", try [restarting the match](../data/matching-process.md#manually-starting-a-match). If that doesn’t produce matches, remove the annotation, [create a new one](../data/manual-annotation-beta.md), and start a new match. If you still get an error after following these steps, let us know in the [Community Forum](https://community.wildme.org/).

## Why do I see matches for a different side of the animal than what's in my image?

Match candidates with similar viewpoints are displayed in match results (ex: left compared with front left or back left). If the annotation viewpoint is incorrect (ex: the animal's left side saved as its right side), you can delete your annotation and [manually create a new one](../data/manual-annotation-beta.md#creating-a-manual-annotation). You won't be able to edit the viewpoint of someone else's image unless you have an edit [Collaboration](../security/silo-security/index.md#collaborations) with that user.
Match candidates with similar viewpoints are displayed in match results (ex: left compared with front left or back left). If the annotation viewpoint is incorrect (ex: the animal's left side saved as its right side), you can edit your annotation in the [manual annotation workflow](../data/manual-annotation-beta.md#creating-a-manual-annotation). You won't be able to edit the viewpoint of someone else's image unless you have an edit [Collaboration](../security/silo-security/index.md#collaborations) with that user.

## I uploaded the same image twice; why doesn't the identical image appear in the match results?

Expand All @@ -37,9 +37,3 @@ WBIA checks for identical images uploaded by the same user and excludes them fro
## I'm on a project and I can't confirm matches on its encounters.

You need to have an edit [Collaboration](../security/silo-security/index.md#collaborations) with the other project participants in order to confirm their matches.

## I've bulk imported my data, but my match results don't include candidates in a sub-region of my selected location.

Wildbook will only run identification for the exact location you put in your bulk import spreadsheet. If you want to expand the location range, you can [re-run the match manually](../data/matching-process.md#manually-starting-a-match) on the encounter page and check the boxes for the additional sub-regions to include in the Location ID section.

Alternately, you can Ctrl + click on a PC or Cmd + click on a Mac to select multiple locations when you resend to identification from the bulk import page.