Projects

A project is for a single vernacular language.

Create a Project

When creating a project, you have the option to start with an empty project or to import existing lexical data.

Import Existing Data

If you have lexical data in a LIFT file (likely exported from The Combine, WeSay, FLEx, or Lexique Pro), you can click the Browse button next to "Upload existing data?" to import the data into your project.

If you choose not to import data during project creation, you may still do so later (see below).

Vernacular Language

The vernacular language is the language for which words are being collected. This is usually a local, indigenous, minority, autochthonous, heritage, or endangered language or dialect. Once a project is created, the vernacular language cannot be changed.

If you select a LIFT file to import during project creation, a drop-down menu will appear that lets you choose the project vernacular language from all the languages in the import's LDML files.

Analysis Language

The analysis language is the primary language into which the vernacular language is being translated. This is usually a regional, national, official, or majority language of the location where the vernacular is spoken. Additional analysis languages can be added after project creation (see below).

If you select a LIFT file to import during project creation, every language used in a definition or gloss will automatically be added to the project as an analysis language.

Manage a Project

When a project has been created or selected, it becomes the active project—you should see a gear icon and/or the project name in the middle of the App Bar at the top of The Combine. Clicking on the gear icon or project name brings up Project Settings for managing the project. The following settings are available for project users with sufficient permissions.

Basic Settings

Project Name

A distinguishing and descriptive name is recommended. The project name is part of the filename when you export your project.

Autocomplete

The default setting is On: When a user is entering the vernacular form of a new entry in Data Entry, this setting gives suggestions of similar existing entries, allowing the user to select an existing entry and add a new sense to that entry, rather than creating a (mostly) duplicate to something previously entered. See Data Entry for more details.

(This does not affect spelling suggestions for the gloss, since those suggestions are based on a dictionary independent of existing project data.)

Archive Project

This is only available to the project Owner. Archiving a project makes it inaccessible to all users. This can only be undone by a site administrator. Please contact a site administrator if you wish for the project to be entirely deleted from the servers.

Project Languages

The vernacular language specified at project creation is fixed.

There may be multiple analysis languages associated with the project, but only the top one in the list is associated with new data entries.

Note

If the project has glosses in multiple languages, those languages must be added here for all the glosses to show up in Data Cleanup. Click the magnifying glass icon to see all language codes present in the project.

The semantic domains language controls the language in which semantic domain titles and descriptions are displayed in Data Entry.

Project Users

Current Users

Beside each project user is an icon with three vertical dots. If you are the project Owner or an Administrator, you can click this to open a user management menu with the following options:

    Remove from project
    Change project role:
        Harvester
        Editor
        Administrator
    Make project Owner
        [only available to the Owner modifying an Administrator]

A Harvester can do Data Entry but not Data Cleanup. In project settings, they can see the project languages and workshop schedule, but cannot make any changes.

An Editor has permission to do everything that a Harvester can do, as well as Review Entries, Merge Duplicates, and Export.

An Administrator has permission to do everything that an Editor can do, as well as modify most project settings and users.

Important

There is only one Owner per project. If you "Make project Owner" another user, you will automatically change from Owner to Administrator for the project, and you will no longer be able to archive the project or make/remove Administrator on other users.

Add Users

Either search existing users (shows all users with the search term in their name, username, or email address), or invite new users by email address (they will be automatically added to the project when they make an account via the invitation).

Manage Speakers

Speakers are distinct from users. A speaker can be associate with audio recording of words. Use the + icon at the bottom of this section to add a speaker. Beside each added speaker are buttons to delete them, edit their name, and add a consent for use of their recorded voice. The supported methods for adding consent are to (1) record an audio file or (2) upload an image file.

When project users are in Data Entry or Review Entries, a speaker icon will be available in the top bar. Users can click that button to see a list of all available speakers and select the current speaker, this speaker will be automatically associated with every audio recording made by the user until they log out or select a different speaker.

The speaker associated with a recording can be seen by hovering over its play icon. To change a recording's speaker, right click the play icon (or press and hold on a touch screen to bring up a menu).

When the project is exported from The Combine, speaker names (and ids) will be added as a pronunciation labels in the LIFT file. All consent files for project speakers will be added to a "consent" subfolder of the export (with speaker ids used for the file names).

Import/Export

Import

Note

Currently, the maximum size of LIFT files supported for import is 100MB.

Note

Currently, only one LIFT file can be imported per project.

Export

After clicking the Export button, you can navigate to other parts of the website while the data is being prepared for download. When the data is gathered, the download will begin automatically. The filename is the project id.

Important

A project that has reached hundreds of MB in size may take multiple minutes to export.

Note

Project settings, project users, word flags, and custom semantic domain questions are not exported.

Export pronunciation speakers

When a project is exported from TheCombine and imported into FieldWorks, if a pronunciation has an associated speaker, the speaker name will be added as a pronunciation label. The consent files can be found in the zipped export, but will not be imported into FieldWorks.

Schedule

This is only available for editing by the project Owner, allowing a schedule to be set for a Rapid Word Collection workshop. Click the first button to select a date range for the workshop. Click the middle button to add or remove specific dates. Click the last button to clear the schedule.

Semantic Domains

In this settings tab, you can change the semantic domain language and manage custom semantic domains.

The semantic domains language controls the language in which semantic domain titles and descriptions are displayed in Data Entry.

At this time, The Combine only supports custom semantic domains that extend the established domains. For each established domain, one custom subdomain can be created, which will have .0 added to the end of the domain id. For example, domain 6.2.1.1: Growing Grain has three standard subdomains, for Rice, Wheat, and Maize. If another grain, such as Barley, is dominant among the people group gathering words, it can be added as domain 6.2.1.1.0.

For each custom domain, you can add a description and questions to help with word collection in that domain.

Note

Custom semantic domains are included in the project export and can be imported into FieldWorks. However, the questions are not included.

Custom semantic domains will be available to all project users doing Data Entry.

Note

Custom semantic domains are language-specific. If you add a custom domain in one language then change the semantic domains language, that domain will not be visible unless you change back to its language.

Project Statistics

If you are the project Owner, there will be another icon alongside the gear icon in App Bar at the top of The Combine. This opens statistics about words in the project.

In the context of these statistics, word refers to a sense-domain pair: e.g., an entry with 3 senses, each with 2 semantic domains, will be counted as 6 words.

Words per User

A table listing number of words and distinct semantic domains for each project user. Imported words have no associated user and will be counted in an "unknownUser" row.

Words per Domain

A table listing number of words in each semantic domain.

Words per Day

Line graphs showing words collected during the days specified in the workshop Schedule.

Workshop Progress

Line graphs showing cumulative words collected across the days of the workshop Schedule, as well as projections for remainder of the workshop.