OptionaltsA single time signature held across the whole span, as sugar for a
one-element meters; defaults to 4/4. Giving both is an input error.
OptionalmetersThe meter as it changes over the span. Bar lines and hypermetric downbeats follow the signature in force at the beat in question, so a piece that changes metre is cut at its own bar lines; the length defaults below are lengths rather than positions, and each is taken once from the meter the span opens in.
OptionalkeyKey context for cadence detection: one key for the whole span, or the key in force at a given beat. Omit it to have the key searched for over time, so a piece that modulates has each cadence read in the key it arrives in.
OptionaltotalEnd of the analysed span in beats; defaults to the end of the last note or timeline segment.
OptionalexpectedLength a phrase is expected to run, in beats; defaults to one hyperbar.
This is a prior, not a rule: a boundary is placed where the evidence puts it, and this decides how much evidence an irregular length has to carry before it is preferred to a regular one. Set it to two hyperbars for music whose phrases are periods.
OptionalminShortest phrase that may be reported, in beats; defaults to one bar of the opening meter.
OptionalrestSilence at least this long divides phrases; defaults to half a bar of the opening meter.
OptionallongA note held at least this long reads as an arrival and closes a phrase; defaults to one bar of the opening meter.
OptionalhypermeterA hypermeter already computed for this piece, to be used instead of inferring one. Pass it when the caller has already asked for the grouping, or to impose a grouping the search would not have chosen.
OptionalbudgetUpper bound on the work this call may do.
Options for phrasesFromTimeline.