desktop 🠖 interface documentation

Large Roster Name Generator 

Large Roster Name Generator Interface
Large Roster Name Generator Interface

Name Generator

Creates nodes of a single type

Uses Prompts:

Name Generators are one of the fundamental components of a network interview. They allow your participant to create alters, thereby describing one of the two main entities in your study's networks.

There are four name generator Interfaces in Network Canvas that can be added to your study, all of which can be configured within Architect.

Each of these Interfaces is designed for a specific type of alter elicitation, with several associated advantages and disadvantages. Although they have some configuration options that are shared with all other Network Canvas Interfaces, this article will focus on options specific to roster based name generators.

Roster name generators are useful when you have a known set of network members that you want your participant to be able to nominate. The "Small Roster Name Generator" and the "Large Roster Name Generator" Interfaces differ in two crucial ways:

Defining a Roster

Both of these interfaces require you to have a datafile that represents your roster. See our article on roster data for more information about how to create such a file. Have this file, or a suitable mock file, ready before you attempt to configure either of these interfaces.

Large Roster Name Generator

The Large Roster Name Generator, as the name implies, has been designed specifically around significantly larger datasets. If your roster contains over 100 nodes, you should consider if the Large Roster Name Generator will provide a better user experience for your participants.

Nominating an alter within this interfaces uses the following process:

  1. The primary action button triggers a search box, into which a participant can type to search for nodes based on the search options (see below) you have configured.
  2. As the participant begins typing, all node data that meets the criteria will be displayed as cards above the search box.
  3. The participant may then tap (or click) one or more cards, to nominate them. As this happens, a node button with a plus icon will appear on the right edge of the search panel, and the number will increment as each card is selected.
  4. Any nominated nodes will not be added to the interview until the plus button is clicked. Multiple searches can be completed with the search panel still open, meaning the participant does not need to click the plus button after each search - merely when they feel they have finished the task.

By default, the cards will display the name attribute from the roster data as the card title. As with the Small Roster Name Generator, the display options of these cards are completely configurable. You should display all attributes that a participant might need to disambiguate roster nodes with similar names.

The search function is also heavily configurable, allowing you to choose which attributes from the roster are indexed, as well as the accuracy (or 'fuzziness') of the search matching. These options are powerful, and should be configured carefully. Each attribute added to the searchable properties list will decrease the performance of the search function, and may make matches less accurate. Similarly, using too stringent or too lax search accuracy will compromise the ability of participants to locate nodes in the roster.

As a general rule of thumb search accuracy should increase as roster size increases, and only attributes containing terms participants are likely to search by should be included as indexed attributes.

Best Practices

Ensure that the roster data file used has name attribute to avoid seeing "No name variable!" on your cards. See our article on node labelling for more information on this topic.

Configure the display options of the cards to help improve a participant's ability to identify and disambiguate nodes within the roster.

Define and test appropriate searchable properties and search accuracy criteria to help participants locate nodes within the roster.

Try to Avoid

Avoid using this Interface with roster datasets of 100 nodes or smaller. For smaller rosters, use the Small Roster Name Generator.

Avoid using this interface on devices with a software keyboard, particularly where they also have a small (< 9") screen. The software keyboard will cover a substantial area of the screen, and make the process of searching and nominating more tedious.

Set all properties to be searchable. This will cause slow performance and less accurate search results. Ensure that you test your search feature thoroughly.