Getting Started by Creating a Study
We have changed a few things since it was produced, but this video provides a slightly more complete overview of how to use StreetSeen. In particular, it covers logging in and downloading data in addition to study creation.
Create a User Account
Go to the Sign Up page. User accounts can be created using existing accounts on Coursera, Facebook or Twitter.
You will be directed to your Twitter account to authorize StreetSeen. You will then be redirected back to StreetSeen, where you will be prompted to enter a valid name and email address. StreetSeen usernames will be displayed throughout the site associated with user-generated content, so if you would like to change your user name, you can also do so on this screen. Click on Sign Up to finish the process.
You will be directed to your Facebook account to authorize StreetSeen. You will then be redirected back to StreetSeen, where you will be prompted to enter a valid name and email address. StreetSeen usernames will be displayed throughout the site associated with user-generated content, so if you would like to change your user name, you can also do so on this screen. Click on Sign Up to finish the process.
You will be directed to Coursera to login with your Coursera credentials. You will then be redirected back to StreetSeen, where you will be prompted to enter a valid name, username and email address. StreetSeen usernames will be displayed throughout the site associated with user-generated content. Click on Sign Up to finish the process
If you do not have an account with any of the previously mentioned providers, you can create a new account by filling in a username, email address and password. StreetSeen usernames will be displayed throughout the site associated with user-generated content. Then, click on Sign Up.
Create a Study
To create a study, you need to have an account and be logged in. If you're not, go to set one up or log in and then come back. We'll wait.
Ok, to create a new study we need to first create the question we want to ask, and then select a group of images to compare with each other.
- Click on My Studies
- Click the Create a New Study button.
- Fill in the Question for Voter. This is the question you would like study participants to answer while choosing between two photos. This cannot be changed after launching the study.
- Fill in a Name and a Description for your study.
- Select whether or not you would like to have a survey. This will make the voter take the survey to collect additional information. If you choose Yes to have a survey, it will automatically ask you to limit the vote to a certain number and you will need to enter the number of votes.
- Select whether or not you would like to Limit votes to a certain number. If you choose Yes you will need to enter the number.
- Select whether or not you would like to Share your Research. This cannot be changed once the study is created.
- Click on Create Study.
- A confirmation message will pop up indicating that your study has been successfully created and the Add Area
form is now visible.
- If you have chosen to have a survey, you will go through steps to create a survey.
- Provide survey instructions to respondents or describe how the data will be used then click on Create Survey button.
- Then you will build individual survey questions. Click the Add your first question button to add a question.
- Fill in a Survey Question and choice of Answers. Only Multiple choice answers are possible at this point in time. Please make sure your questions are multiple choice.
- A confirmation message will pop up indicating that your survey question has been successfully created.
- You can add another question or Edit/Delete questions that you have created.
- Your study has been created, but isn't much use without images. So, next, we need to add some areas. Click the Continue to regions button to add areas and images.
Creating a Survey
Areas are essential to studies. An Area defines the geographic boundaries within which the application will pull images for a study.
Areas can only be added if there is Google StreetView coverage for that area. Users will be directed to add an area immediately after creating a study, but can also access this function through the Edit Area Info tab once a study has been created.
- Fill in a Name and Description for the Area. You can come back and do this after you've drawn the polygon, but *be sure* to do it before you click Save, or you will lose your Area.
- Fill in how many images you would like and how far apart they should be.
- Find the geographic location on the map, using the controls on the Google Map to zoom in and out and move around the map (click and drag to move).
- Once you have located the desired area, we want to draw a polygon. Single clicking in the map will begin marking your polygon. The study will pull images from inside that space. (If you accidentally create a point before you are ready, you can click the Back link at the bottom of the page, and then click on Add Area in the top tabs).
- You should see a red marker in the map. Click at least two more times to make points for the corners of your polygon. Lines will be drawn between the points and the inside of the polygon will be shaded. Keep clicking until the area you want is completely shaded.
- If you would like to add more than one area, click on Save and Add Another, and repeat the above steps.
- When you have added your last area, click on Save and Return to Study, where you can curate the sets of images.
- A confirmation message will pop up indicating that your area has been successfully created.
When you add an Area to a study, it is added to the Edit Area Info tab of your study. Clicking on Edit Area Info will give you a dropdown menu of your existing areas, plus a link to Create a New One.
- To edit the images within a study, click on the Study from the My Studies page.
- Click the Edit Area Info tab, and select the Area you'd like to modify. (Study authors are directed immediately
here after adding all the areas to a Study.)
- Click on the image you would like to edit or delete.
- Click and drag in the image to rotate it to the desired view, then click on Save Changes.
- Or, delete the image by clicking on Delete Image and confirming the delete in the pop-up.
Launching a Study
To view your studies that are not yet launched, first log in, then click on My Studies. The unlaunched studies will be marked with a yellow label.
- Click on the Study Name.
- Make sure everything is set for the study.
- Click the green launch button in the top right corner of the screen.
- When a study launches, you will no longer be able to change the question, add new
areas or add, remove, or modify images. Click on Yes, launch my study.
Once a study has been launched, it is open for voting. It can be closed and it can be opened again, by clicking on the Close and Open buttons in the top right of the study view tab.
Search Existing Studies
If you know the title or author of a study, you can search for it using the search box at the top of the Available Studies page.
To clear the search filter, just clear the text and click on Search again.
To vote on a study:
- Click on Available Studies and the name of the study you want to open. The study will open on the vote page.
- Click on the image which best answers the question, or you can click on the "Skip" link to skip an image pair.
- Your vote will be recorded as soon as you click and cannot be changed once it is recorded.
There is also a study featured on the home page and voting works the same way.
There are a variety of ways you can view study results, for your own studies and for those studies with results made public by the authors. To access the results:
- Go to Available Studies or to My Studies and click on the study you would like to view.
- Click on the Analyze tab.
- There are four tabs of results*
- Summary displays each location and how many times it was chosen and the number of times it was offered as a choice.
- Download allows the user to download csv and xls files with the study results. The Location Summary contains slightly more information than the Summary tab (e.g. heading and pitch of images) while the Full Results include information about the geographic location of the voter and more details about the areas chosen and rejected.
*The Download tab is not available on most smartphones.
An individual user can only request 25,000 StreetView image requests per 24 hours. In the highly unlikely case that an individual voter exceeds this limit, the following image will be shown instead of the street image:
The voter should be able to continue voting from the same computer in 24 hours.