File tree Expand file tree Collapse file tree
docs/development/failure_analysis_workflow Expand file tree Collapse file tree Original file line number Diff line number Diff line change @@ -71,40 +71,37 @@ The trace output provides:
7171To determine whether a failure is due to missing data or genuine ambiguity,
7272independently verify the same taxonomic name using ** Global Names Verifier** .
7373
74- === "CLI / Alias Usage "
74+ === "Docker Runtime "
7575
7676 ```bash
77- gnverifier -j 1 \
77+ docker run --rm -i gnames/gnverifier:v1.2.5 \
78+ -j 1 \
7879 --format compact \
7980 --capitalize \
8081 --all_matches \
8182 --sources 11 \
8283 "<scientific_name>" | jq
8384 ```
8485
85- This approach uses the GNVerifier command-line tool directly and is
86- suitable for shell-based workflows and batch inspection.
86+ Runs GNVerifier inside an official container image.
87+ This method requires Docker but does not require local installation
88+ of GNVerifier.
8789
88- === "API Usage (Programmatic) "
90+ === "Local CLI Installation "
8991
9092 ```bash
91- curl -X POST "https://verifier.globalnames.org/api/v1/verifications" \
92- -H "Content-Type: application/json" \
93- -d '{
94- "names": ["<scientific_name>"],
95- "capitalize": true,
96- "sources": [11]
97- }' | jq
93+ gnverifier -j 1 \
94+ --format compact \
95+ --capitalize \
96+ --all_matches \
97+ --sources 11 \
98+ "<scientific_name>" | jq
9899 ```
99100
100- This method uses the GNVerifier HTTP API and is appropriate for
101- integration into automated pipelines or custom applications.
102-
101+ Runs GNVerifier installed directly on the local system.
102+
103103---
104104
105- This step confirms whether multiple accepted records exist in authoritative
106- sources such as GBIF.
107-
108105## 5. Common Failure Pattern: Multi-Accepted Match Tie
109106
110107Across analyzed EOL cases, the most frequent failure pattern observed was:
You can’t perform that action at this time.
0 commit comments