Transcription/TextGrid input, WAV-assisted annotation, Time Group Analysis, TDRA, FDRA-FFT rhythm/modulation spectra, a self-contained Batch TextGrid Metrics workspace, annotation editing, playback, and Praat TextGrid export for internally generated annotations.
TGAplus 7.1.1
Idle
Input
Select a DATA project directory, or select one transcript/TextGrid file and one WAV file manually.
OR
A DATA project directory contains Text/ and Audio/ for input, and Annotation/ and Reports/ for output. Text/ may contain .txt prompts or .TextGrid annotations. You may also paste either a plain transcription or a Praat TextGrid directly. Missing subdirectories are created when possible; if several candidate files are found, you will be asked which one to load.
Audio
Process
Diagnostics
Output
Export Centre
Project exports
Annotation / TextGrid exports
TGA exports
TDRA exports
Time-domain rhythm export times are absolute in the original signal. If a selection or zoom/view interval is active, exports contain the currently analysed interval.
Display Preferences
Choose the interface theme and time-domain display geometry. Signal-display colours and timing are unchanged.
Soft Jade active.
4:1
Lower values are taller; higher values are flatter. Range: 2:1 to 8:1. Applies to Sound, Time-Domain Rhythm and Annotation time-domain displays.
Text
Symbolic text analysis for tone-number Pinyin prompts and selected TextGrid tiers. The summary below reports the current text source and parser or tier statistics.
Text source / extracted text
In TextGrid mode, this selector is synchronised with the Annotation overlay tier. The selected tier supplies the extracted text shown below.
No prompt loaded.
Pinyin Parse / TextGrid Tier Summary
Phoneme Inventory
Allophone Rules
Allophone Text
No allophone text generated.
Finite State Phonology - Work in progress
Deterministic, epsilon-free FSA modes for actual syllables, structural Pinyin phonemic-unit generalisation, and initial–final constrained possible syllables. Generalising modes license candidates with FSAs first; gap enumeration is downstream. In TextGrid mode, input is extracted from the selected syllable-like tier.
FSA gap report
Transitions
Accepted syllable sequences
Sound: Acoustic Signal Workspace
Acoustic displays, playback, zoom, AM-envelope controls, AM-derivative controls, and F0 controls for annotation and TGA inspection. The selection and zoom range are synchronised with Annotation.
Plain signal waveform display-normalised to -1 … 0 … 1
Normalised mono audio waveform without annotation overlays. Use this view to inspect recording quality, gross pauses, clipping, and overall signal shape before editing.
Plain AM envelope normalised to 0 … 1
Amplitude envelope derived from the mono waveform. The Sound controls adjust RMS resolution, independent envelope smoothing, and independent derivative smoothing for the Sound/segmentation path only.
hop = ½
50 ms≈ 8.9 Hz -3 dB
40 ms≈ 11.1 Hz -3 dB
RMS resolution is the short-time amplitude-extraction window; its hop is half the selected value. Smoothing type: centred moving average. A 0 ms smoothing value disables only the named additional smoother; it does not mean raw audio.
Smoothing settings changed. Regenerate results to update annotation boundaries.
Plain AM envelope derivative display-normalised to -1 … 0 … 1
First derivative of the independently derivative-smoothed RMS amplitude contour. Positive regions indicate rapid amplitude rises used as candidate syllable-onset cues; the display shares the marked interval with the other acoustic tabs.
F0 Estimation
Extended-support autocorrelation F0 estimation with DC removal and soft low-pass preprocessing. YIN and high-pass filtering are not used. Optionally, the De Looze–Hirst heuristic estimates the F0 range from first-pass raw F0 before smoothing. The grey trace shows the moving-median filtered F0 contour; the blue trace shows the moving-mean smoothed F0 contour used for summaries and reports. The companion derivative display shows the AM-grid first-difference dF0/dt trace, display-normalised for comparison with the AM derivative; summary values remain in Hz/s. If F0 modelling is applied in the Sound tab, this overview also shows dashed interpolated gap values and the regression curve.
Plain F0 contour Hz; grey = median, blue = smoothed, dashed = interpolated gaps, black = regression
F0 defaultssets fields and recomputes
3 frames≈ 30 ms
3 frames≈ 60 ms
1 frame≈ 10 ms
Default profile: high voice, F0 120–450 Hz, frame 20 ms, hop 20 ms, low-pass 450 Hz/order 3, moving median 3, moving mean 3, and F0 derivative smoothing 1. Low voice defaults can be applied with the profile button. The optional De Looze–Hirst range estimate affects the internal search range only; the y-axis remains the user-set F0 range. Grey is moving-median filtered F0; blue is moving-mean smoothed F0. Move away from a changed control to apply it.
F0 control changed. Move away from the control to apply and recompute F0.
F0 interpolation and regression
Gap interpolation is a derived reconstruction layer. It does not overwrite the smoothed F0 estimate. Regression models are fitted over the selected interval, or over the visible interval when no selection is marked.
F0 derivative AM-grid first difference; display-normalised; Hz/s retained in summaries
F0 settings are controlled here in the Sound tab. Drag horizontally on the F0 contour or derivative display to select an interval; the selection is synchronised with waveform, envelope, AM-derivative, F0 derivative, annotation, and TGA-linked views.
Time-Domain Rhythm Algorithms (TDRA)
The Time-Domain Rhythm Algorithms (TDRA) compare rhythm-event candidates detected from time-domain signal contours: AM envelope, Praat-style intensity, and AM-envelope derivative. Detection uses the audio signal only in this version; TextGrid annotation is not used for the model calculations.
Analysis interval: no audio loaded.
TDRA view
TDRA-1 Broad vocalic-band FAIM Scott-family switchable p-centre model
nPVI=— | rhythm frequency (mean beat tempo, beats per second)=— | mean beat interval=—
TDRA-2 Cummins A: native AM rise TGAplus-native AM contour + shared Cummins detector
nPVI=— | rhythm frequency (mean beat tempo, beats per second)=— | mean beat interval=—
nPVI=— | rhythm frequency (mean beat tempo, beats per second)=— | mean beat interval=—
TDRA-4 Gibbon A: Steepest slope beats AM-envelope derivative peaks on salient rises
nPVI=— | rhythm frequency (mean beat tempo, beats per second)=— | mean beat interval=—
TDRA-5 Gibbon B: Peak beats annotation-free AM-envelope peak model
nPVI=— | rhythm frequency (mean beat tempo, beats per second)=— | mean beat interval=—
Drag across any Time-Domain Rhythm display to mark a working interval. Selection, zoom and playback conventions apply to all time-domain displays and are synchronised with Sound and Annotation. The waveform is shown in very light grey; the active contour and detected markers are superimposed.
Time-Domain Rhythm Controls
Shared TDRA display and envelope settings
TDRA-1 Scott-family settings
TDRA-2/3 Cummins-family settings
TDRA-4/5 Gibbon-family settings
Summary
No rhythm-event results yet.
TDRA controls are grouped into shared, Scott-family, Cummins-family and Gibbon-family rows. TDRA-1 is a switchable Scott-family slot. The default broad vocalic-band FAIM mode uses user-adjustable 300–2500 Hz energy intended to cover much of the F1–F2 sonorant/vocalic region; the historical Scott/Villing 578 Hz / 4 ERB mode and the original Scott-inspired AM-rise midpoint model remain selectable. FAIM modes retain the local band-onset correction and explicit AM-rise midpoint fallback, and broad vocalic-band FAIM may produce fewer valid FAIM hits and more fallbacks than the historical 578 Hz mode. It also retains optional Gibbon A trough-to-peak rise anchoring. In trough-to-peak mode, red Gibbon A markers use a valid trough anchor; blue markers are retained fallback markers using standard Gibbon A placement. Sound features are computed from WAV audio alone. RMS resolution sets a short-time amplitude-extraction frame with automatic half-window hop; Sound and TDRA RMS selectors are independent. In TDRA, RMS resolution applies only to RMS envelope mode, Envelope cutoff filter is a moving-average low-pass approximation, and TDRA AM smoothing is centred moving-average smoothing of the shared Scott-family / Cummins A / Gibbon A / Gibbon B contour. Cummins B remains independent with Praat-style intensity processing. A 0 ms smoothing value disables only the named additional smoother and does not mean raw audio.
Implementation notes for the five Time-Domain Rhythm Algorithms (TDRA). The descriptions use the current app defaults and timing conventions so that a coder can reproduce the browser implementation. The algorithm documentation card is intentionally the final card in this tab.
Interval duration labels: when enabled, TDRA displays show rounded inter-event durations in milliseconds halfway between neighbouring event markers. Labels are hidden automatically when neighbouring markers are too close to read.
TDRA-1 Scott-family p-centre models
Purpose
TDRA-1 is a switchable Scott-family slot with three alternatives: the original TGAplus Scott-inspired AM-rise midpoint model, the historical Scott/Villing FAIM model, and a broad vocalic-band FAIM-inspired continuous-speech adaptation.
Two-stage continuous-speech adaptation
The two FAIM modes have two distinct components. First, the retained AM-rise midpoint detector identifies candidate regions from broadband trough → rising slope → peak geometry. Second, the selected spectral front end tests the candidate with a band-energy envelope. Historical FAIM uses the narrow 578 Hz sub-band / 4 ERB channel; broad vocalic-band FAIM uses the user-adjustable broad band, default 300–2500 Hz. The candidate trough proposes the search region only and is not the FAIM event reference.
Scott-inspired AM-rise midpoint
The original TGAplus emulation is retained as a selectable model and as the fallback source for the two FAIM modes. A preceding broadband AM trough and following AM peak must satisfy the configured candidate minimum trough-to-peak difference and minimum spacing; the marker is placed at the trough-to-peak midpoint. Because this mode uses AM-rise geometry directly and does not require a valid spectral FAIM threshold crossing, it normally produces the largest number of direct markers.
Historical Scott/Villing FAIM
This mode keeps the literature-oriented spectral front end: a single 578 Hz sub-band auditory-band approximation with 4 ERB bandwidth, full-wave rectification, and a 25 Hz envelope low-pass. ERB means Equivalent Rectangular Bandwidth, a psychoacoustic auditory-filter bandwidth measure; 4 ERB means four auditory-filter bandwidth units at the selected centre frequency, not four Hertz. The 578 Hz channel is historically important in Scott/Villing FAIM but is not treated here as a universally privileged hearing frequency.
Broad vocalic-band FAIM
This is the default continuous-speech adaptation. It replaces the narrow 578 Hz channel with a broad user-adjustable vocalic/sonorant band, default 300–2500 Hz, intended to cover much of the F1–F2 energy region while reducing dependence on consonantal high-frequency cues and on one narrow F1-region channel. This mode is FAIM-inspired rather than a faithful Scott/Villing spectral front end.
FAIM timing feature
Within each candidate region, the selected spectral band is rectified and low-pass filtered at 25 Hz, then the estimator searches for a local band-rise onset before the band peak. The user-selected amplitude threshold, default 50% of the local band peak, is searched between that local onset and peak. The 25 Hz low-pass has a separate role from the spectral band limits: it smooths the rectified band-energy envelope after filtering.
Regression controls
Scott original preset:p-centre = -11.2 + 0.407 × threshold_time. Villing revised preset:p-centre = -65.6 + 1.07 × threshold_time. Intercept and slope are user-editable in Custom mode. Times are in milliseconds relative to the local band onset. In broad vocalic-band mode these coefficients are reference presets rather than guaranteed optimal mappings.
Parameters
Default TDRA-1 model: broad vocalic-band FAIM; broad band 300–2500 Hz; threshold 50%; Scott original regression preset; candidate minimum trough-to-peak difference 0.15; candidate minimum spacing 100 ms; post-peak candidate margin 50 ms; onset-to-peak window 20–300 ms; minimum band rise 10% of the local peak. The broad-band limits, threshold, regression coefficients and onset/fallback parameters are user-facing controls.
Fallback and hit counts
The broad vocalic-band mode does not simply increase the number of detected events. It applies the same FAIM-style validity tests to a broader 300–2500 Hz spectral envelope. Because this broader envelope can have different onset, peak and threshold-crossing behaviour from the historical 578 Hz channel, it may produce fewer valid FAIM hits and more AM-rise midpoint fallback markers. Fallback markers occur when the AM-rise candidate is retained but the selected spectral test does not yield a valid local rise, threshold crossing or regression result.
Fallback policy
If the selected band has too little energy, no valid local band onset is found, the onset is already above the selected threshold, the threshold crossing cannot be found, or the regression result would fall before the band onset or outside the event window, the candidate is not discarded and is not clamped to a trough. The retained AM-rise midpoint timing is used as explicit fallback and the event is flagged internally. Blue markers indicate fallback events in FAIM modes.
Output
The active TDRA-1 selector determines which Scott-family marker sequence is rendered and exported. TDRA interval metrics such as nPVI, rhythm frequency and mean beat interval are calculated from the selected TDRA-1 marker times.
TDRA-2 Cummins A: native AM contour + Cummins rise detector
Input contour
Cummins A applies the shared Cummins rising-slope beat-identification rule to the TGAplus-native AM contour. This contour is the same active-interval envelope used by the Scott-family and Gibbon envelope-based models, with the selected amplitude, squared, or RMS envelope method and the independent TDRA smoothing controls.
Shared Cummins detector
Cummins A and Cummins B use the same Cummins beat-identification rule. The detector computes the contour minimum and maximum over the active TDRA analysis interval, sets the effective threshold to threshold × (maximum − minimum), scans for monotonic rising slopes, keeps rises whose height exceeds the threshold, trims each accepted rise to its central 10%–90% amplitude region, and places the marker at the midpoint of those trimmed indices.
Parameters
Default Cummins A/B rise threshold 0.20. A threshold of 0 is valid. The threshold is interval-local because TDRA beat detection is applied to the active analysis interval.
Interpretation
Cummins A is not the original Praat–Perl pipeline. It replaces the Praat intensity contour with the TGAplus-native AM contour while retaining the Cummins rising-slope beat detector. This makes Cummins A directly comparable with the other AM-envelope TDRA displays.
Output
Absolute signal-time beat markers with fractional detector indices, rise slope, peak time and previous inter-beat interval.
Cummins B applies the same Cummins rising-slope detector to a Praat-style filtered intensity contour. For Cummins B fidelity, the contour is computed over the full loaded sound first and only then cropped to the active TDRA analysis interval.
Praat-style preprocessing
Scale the full loaded signal to the configured average intensity, default 70 dB. Apply a Hann-band pass filter in the frequency domain with default pass band 500–2500 Hz and 100 Hz transition. If subtract mean is enabled, remove the mean from the full filtered signal. The resulting full-sound filtered signal is then used for intensity calculation before interval cropping.
Intensity contour
Emulate Praat To Intensity... 25 0 yes. The default pitch floor is 25 Hz. With automatic time step, dx = 0.8 / pitchFloor, giving 0.032 s at 25 Hz. The effective Gaussian-style window duration is 3.2 / pitchFloor, giving 0.128 s at 25 Hz. For each full-sound contour frame, compute a Gaussian-weighted local mean square, divide by the reference pressure squared, and convert to dB with 10 log10(meanSquare / reference²). The full intensity contour is then cropped to the active TDRA interval.
Contour generation vs beat detection
Cummins B uses the full loaded signal for contour generation, but beat detection remains interval-based. After cropping, the detector computes the max–min intensity range, threshold, rising slopes and beat markers only within the active TDRA analysis interval. Thus the full signal avoids filtering/intensity edge artefacts, while the selected or zoomed TDRA interval remains the actual analysis domain.
Shared Cummins detector
The detector is the same Cummins rising-slope rule used by Cummins A. It finds the contour minimum and maximum over the active interval, sets the effective threshold to threshold × (maximum − minimum), scans for monotonic rising slopes, keeps rises whose height exceeds the threshold, trims each accepted rise to the central 10%–90% amplitude region, and sets the beat index to the arithmetic midpoint of those two trimmed indices.
Timing rule
Preserve the fractional beat index. The cropped Cummins B contour keeps absolute full-sound frame timing, so x1 + dx × beatIndex is evaluated relative to the first retained full-sound contour frame rather than to a newly filtered local selection. Do not round the beat index for timing.
Interpretation
Cummins A and Cummins B may produce different marker counts, timings and contour shapes because they apply the same beat detector to different input contours: TGAplus-native AM for Cummins A, Praat-style filtered intensity for Cummins B.
Output
Absolute signal-time beat markers, raw dB values, display-normalised contour values, fractional beat indices, rise slopes and Praat-emulation metadata.
TDRA-4 Gibbon A: AM rise / maximum-slope beat timing
Gibbon A places beat markers on the rising part of the shared TDRA AM contour. In standard mode, candidate AM peaks are detected first, then the marker is placed at the point of maximum positive slope before the accepted peak.
The optional trough-to-peak rise anchor refines this localisation step. For each already detected Gibbon A peak, the algorithm searches for a preceding trough within the configured minimum and maximum trough–peak distance limits. If the trough is valid and the trough-to-peak rise is large enough, the rise interval is defined as:
preceding trough → accepted peak
The red Gibbon A marker is then placed at the maximum positive slope within this trough-to-peak interval.
If no valid trough is found, or if the trough-to-peak rise is below the selected threshold, the candidate is not rejected. Instead, it falls back to standard Gibbon A placement. In trough-to-peak mode, blue markers indicate fallback standard placements.
This option changes Gibbon A marker localisation only. It does not change Gibbon A peak admission, does not affect Gibbon B or the other TDRA models, and does not include pitch/F0 cues.
TDRA-5 Gibbon B: Peak beats
Input
The active analysis interval and TGAplus signal-only AM envelope.
Contour
The same normalised TGAplus AM-envelope contour used by the Scott, Cummins A and Gibbon A signal-only models.
Find local envelope peaks where the current value is at least the previous value and greater than the following value. Estimate local prominence from the larger of the left and right local bases. Keep candidates meeting the prominence threshold, sort by peak value and prominence, suppress peaks closer than the minimum distance, then return the retained peaks in chronological order.
Current scope
This is the signal-only implementation. Annotation-assisted Gibbon interval-peak variants and Segment nPVI are reserved for a future version and are not active here.
Output
Absolute signal-time peak markers with prominence-derived scores and previous inter-peak intervals.
Prominence note
The 0.015 default is a pragmatic lower default to reduce missed Gibbon A/B events in shallow-dip cases. It is not a principled replacement for a future hybrid criterion combining absolute height, local prominence, dip separation and spacing.
Shared timing, selection-zoom-play conventions and metrics
Analysis interval: selected interval if present; otherwise zoom/view interval if not full signal; otherwise full signal.
Selection-zoom-play: all time-domain displays use the same selection, zoom and playhead conventions, including Sound, Annotation and all five TDRA displays.
Absolute time: all marker times, exported times and inter-marker intervals use absolute signal-time on the original audio timeline. Times are never reset to zero at the left edge of a selection or zoom view.
N: number of detected markers in the current analysis interval.
Mean inter-event interval: arithmetic mean of successive marker-time differences.
Mean beat tempo:1 / mean inter-event interval, reported in Hz.
nPVI: normalised pairwise variability index over successive inter-event intervals; it requires at least three marker times. Segment nPVI is not included in this version.
FDRA-FFT Rhythm/Modulation Analysis: Signal and AM/RMS Envelope
FDRA-FFT: frequency-domain rhythm/modulation analysis of an extracted AM/RMS information contour. Drag over the combined display to select the synchronised interval used for the spectrum and spectrogram.
FDRA-FFT = modulation-frequency spectrum and ridge tracking of an AM/RMS-derived information contour.
FDRA-FFT signal displaywaveform with superimposed AM envelopeNo audio.
FDRA-FFT interval: —Duration: —Envelope rate: —
50 ms≈ 8.9 Hz -3 dB
40 ms≈ 11.1 Hz -3 dB
These AM controls are synchronised with the Sound-tab AM controls. FDRA-FFT uses the current committed AM/RMS envelope as its default extracted information contour.
FDRA-FFT Low-Frequency Rhythm/Modulation Spectrum
FFT spectrum of the AM/RMS-derived information contour in the selected interval. Peaks are labelled as candidate rhythm/modulation formants and are based on the displayed smoothed spectrum; the Peaks shown control limits visible peak markers by magnitude rank.
Tilt compensation is a display operation in dB over log-frequency; it does not change the underlying FDRA-FFT calculation. The exact DC bin is suppressed as non-rhythmic.
FDRA-FFT low-frequency spectrum selected interval only
Drag horizontally in the spectrum or vertically in the spectrogram to select a rhythm/modulation-frequency band. Use Zoom Frequency Selection to inspect the selected band and Restore Full Frequency Range to return to the pre-zoom range.
Selected frequency band: —
FDRA-FFT Low-Frequency Spectrogram
Mandatory FDRA-FFT spectrogram of the selected interval. For intervals shorter than 6 s the card remains visible and reports the required correction.
Ridge ranks
FDRA-FFT low-frequency spectrogram same frequency range as the spectrum
End handling: incomplete final windows are padded by copying the final envelope value to preserve the selected time scale. Bidirectional sweep, when enabled, combines forward and reversed-envelope sweeps.
Annotation Inspection / Editing Workspace
Inspect annotation tiers and edit generated transcription-based boundaries. TextGrid-derived annotations are inspectable but read-only.
Annotation status will appear after annotation tiers are available.
TGA-style duration statistics selected annotation tier; durations in ms, rates in Hz
Descriptive timing measures are computed from the selected overlay tier. Without a marked interval, the full tier is used; with a marked interval, intervals whose midpoint falls inside the mark are used.
TGA-style duration statistics will appear after annotation tiers are available.
No annotation tier available.
Rows are computed without pauses and including pauses. The including-pauses row includes internal pauses only; initial and final pauses are excluded. The coefficient of variation is based on population standard deviation; both population and sample standard deviations are shown.
View: —Selection: —Playback: stoppedPlayback interval: mark an interval firstBoundary edit: —
Annotated signal waveform display-normalised to -1 … 0 … 1
Normalised mono audio waveform with annotation labels, boundaries, selection, playhead, and manual boundary editing.
Smoothed AM envelope normalised to 0 … 1
Derived from frame RMS of the mono waveform using the Sound RMS resolution selector, then smoothed with the independent Sound AM-envelope smoother and normalised to 0…1. Used for syllable-scale loudness patterns and pause/onset detection.
AM envelope derivative display-normalised to -1 … 0 … 1
First derivative of the derivative-smoothed AM envelope. Positive peaks indicate rapid amplitude rises and are used as candidate syllable-onset cues; boundaries are usually placed near the preceding envelope valley.
Annotated F0 contour Hz; dashed = interpolated gaps, black = regression model
Annotated F0 contour will appear after segmentation.
Drag across any display to mark a working interval. Click inside the marked interval to play/stop it. If annotation boundaries exist, playback snaps to the leftmost and rightmost boundaries inside the mark when at least two internal boundaries are present; otherwise it plays the marked interval exactly. Drag a segmentation boundary inside the marked interval to shift it. If no interval is marked, clicks do not play.
Segmentation Settings
Alignment
Prior-guided syllable alignment. The app uses the known transcript, AM-envelope cues, Mandarin onset priors, punctuation, phrase-final lengthening protection, and SDR diagnostics. No pre-trained acoustic model is used.
SDR and boundary-strength diagnostics
SDR = duration of current syllable / duration of previous syllable. High SDR values are treated as possible boundary evidence only when supported by punctuation, following pause, and acoustic cues.
Second-pass boundary adjustments
TGA: Time Group Analysis
TGA analyses interval durations from the selected generated or TextGrid annotation tier. Phase A provides the core TGA foundation; Phase B adds enhanced Time Group statistics and Duration Difference Tokens; Phase C adds DDT n-grams, pattern summaries, acceleration/deceleration analysis, and D-Wiggliness / D-Spaciousness duration-shape measures. Phase D adds Time Trees, Wagner Quadrant plots, and tone duration violin/box visualisations.
TGA implementation phases
Phase A — Core TGA: implemented
TextGrid/generated tier input, text extraction, TextGrid-to-CSV table, compact global statistics, pause-based Time Groups, JSON/CSV/ZIP export.
Phase B — Time Group analysis: implemented
Per-Time-Group statistics, Duration Difference Tokens, local duration pattern table, and simple Time Group duration display.
Phase C — Duration pattern extensions: implemented in this version
Phase D — Structural visualisation: implemented in this version
Time Trees, Wagner Quadrant plots, and boxplots.
Phase E — Batch mode: planned
Multiple TextGrids / ZIP input and cross-file summaries.
TGA runs automatically after annotation tiers are available and refreshes when relevant inputs or settings change. If a time interval is marked, TGA uses intervals whose midpoint lies inside the selected interval.
Phase A — Text extraction
Phase A extracts text from the selected tier. Phase B aligns the extracted text with pause-based Time Group IDs.
Why: this checks what linguistic material the selected interval tier contributes before any duration grouping is interpreted.
No TGA analysis yet.
Phase A — Global statistics
Original-style compact TGA table comparing no-pause, pause-only, and with-pause statistics in one table. Initial and final pauses are excluded; with-pause statistics include internal pauses only.
Why: no-pause values describe content timing, pause-only values describe silence/boundary timing, and with-pause values describe the complete delivery contour.
No TGA analysis yet.
Phase A — TextGrid-to-CSV interval table
CSV-style conversion of the selected interval tier, including timing, duration, label, pause/content flags, Time Group ID, position within group, and DDT-to-next information.
Why: this is the audit trail for TGA: every later statistic and visualisation can be traced back to these labelled intervals and durations.
No TGA analysis yet.
Phase B — Enhanced pause-based Time Groups
Time Groups are runs of content intervals separated by configured pause/boundary labels. Phase B adds per-group statistics, local Duration Difference Tokens, and group status.
Why: Time Groups approximate interpausal units, giving duration analysis a rhetorically and prosodically meaningful span.
No TGA analysis yet.
Phase B — Time Group duration display
Simple duration display for Time Groups. This is not yet a Time Tree visualisation.
Why: the bar view makes the raw duration contour visible before it is abstracted into DDT patterns, shape measures, or Time Trees.
No TGA analysis yet.
Phase C — DDT n-gram pattern summary
Global summaries of repeated Duration Difference Token n-grams using the configured Phase C n range.
Why: DDT n-grams capture repeated local lengthening, shortening, and level-duration patterns that may not be visible in aggregate statistics.
No TGA analysis yet.
Phase C — Time Group pattern details
Per-Time-Group DDT n-grams and dominant duration patterns.
Why: this shows which local duration patterns belong to each interpausal unit instead of merging all pattern evidence globally.
Why: second differences identify changes in the rate of duration change, while runs and turning points summarise local rhythmic direction.
No TGA analysis yet.
Phase C — D-Wiggliness and D-Spaciousness
Duration-shape measures for no-pause content rhythm, pause-only rhetorical/dialogue fluctuation, and with-pause delivery fluctuation.
Why: D-Wiggliness measures direction-change density; D-Spaciousness measures the size of the largest duration excursions.
No TGA analysis yet.
Phase C — Duration shape by Time Group
Compact per-Time-Group view of no-pause and with-pause D-Wiggliness / D-Spaciousness plus an indicative shape profile.
Why: per-group shape values help locate where global rhythmic fluctuation is concentrated in the signal.
No TGA analysis yet.
Phase D — Time Trees
Duration-induced Time Trees for each Time Group. Nuclear-type trees prefer shorter→longer relations; Compound-type trees prefer longer→shorter relations. Parent values inherit the strongest child everywhere. Processing can use the global-best, left-to-right, or right-to-left strategy.
Why: Time Trees turn a duration sequence into an order-preserving hierarchy, making competing temporal groupings explicit. The Play/Stop controls play the continuous audio span of the selected Time Group series, including pauses.
Time Tree relation
Processing
Time Group span selector
Click one TG for a single interpausal unit, or click two TGs to select a contiguous span. Intermediate TGs are highlighted automatically. Build confirms the selected span.
No Time Group span selected.
No TGA analysis yet.
Phase D — Time Tree similarity and robustness
Gibbon-style Tree Similarity Index and span-based robustness diagnostics comparing the six Nuclear/Compound × processing-strategy Time Trees for the current Time Group or selected span.
Ranges: Gibbon TSI and Jaccard similarity range from 0 to 1, where higher means more similar. Jaccard distance and normalised RF-like distance range from 0 to 1, where lower means more similar. Raw RF-like distance is size-dependent. Branch robustness is count/6.
Why: this tests whether the induced Time Tree is stable across relation and processing assumptions, using shared ordered spans as the comparison basis.
Root span
No TGA analysis yet.
Phase D — Wagner Quadrant plot
Z-score-normalised duration transitions using x = z(dᵢ), y = z(dᵢ₊₁). Quadrants are labelled Iambic, Pyrrhic, Spondaic, and Trochaic.
Why: adjacent z-score transitions show whether neighbouring intervals form short-long, short-short, long-long, or long-short timing relations.
No TGA analysis yet.
Phase D — Tone duration distributions
Violin plots superimposed on box plots for interval durations grouped by tones 1–5. The red dot marks the mean duration for each tone.
Why: grouping durations by tone makes possible tone–duration relations visible without assuming that tones have identical temporal distributions.
No TGA analysis yet.
No TGA analysis yet.
Batch TextGrid Metrics
Load multiple Praat TextGrid files and compute numerical timing, tier, label, rhythm, pause, and quality metrics. Batch mode is TextGrid-only; audio, TDRA, FDRA, F0, playback and annotation editing are not run here.
Metrics are computed when files are added. Use Recompute with Current Settings after changing Batch settings.
No TextGrid files loaded.
Batch Settings
Rounding is display-only. Export tables keep full numeric values where possible.
Loaded TextGrid files
Selected-file numerical preview
Select a batch file to inspect its computed values. This does not change the main single-file project.
Selected file summary
Tier summary
Label summary
Irregularity Measures
IOI / inter-point metrics
Pause metrics
Quality checks
Raw interval table
Raw point table
Batch-wide result tables
Screen tables preview up to 100 rows; exports contain all rows.
Batch Graphics
Generate on-demand graphics from computed Batch numerical results. Graphs are TextGrid-derived only and can be saved as SVG, PNG or PDF.
Wagner Quadrant
Scatter plot of successive z-normalised duration pairs for one file, selected files, or all loaded files. Combined plots use one tier name and one sequence type across files.
Selected files0 files selected
No Wagner Quadrant generated.
Generate a Wagner Quadrant after loading TextGrid batch metrics.
Dendrogram
Hierarchical clustering of files only. Select one tier, one sequence type where relevant, and one scalar measure; leaves are filenames.
No dendrogram generated.
Generate a dendrogram after loading TextGrid batch metrics.
Batch Export
Exports use a structured output package. The ZIP contains README, settings, manifest, combined tables, per-file table folders, and JSON.
No batch results to export.
TGAplus V7.1.5 User Guide
TGAplus is a browser-local Time Group Analysis app for transcription/TextGrid input, WAV-assisted annotation, annotation inspection/editing, Time Group Analysis, Time Trees, playback and TGA exports.
Overview
The app supports two TGA-oriented workflows. A plain transcription plus WAV can be segmented into an internally generated annotation. A Praat TextGrid can be loaded or pasted as a read-only annotation source for inspection and analysis. All processing is local to the browser.
Input workflows
Transcription workflow: load or paste transcription text, load a WAV file, generate/inspect/edit the annotation, then run Time Group Analysis.
TextGrid workflow: load or paste a TextGrid, optionally load a WAV file for playback and compatibility checking, select a tier, inspect the read-only annotation, then run Time Group Analysis.
Pasted text is treated as TextGrid only when it starts with a standard Praat TextGrid header; otherwise non-empty pasted input is treated as transcription.
Tab 1: I/O
The I/O tab loads transcript/TextGrid files, pasted transcription/TextGrid text, WAV audio, and DATA project directories. The Process card shows the current generated/waiting status and provides regeneration and clear controls.
Tab 2: Text
The Text tab shows transcription-derived text analysis or extracted TextGrid-tier text. It also provides phonological/FSA views where available for the current text source.
Tab 3: TGA
The TGA tab contains interval tables, Time Groups, duration displays, Time Tree analysis, Time Group playback, Wagner/tone-duration displays and TGA export controls. Inline TGn buttons play the corresponding Time Group where audio is loaded.
Tab 4: Sound
The Sound tab provides WAV inspection, waveform/envelope/AM-derivative/F0/F0-derivative displays, playback, and zoom/selection controls for acoustic signal inspection. These displays support annotation and TGA inspection.
Tab 5: Time-Domain Rhythm
The Time-Domain Rhythm tab compares five Time-Domain Rhythm Algorithms (TDRA): a switchable TDRA-1 Scott-family p-centre slot, Cummins A native AM-contour beats, Cummins B Praat–Perl intensity beats, Gibbon A steepest slope beats, and Gibbon B peak beats. It shares the Sound/Annotation selection, zoom and playback timeline; the active analysis interval is the selection when present, otherwise the current zoom/view interval, otherwise the full signal. The final card in the tab documents all five algorithms in reproducible detail.
Tab 6: FDRA-FFT
The FDRA-FFT tab provides frequency-domain rhythm/modulation analysis of an AM/RMS-derived information contour, including the low-frequency spectrum, spectrogram, ridge tracking, tilt compensation, and synchronised time/frequency selection.
Tab 7: Annotation
The Annotation tab contains annotation inspection and editing, plus the segmentation settings and alignment diagnostics used to generate and review transcription-based annotations. Transcription-generated annotations are editable; TextGrid-derived annotations are inspectable but read-only. When an edited annotation affects TGA, TGA is regenerated automatically when leaving the Annotation tab.
Tab 8: Batch
The Batch tab is an autonomous TextGrid-only multi-file numerical workflow. Use Add TextGrid files to load multiple TextGrids, Recompute with Current Settings after changing Batch settings, Batch Help for definitions, and clickable nonzero warning counts to inspect scrollable warning details. Selecting a Batch file previews its metrics without replacing the main single-file project.
Exports
Internally generated annotations can be exported as Praat TextGrid.
Imported or pasted TextGrid input is read-only and is not re-exported as TextGrid.
TGA reports, tables, JSON/CSV/ZIP outputs and TGA figures are exported from the I/O and TGA export controls where available.
Time-Domain Rhythm algorithms
The Time-Domain Rhythm tab compares five signal-only Time-Domain Rhythm Algorithms (TDRA): a switchable TDRA-1 Scott-family p-centre slot, Cummins A native AM-contour beats, Cummins B Praat–Perl intensity beats, Gibbon A steepest slope beats, and Gibbon B peak beats. The final in-tab Algorithm documentation card describes the input contour, preprocessing, parameters, detection rule, timing conversion and output markers for each procedure.
Cummins A and Cummins B are displayed separately but now share the same Cummins rising-slope beat-identification rule. Cummins A applies that rule to the TGAplus-native AM contour. Cummins B applies the same rule to Cummins' Praat preprocessing defaults — scale intensity 70 dB, Hann-band pass 500–2500 Hz with 100 Hz transition, and To Intensity 25 0 yes — over the full loaded sound before cropping the resulting intensity contour to the active TDRA interval and running an exact JavaScript port of the original Perl beat-identification loop. Gibbon A displays the AM envelope but places markers at AM-envelope derivative maxima on salient rises; Gibbon B marks envelope peaks. All rhythm-event times remain absolute signal times, even when the analysed interval is a selection or zoomed view.
Version notes
TGAplus V7.1.5 — Wagner Tier Scope Consistency. Corrects Batch Wagner mode switching so Single file, Selected files and All loaded files all use the same tier-name value system. This preserves the selected comparable tier when moving between scopes, while retaining combined Wagner plotting, within-file z-normalisation by default, included/omitted file reporting, SVG/PNG/PDF plus points-CSV export, and the scalar file-level dendrogram safeguards from V7.1.3.
Continuity note: Scott-family TDRA-1, Gibbon models, Sound, F0, TextGrid and TGA behaviour are unchanged. Cummins A, Scott-family TDRA-1, Gibbon A/B are unaffected by this Batch Graphics release.
TGAplus V6.2.2 — Broad Vocalic-Band FAIM. Makes TDRA-1 a switchable Scott-family slot with the original Scott-inspired AM-rise midpoint, historical Scott/Villing FAIM using 578 Hz / 4 ERB, and broad vocalic-band FAIM using a default 300–2500 Hz band. The old AM-rise midpoint remains the fallback source for FAIM modes.
TGAplus V6.1.19 — Gibbon A Documentation Update. Updates the in-tab Gibbon A documentation to describe standard and trough-to-peak marker localisation, red trough-anchored markers, and blue fallback markers. No algorithm, display, smoothing, RMS, F0, TextGrid, export or TGA behaviour is changed.
TGAplus V6.1.16 — TDRA Display Results. Adds concise TDRA result lines above each TDRA beat display and renames the Time-Domain Rhythm tab to TDRA. V6.1.14 repaired and clarified the V6.1.13 smoothing redesign. Sound AM features are computed from WAV audio alone; Sound and TDRA RMS resolution use the same framed-RMS definition with automatic half-window hop while remaining independent; TDRA RMS resolution applies if RMS envelope mode is selected; and the Sound and TDRA tabs document RMS resolution, 0 ms smoothing behaviour, Envelope cutoff filtering, TDRA AM smoothing, and Cummins B independence. The V6.1.12 TDRA TextGrid export tier-numbering correction, V6.1.11 interval-duration labels halfway between neighbouring markers above the vertical marker lines with automatic suppression, and the TextGrid-load TDRA refresh fix are retained; TextGrid loading still preserves/redraws TDRA markers. Five vertical display rows, rotated summary table with Basis / contour row wrapping, exports, and vertically stacked final Algorithm documentation card are retained. Selected/zoom intervals are analysed when active, and all reported times remain absolute in the original signal.
TGAplus V6.0.10 — F0 Derivative Alignment. Refined the Sound-tab F0 derivative display so it is comparable with the AM derivative: smoothed F0 is aligned to the AM/envelope feature grid where available, differentiated by adjacent first difference, and plotted with display normalisation. Hz/s values remain available in summaries.
TGAplus V6.0.7 — Annotation Layout. Moved the Segmentation Settings and Alignment cards from Sound to Annotation, directly below the Annotation Inspection / Editing Workspace.
TGAplus V6.0.6 — F0 Selection Sync. Made the Sound-tab F0 contour a full active peer in the shared time-domain selection system, with F0-specific Zoom In, Zoom Out, Zoom Selection, Zoom All, Clear Selection, Play Selection and Stop controls.
TGAplus V6.0.3. Made the app genuinely TGA-only, added DOM-reference validation, removed obsolete rhythm-analysis runtime paths, and fixed the WAV loading/display path by separating audio decode, display, F0 and annotation-sync stages.
TGAplus V6.0.0. The initial TGA-focused split release retained transcription/TextGrid input, WAV-assisted annotation, annotation inspection/editing, Time Group Analysis, Time Trees, Time Group playback and TGA exports.
Earlier V5 releases. The V5 development line added unified pasted-text input, automated Process-card status, Sound/Annotation separation, TextGrid/WAV compatibility warnings, Time Group playback and display cleanup.
Current package: tgaplus_v7_1_5_wagner_tier_scope_consistency.