You are viewing an old version of this page. View the current version.

Compare with Current View Page History

« Previous Version 18 Next »

BioMate

Lab-bench biologists find it difficult to use many existing tools for their data analysis. These tools are generally command-line computer programs written by computational biologists. Computational biologists do not have time to create user-friendly interfaces for their programs, and often find themselves spending a lot of time helping lab-bench biologists run their programs. This creates a burden for all involved: lab-bench biologists cannot move forward with their data analysis, and computational biologists cannot move forward with their research.

html: Security restricted macro is not allowed. An edit restriction is required that matches the macro authorization list.

<MCE:STYLE></MCE:STYLE><STYLE mce_bogus="1"><!--
.pagetree2 a

Unknown macro: {font-size}

--></STYLE>

Unknown macro: {pagetree2}

Click on a page above for a specific section.

Paper Prototyping

Prototype Photos


This is the home screen that both computational biologists and lab-bench biologists see. Our first high-level task was for computational biologists to add a new script, so they clicked "Add/Edit Script".


This is the screen that computational biologists see after clicking "Add/Edit Script". By clicking "Add text" and "Add parameters", they can construct the command structure that lab-bench biologists will use to run their script. They can also enter caveats and user instructions for the lab-bench biologist, then save or share the script.


This is the popup that a computational biologist sees when clicking "Add text" from the "Add/Edit script" screen. This is where they enter static text in the command such as "perl montecarlo.pl" or "| less".


This is the popup that a computational biologist sees when clicking "Add parameter" from the "Add/Edit script" screen. This is where they enter information about each of the parameters that the lab-bench biologist will have the option of setting when running the script.


This is the popup that a computational biologist sees when clicking "Share" from the "Add/Edit script" screen. Here they have the option of sharing the script with their existing contacts in BioMate or entering an email address.


This is the home screen that both computational biologists and lab-bench biologists see. Our second high-level task was for lab-bench biologists to run a script, so they clicked "Run Script".


This is the screen that lab-bench biologists see after clicking "Run Script". By clicking "My Notes on Monte Carlo", they can view any notes they have previously created on the Monte Carlo script. By clicking "Instructions", they can view any caveats or instructions written by the programmer. Then the lab-bench biologist can enter the parameters and generate the command.


This is the popup that a lab-bench biologist sees when clicking on "Instructions" from the "Run script" screen. It shows both caveats and instructions shared by the computational biologist.


This is the popup that a lab-bench biologist sees when clicking "Generate Command" after entering the required and optional parameters. Here they can copy the command and paste it into a terminal to run. They also have the option of saving the command to their notes.


This is the popup that a lab-bench biologist sees when adding a note on a particular script. They can see all previous notes on this script as well as previous versions of the command they have saved to their notes.


This is the popup a lab-bench biologist sees when clicking on "Save Parameters" from the "Run Script" screen. This allows them to save all the parameters for a particular run with a unique name.


This is the popup that a lab-bench biologist sees when clicking on "Load Parameters" from the "Run Script" screen. This allows them to load parameter that they have previously saved for the given script.

Briefing

Lab-Bench Biologist

You are a lab-bench biologist. You frequently collaborate with a computational biologist in another lab who writes scripts to analyze the data that you have generated in your lab. Sometimes you want to be able to run these scripts yourself because you want to analyze many different datasets and don’t want to bother your collaborator each time you have some new data. The problem is that you are not comfortable using a command-line interface, but your collaborator does not have time to create a fancy GUI for you to run each of their scripts.

We have provided a tool here that allows your collaborator to easily create a GUI for their script and share it with you. You will use the GUI to input the parameters that you want to run the script with. After specifying the parameters, you will be able to press a button to generate the correct command-line syntax for running the script, which you will then cut and paste into the terminal to run.

Compuational Biologist

You are a computational biologist. You frequently collaborate with lab-bench biologists in another lab and write scripts to analyze the data that they have generated in their lab. Sometimes your collaborators want to be able to run these scripts themselves because they may want to analyze many different datasets and don’t want to bother you each time they have some new data. The problem is that your collaborators are not comfortable using a command-line interface, but you do not have time to create a fancy GUI for them to run each of your scripts.

We have provided a tool here that allows you to specify the command-line structure of your script and generate a user-friendly GUI for your biologists. The biologists will use the GUI to input the parameters they want to run the script with. After specifying the parameters, the biologists will be able to press a button to generate the correct command-line syntax for using your script, which they will then cut and paste into the terminal to run.

Scenario Tasks

Lab-Bench Biologist

  1. You would like to run a simulation using a Monte Carlo script which has been written for you. First, find the interface for that script.
  2. Now, make a note for yourself saying that you are going to try running the script on the file ‘abc.txt’ in your home directory.
  3. Next, generate the command for the script which prints verbose output to the terminal, runs for 2000 iterations, and is run on the file ‘abc.txt.’
  4. You realize that the command as generated above causes the script to run for too long. Make a note for yourself saying that 2000 iterations takes too long. Also include the command you just used.
  5. You are leaving for the day, but would like to return to work on this tomorrow. Save your current configuration so you don’t have to input all the settings you currently have all over again when you come back.
  6. It’s a new day! Now, go back to the Monte Carlo script interface, but this time generate the command which does the same thing as you did yesterday except runs the script for only 100 iterations.

