desktop 🠖 key concepts

Codebook 

The codebook is a centralized view in Architect that displays all entity types and variables defined in your protocol, helping you maintain consistency and plan your data analysis.

Details

The protocol's codebook provides an overview of all entities and variables defined in your protocol. This centralized view helps you ensure consistency across stages and makes it easier to plan your data analysis before deploying your interview.

Architect automatically constructs the codebook as you create variables in your protocol. To access the codebook in Architect, click the Manage codebook button at the top of a protocol file.

Clicking the Manage codebook button in Architect navigates to the codebook view
Clicking the Manage codebook button in Architect navigates to the codebook view

Entity types

The codebook organizes entities by entity type -- ego, node, and edge, and organizes variables by entity. You can edit node and edge types from the codebook using the Edit Entity button. Each node and edge type lists the stages where they are used, and you can navigate to those stages by clicking on one of the "used in" stage names.

A view of the codebook in Architect
A view of the codebook in Architect

Variables

Each variable lists the name, type, input control, and where it is used. You can navigate to any of the stages a variable is used in by clicking on one of the "used in" stage names just like the entity types.

Entity types and variables both indicate which stages they are used in.
Entity types and variables both indicate which stages they are used in.

If a variable is defined but later becomes obsolete, you can see this as an unused variable within the codebook, marked not in use. Only variables that are unused can be deleted from the codebook. Entity types can also only be deleted if they are unused in the protocol.

Variables marked 'not in use' and unused entity types can be deleted in the codebook view.
Variables marked 'not in use' and unused entity types can be deleted in the codebook view.

Network assets

Codebooks also contain a summary of network assets when external network data has been included in a protocol. The heading row of network data will be used as the variable names, and the codebook lists these variable names as a summary for each external network asset.

A summary of the variables from an external network file.
A summary of the variables from an external network file.