Brapi Germplasm Performance
brapi_germplasm_performanceAggregate a single germplasm's observations across studies, returning per-variable statistics (n, mean, median, sd, min, max), contributing studies, seasons, and collection coverage. SGN/Breedbase uses advertised germplasm-scoped observation units with embedded measurements, including zeros. Other servers discover up to 200 studies before pulling per study. Pass studyDbIds to skip discovery and restrict collection to known studies. Per-study observation limits, page limits, failures, and incomplete scans appear in coverage and warnings. For the underlying matrix, use brapi_build_phenotype_matrix.
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"germplasmDbId": "<germplasmDbId>"
},
"name": "brapi_germplasm_performance"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| alias | No | Connection alias. Omit to use alias `default`. An alias registered via brapi_connect works, and so does one the server has a URL configured for (a built-in alias, an operator-configured alias, or `default` on a deployment with a default server), which connects on first use. Calls that used a non-default alias must pass that same alias here. | |
| loadLimit | No | Cap on matching observations collected per study, including during automatic discovery. Defaults to 50,000. A study that stops at it is reported as partial. | |
| variables | No | Optional subset of observationVariableDbIds to aggregate. Omit to include every variable observed for the germplasm. | |
| studyDbIds | No | Optional studyDbIds to restrict collection to known studies and skip automatic discovery. Omit to walk germplasm-scoped embedded units on SGN/Breedbase, or discover up to 200 studies on other servers. Find known study IDs with brapi_find_studies; some servers ignore its germplasm filter. | |
| germplasmDbId | Yes | The germplasmDbId to summarize performance for. |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| alias | No | Connection alias the call used. | |
| error | No | Present when the call failed. Absent on success. | |
| coverage | No | Collection coverage, independent of the number of contributing studies. | |
| warnings | No | Advisory messages (study-discovery limits, dropped filters, fallback paths, per-study failures, partial study scans). | |
| truncated | No | True when an observation scan stopped early; coverage records what was collected. | |
| studyCount | No | Number of distinct studies that contributed any observation. | |
| studyDbIds | No | Distinct studyDbIds that contributed observations. | |
| perVariable | No | Per-variable aggregates, sorted by observationVariableDbId. | |
| germplasmDbId | No | The germplasm that was analyzed. | |
| germplasmName | No | Display name of the germplasm, when the server provides one. |