1. Introduction

1. Introduction

Welcome to the “Images” portion of the Images and Texts in the History of Medicine Workshop! We’ll proceed together through the tutorials and other materials contained in this website. Please don’t move on to the next tutorial until we’ve regrouped and started it together.

Before we get started in earnest, we need to make sure everyone is set up and ready to go. Please read through this page carefully and complete the checklist that appears below.

Before We Begin

Install the Medical Heritage Virtual Machine

You should already have this VM installed. The Medical Heritage VM contains both software and a set of images that you’ll need to complete the subsequent tutorials.

If, for Some Reason, Your Images Don’t Download

Some people have mentioned that the folder that contains the images we’ll use (which is called xray.zip, decompresses into jpeg, and is housed in the images folder) didn’t download for some reason. If that’s the case for you, you can download xray.zip manually here. Please unzip xray.zip and put it inside the images folder, which is inside your medicalHeritageVM-master folder.

This is what the inside of your medicalHeritageVM-master folder should look like (although you probably won't see the files whose names are preceded by a period on your computer).
This is what the inside of your medicalHeritageVM-master folder should look like (although on your computer, you probably won’t see the files whose names are preceded by a period).

Are You Ready to Begin? A Checklist

To successfully complete the tutorials in this workshop, here’s what you need to confirm:

One

You have a folder called jpeg inside a folder called images, which is inside your medicalHeritageVM-master folder;

and

Two

You are able to navigate to medicalHeritageVM-master and, using the terminal, you can type

vagrant up

then

vagrant ssh

and see a command prompt that looks like this:

Your terminal or command prompt should display a tilde and a dollar sign.
Your terminal or command prompt should display a tilde (~) and a dollar sign.

or

Three

(if you haven’t been able to SSH into your virtual machine) you are able to start your virtual machine from the VirtualBox interface, click on Machine and then Show, and see a command prompt that looks like this:

This is the window that launches when you click Machine and then Show from the VirtualBox application.
This is the window that launches when you click Machine and then Show from the VirtualBox application. Remember: the login is vagrant and the password is vagrant.

If you need a refresher on how to use your terminal or command prompt to navigate into the medicalHeritageVM-master file, please see steps four through seven on this page.

If you need a refresher on how to get to the VirtualBox interface and launch an interactive window, please see this post.

When You’re Ready

If you have completed both item one and either item two or item three, please signal that you’re ready by attaching a yellow (green?) Post-It note to your laptop.

If you’re stuck and none of the tutorials linked above solve your problem, please signal your distress by attaching a pink Post-It note to your laptop.

Once you’re where you need to be, leave your terminal or VirtualBox window open. We won’t use it for a little bit, but it will be ready to go when we’re ready.

While you’re waiting for other people to finish, please investigate the following projects: