Import from TextGrid
The Import from TextGrid wizard imports interval tiers from a Praat TextGrid into the open session. Open it from the Interval Tiers menu in Speech Analysis.
The complete workflow contains Select File, Import Mode, Options, Tier Mapping, and Import pages. The wizard skips Options and Tier Mapping when you import only session-level interval tiers.
Select the TextGrid
Select Browse... and choose a .TextGrid file containing at least one interval tier. If a TextGrid beside the session media has the same base name as the media file, Phon loads it automatically.
The preview lists each interval tier and its number of intervals, and shows the TextGrid time range. Point tiers are not available for import.
Choose an import mode
- Import all TextGrid tiers as session-level interval tiers
- Adds every imported interval tier to the session timeline without creating or changing records. Selecting Next proceeds directly to the import.
- Create records from TextGrid
- Creates records whose media segments are based on intervals from one selected TextGrid tier. Other TextGrid tiers can be mapped to record data.
- Update existing records from TextGrid
- Uses each existing record's media segment to import mapped TextGrid data into that record. This mode does not create records.
Phon remembers the last selected mode.
Configure records and the import range
The Record Creation section appears only when creating records. Select the TextGrid tier that defines record boundaries and the participant assigned to the new records. The participant button creates another participant without leaving the wizard.
By default, each interval creates one record. Enable Group contiguous intervals to join intervals separated by no more than Max gap. Padding extends the media segment before and after the interval or group. Overwrite existing record segments permits overlapping existing segments to be replaced.
For create and update modes, the Range Filter can include the entire TextGrid or a time range. Update mode also provides a record range, with optional padding around the first and last selected records. Record range is not shown while creating records because those records do not exist yet.
Map TextGrid tiers
Select Add Mapping, then choose a TextGrid tier and an import target. A source tier can be mapped to:
- Session-level Interval Tier
- Orthography
- Word Intervals
- IPA Target
- IPA Actual
- Phone Intervals
- User Tier
TextGrid tiers without a mapping remain session-level interval tiers on the timeline. Select a row to configure its import settings below the table. Depending on the target, these settings include orthographic terminators and Word Intervals, IPA-language or conversion settings, phone conversion settings, or the destination user-tier name and whether interval text is included. Use Remove to delete the selected mapping.
Run and repeat the import
The Import page runs the operation in the background and shows a progress log. At completion, Phon reports the number of records and tiers affected, includes any warnings, and moves to the first created or modified record.
After a successful import, the wizard stores the selected mode, options, range, and tier mappings in <TextGrid filename>.import.json beside the TextGrid. Those settings are restored the next time that file is selected.
Select Create script from settings... to save a reusable JavaScript import script. The default location is the project's __res/PhonShell folder. The script appears under after the menu refreshes; when run, it asks for a TextGrid and repeats the same import in the current session.
