instrument_range
Read-onlyIdempotent
Verify an instrument's standard written range, or test a specific pitch against it, to catch out-of-range notes before writing a score.
Instructions
Look up a standard instrument compass, or test one pitch against it.
Two questions through one door: without a pitch it reports the range, with one it
reports whether that note is inside it. Entirely offline and read-only.
Returns:
Result dictionary with in_range when a pitch was given, or the lowest and
highest playable pitches when it was not.
Note:
These are the standard written ranges for a competent player, not the limits
of the instrument or of a particular one: professionals exceed them and
beginners do not reach them.
Worth calling before write_score when writing for an instrument, since
write_score with preflight left on runs the same check over a whole score and
reports what falls outside.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| pitch | No | A pitch to test in scientific notation, e.g. 'C4' or 'A5'. Omit to get the full compass instead of a yes or no. | |
| instrument | Yes | Instrument to look up, e.g. 'violin', 'flute', 'cello' or 'trumpet'. Matched against the standard orchestral names. |
Output Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
No arguments | |||