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.

Note:
You may continue with no mappings. Create mode then creates only records; update mode makes no tier mappings. The wizard asks for confirmation before proceeding.
Figure 1. TextGrid Import — Tier Mapping
TextGrid Import — Tier 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 Tools > PhonShell Scripts after the menu refreshes; when run, it asks for a TextGrid and repeats the same import in the current session.