Developing your Simulation

Installing Truman

After you have completed translating your research question into an experimental design, you can begin developing your simulation based on your design.

Begin by installing Truman on your local computer.

Understanding the timeline

The Truman Platform looks and feels like a real social networking site, because it is a social networking site. Researchers can curate, create, and control every actor, post, like, comment, notification, and interaction on the social networking site.

Every one of these interactions and behaviors is defined around the moment the participant joins the site, so each participant has their own individual timeline within the study.

For example, when simulating posts to be on the website, you define when a research participant will perceive the post to have been posted. Anything given a negative time (ex: -12:30) is viewed as something posted in the past or before the participant joined the site (ex: 12 hours and 30 minutes before), while anything with a positive time (5:30) is viewed as something posted in the future or after the participant joined the site (5 hours and 30 minutes after). These posts are staggered throughout the duration of the study (with some negative times) to emulate a real experience.

As a result, the Truman platform manages parallel simulations for all study participants. Study participants don’t connect or interact with any other real participant on the site, even though they believe they do, and all participants are exposed to the same social interactions, posts, and responses (except for variations controlled by the experimental condition of the study and the participant's own posting behavior) within a controlled environment that looks and feels realistic.

Creating a Simulation: How to translate your design into simulations

A Truman simulation is the simulated social media environment that a research participant experiences.

Here is what you need to build your own simulation:

  • Actors: Actors are the simulated users on the platform that research participants believe are real people. You’ll create personas for all actors in the simulation. This includes information such as usernames, names, bios, and profile photos.

  • Posts: Posts are the simulated posts on the platform feed/timeline. All posts include images and text. When defining the simulated posts, you will need to consider the timing of the posts (as described above) and the comments left by other actors on the posts.

  • Notifications: Notifications are the behavioral feedback of the actors in response to a research participant's behavior on the platform. For example, when a participant makes a post on the feed, you can define notifications that are sent to the participant that indicate other actors on the site viewed or liked the post. This reinforces the realism of the platform and signals to the participant that there are other "people" on the website too.

Consider annotating data: You’ll likely want to annotate any subset of data you want to target. Annotating certain posts (e.g. cyberbullying posts vs. neutral posts) differently will make it easier to isolate the data you’re interested in and look back at your target data after the experiment.

See Defining your Simulation for more details on creating the simulation.

Last updated