Computational Biologist

  1. Create a new interface for a Monte Carlo script you have written.
  2. Build the interface for the command ‘perl /home/X/montecarlo.pl [-v] <INPUT_FILE> | less’, where “-v” is a flag for verbosity and “<INPUT_FILE>” is a required parameter and specifies the file path. Make sure that the lab-bench biologist knows that this path is absolute.
  3. Edit the Monte Carlo script interface you just created to add an optional parameter which will allow the lab-bench biologist to specify the number of iterations the script runs for. The flag for this is “-n” and the default value should be 100.
  4. Make sure the lab-bench biologist is aware that this command will print its output to the terminal. Also, it should be suggested to not run the simulation for more than 10,000 iterations. Finally, add a description explaining what a Monte Carlo simulation does, and leave your contact information for the lab-bench biologist in case they require clarifications.
  5. Share the Monte Carlo script interface you have created with your collaborator “V”.

Observations: Monday's User Testing Session (Round 1)

Takeaways

  • Most users do not notice the help buttons until they are really stuck, and sometimes not even then. Important help information should be displayed up-front.
  • The interface for computational biologists is extremely hard to figure out if you don’t see the tooltips, but the task flows smoothly after the help buttons are found.
  • The most helpful parts of the help buttons for the computational biologists are the examples.
  • The ‘drag and drop’ in the interface for computational biologists constructing the command structure has a visible affordance.
  • A ‘save as’ option for the computational biologist might be nice.
  • Most users do not notice the “Browse” button if they already have a file name in mind.
  • The “Notes” button on the lab-bench biologist interface could be made more noticeable.
  • The people testing the lab-bench biologist interface had a very easy time. However, our scenario may have been too simple.

User Testing Descriptions

User 1

Role: Computational Biologist
Observations
  • The name “Add/Edit Script” was effective for creating a GUI for a script, user clicked it appropriately.
  • Could guess correctly the purpose of “Add Text” and “Add Parameters” button in the “Command Structure” panel
  • Only noticed the “?” (help button) in front of “Alias” when unsure about the meaning, found the help message confusing, asked for clarification.
  • Was confused by the “| less” part of the command we presented as part of the sample task, thought of it as a parameter first and clicked on “Add Parameters” button.
  • Set the type of inputfile to “string” (we had expected the type to be set to “file”).
  • Asked, “What happens when you double click on the parts in the command structure?”. This feature was not implemented for the prototype. But we plan to give the user ability to modify that part when it is double clicked.
  • Was confused whether clicking “Save” will automatically save the GUI since there was no feedback (this was an error of the computer forgetting to write “saved @timestamp” onto the screen)
Feedback

Make the help message clearer (was adjusted on the fly).
When type “Boolean” is selected the “default” should change to drop down list since it has only two choices (our failure to do this was a computer error).
Give feedback after clicking “Save”.

User 2

Role: Lab-bench Biologist
Observations
  • Was clear about the goal, clicked on “Run a Script” button appropriately.
  • When the GUI for “monte carlo script” was shown, was overwhelmed by the things and temporarily forgot about the task.
  • Took a while to notice the “Notes” button. Once noticed, clicked correctly on it to see the notes associated with the script.
  • Did not pay attention to the “Browse” button in front of the “input file” field. Typed the name of the input file instead.
Feedback
  • Liked the wheel and icons in the welcome screen.
  • Found the interface intuitive and quite easy to use.

User 3

Role: Computational Biologist
Observations
  • First thought the “Construct Command” panel as a textbox and tried to type the sample command in it.
  • Did not find it obvious to click on “?” for help. Wanted to see examples of what is “text” and what is “parameters”.
  • Was confused about what to put in the “Prefix” field. Did not click on help. Put “-n” first, then changed it to “-100” then looked at the “Default” field and figured out what is the correct thing to do.
  • Was confused about what to put in the “Alias” field. After spending some time finally clicked on “?” and found the help message helpful.
  • Was not sure whether a flag is a “parameter” or “text”. First looked at help for “Add Text”, then for “Add Parameters” and figured out what to do.
  • Was unsure about the type of a flag, clicked on help and was able to figure it out.
  • When presented with the task of reordering the parameters, the user’s first attempt was to click on the part in the “Command Structure” panel and drag it. The user was pleasantly surprised by the fact that the parts are actually draggable.
Feedback
  • Make the help icon more visible.
  • Give examples of what is text and what is parameter in the context of this interface.

User 4

Role: Lab-bench Biologist
Observations
  • Did not notice “Browse” button for input file. Typed “input.txt” into the textbox.
  • When told to make notes about “1000 iterations”, remembered seeing the “notes” button in the “monte carlo” interface and could locate it appropriately.
Feedback
  • Found it intuitive to use the interface.

User 5

Role: Computational Biologist
Observations
  • Faced no trouble finding the “Add/Edit Script” button.
  • Noticed the “more” button next to the instructions.
  • Was confused whether to put “-” before a prefix, looked up help for examples.
  • Was not sure what to put as “Prefix” for input file, looked for help.
  • Found the task of dragging the parts in the command structure panel and reordering them intuitive.
Feedback
  • Found the help messages wordy. The examples should be clearly visible.
  • There should be a “Save As” option so that the computational biologist can create slightly different GUIs for same script.

Changes for Round 2

Observations: User Testing on People From B Lab (Round 2)

User Testing Descriptions

Issues to Consider/Resolve

  • No labels