208
Y Science Virtual Laboratories v3.0 Instructor Utilities Brigham Young University

Instructor utilities guide

Embed Size (px)

DESCRIPTION

 

Citation preview

Page 1: Instructor utilities guide

Y Science Virtual Laboratories v3.0

Instructor Utilities

Brigham Young University

Page 2: Instructor utilities guide

i

Table of Contents

Instructor Utilities

Overview .............................................................................................................1

Introduction....................................................................................................1 Software Configurations ..................................................................................1 Electronic Assignments and the Web Connectivity Option ..................................2

Quick Start ..........................................................................................................4 Database.............................................................................................................5 Class Management ...............................................................................................6

Class Roll........................................................................................................7 Inorganic Assignments ..................................................................................11 Quantum Assignments ..................................................................................16

Gases Assignments .......................................................................................20 Titration Assignments....................................................................................24

Calorimetry Assignments ...............................................................................32 Mechanics, Circuits, and Optics Assignments...................................................38 Density Assignments .....................................................................................43

Organic Assignments.....................................................................................48 Scores..........................................................................................................54 Grading .............................................................................................................55

Utilities..............................................................................................................58 Overview ......................................................................................................58 Backup .........................................................................................................58

Restore ........................................................................................................59 Reset ...........................................................................................................59 Messages .....................................................................................................59

Web Tools ....................................................................................................61 Database......................................................................................................63

Y Science Server Administration Introduction.......................................................................................................64

Requirements ...............................................................................................64 Access and Initial Configuration .....................................................................65 Administrative Pages ..........................................................................................65

General Settings ...........................................................................................65 Server Diagnostic ..........................................................................................66 Users ...........................................................................................................66

Logs.............................................................................................................66 Database Settings .........................................................................................66 Change Password..........................................................................................67

Page 3: Instructor utilities guide

ii

Appendices

INI Variables and Management Issues ............................................................A-1

ChemLab INI File ..............................................................................................A-1

Database Issues ...............................................................................................A-1 Lab Book Issues................................................................................................A-2 Servlet Engine URL ......................................................................................A-2

Automatic Web Updates ...............................................................................A-3 Window Behavior .........................................................................................A-3 Inorganic INI Files ............................................................................................A-3

Quantum INI Files.............................................................................................A-3 Lab.ini .........................................................................................................A-4 Video.ini ......................................................................................................A-6

Spectro.ini ...................................................................................................A-7 Phosphor.ini ................................................................................................A-7 KE.ini ..........................................................................................................A-8

Diode.ini......................................................................................................A-9 Preset Experiments ......................................................................................A-9 Gases INI Files................................................................................................A-12

Gases.ini ...................................................................................................A-12 Units.ini.....................................................................................................A-17

Preset Experiments ....................................................................................A-20 Titration INI Files ............................................................................................A-22 Lab Variables.ini.........................................................................................A-22

Acids.ini or Bases.ini...................................................................................A-25 Oxidants.ini ...............................................................................................A-27 Reductants.ini............................................................................................A-29

Salts.ini .....................................................................................................A-32 Preset Experiments ....................................................................................A-33 Calorimetry INI Files .......................................................................................A-36

Lab Variables.ini.........................................................................................A-37 Metals.ini...................................................................................................A-40 Organicn.ini...............................................................................................A-41

Reactionn.ini .............................................................................................A-41 Saltn.ini.....................................................................................................A-45 Preset Experiments ....................................................................................A-46

Mechanics INI Files .........................................................................................A-50 Mechanics.ini .............................................................................................A-50 Preset Experiments ....................................................................................A-69

Page 4: Instructor utilities guide

iii

Density INI Files .............................................................................................A-74 Density.ini .................................................................................................A-74

Solids.ini....................................................................................................A-75 Colors.ini ...................................................................................................A-80 Fluids.ini....................................................................................................A-83

Preset Experiments ....................................................................................A-89 Circuits INI Files..............................................................................................A-92 Circuits.ini .................................................................................................A-92

Preset Experiments ....................................................................................A-93 Optics INI Files ...............................................................................................A-94

Optics.ini ...................................................................................................A-94 Preset Experiments ....................................................................................A-96

List of Organic Synthesis Assignments.............................................................B-1 List of Organic Qualitative Analysis Unknowns................................................C-1

Quantum Equations .......................................................................................... D-1

Answers to Preset Unknowns............................................................................E-1 Inorganic Qualitative Analysis Unknowns ............................................................E-1 Organic Qualitative Analysis Unknowns...............................................................E-2

Titration Unknowns ...........................................................................................E-5

Page 5: Instructor utilities guide

1

Instructor Utilities

Overview

Introduction Welcome to Y Science Laboratories, a set of realistic and sophisticated simulations covering

general chemistry, organic chemistry, and physics laboratories. In these laboratories, students are

put into a virtual environment where they are free to make the choices and decisions that they

would confront in an actual laboratory setting and, in turn, experience the resulting

consequences. These laboratories include simulations of inorganic qualitative analysis,

fundamental experiments in quantum chemistry, gas properties, titration experiments,

calorimetry, mechanics, planetary motion, density, electric circuits, optics, organic synthesis, and

organic qualitative analysis. These simulations are packaged in various combinations to produce

Virtual ChemLab: General Chemistry Laboratories, Virtual ChemLab: Organic Synthesis and

Organic Qualitative Analysis, Virtual Physical Science, Virtual Physics, and Virtual Earth

Science. Y Science Laboratories is the umbrella product that covers all of the simulations, and

Instructor Utilities is the administrative tool used to create classes and assignments and retrieve

the student’s work for grading for any of these products. For the remainder of this users guide,

the term Y Science refers to the particular simulation package that you have purchased.

Each of the simulation packages sold under the Y Science umbrella can be purchased as a site

license version or as a student or single user version. The site license version is intended for

institutions (high schools, colleges, universities, etc.) and the student version is intended for

individual student use, although the two will often be combined together. The site license

version, in addition to allowing multiple installations of the software at an institution, is the only

version that includes the administrative stockroom Instructor Utilities. This Users guide

describes how to manage classes and assignments in Y Science using Instructor Utilities, but

keep in mind that your product may not have all of the simulations described here.

Software Configurations Although the Y Science simulations can be used as an exploratory activity or tool for students,

the true power of the simulations is realized when students enter the virtual laboratory and

perform assignments or experiments given to them by the instructor just as they would do in an

actual laboratory setting. Because these laboratories are virtual, a wide variety of experiences can

be provided ranging from very basic and guided to very complex and open-ended. It is up to the

instructor to decide the best use of the laboratories whether it be as a pre-lab, a lab replacement, a

homework or quiz assignment, a lab supplement, or a lecture discussion activity. Because each

instructor will have a different comfort level using software in the classroom or laboratory and

will have different levels of technical support available, several different methods of

implementing the simulations at an institution have been provided. Brief descriptions of these are

listed below. Details on actually installing the software are given in the installation instructions.

Workbook Version. In this configuration, an electronic workbook is provided at the beginning of

the simulation that allows students to select experiments that correspond to laboratory

assignments in an accompanying “real” workbook. Students can also enter the laboratory,

bypassing the electronic workbook, to explore in the laboratory on their own or to perform

Page 6: Instructor utilities guide

2

custom experiments written by the instructor. This version of the software has the full

functionality of the various simulations and can also receive electronic assignments through the

Web Connectivity Option. (See the Electronic Assignments and Web Connectivity Option

section below.) The workbook configuration is the most simple to install and use and requires

almost no oversight by the instructor. The single user version of Y Science installs the software in

the workbook configuration, and the site license version can also be used to install the software

in this configuration on as many institutional computers as necessary.

Direct Access Computer Lab (A Network Version). In this implementation, a centralized database

is installed on a network drive accessible to all client computers in the local area network, and

the Y Science software is installed on any client computers needing access to the simulations.

This installation is called a direct access installation since the client software accesses the

database containing the class lists, assignments, lab books, and scores directly using a mapped or

named network drive. This version allows instructors to give assignments and receive results

electronically. This is a simple installation for computer labs and allows multiple instructors to

use the software, but there are some network security issues associated with this type of

installation. The electronic workbook is available in this installation, but the focus is for students

to receive their assignments and unknowns electronically.

Web Access Computer Lab (A Network Version). This implementation is very similar to the

direct access installation described above except in this instance, the assignment and lab book

data is passed indirectly to the database using a servlet engine running on a TomCat web server.

This installation does not require a local area network but, instead, only requires a simple

connection to the internet. This installation also corrects several security issues associated with a

direct access connection. Details on setting up and using the web connectivity feature is given in

the Instructor Utilities user guide from the management perspective and in the various

simulation user guides from the student perspective. It is strongly suggested the user guides be

reviewed before trying to implement this version. Most questions and problems can be avoided if

the user guides are studied carefully. The electronic workbook is available in this installation, but

the focus is for students to receive their assignments and unknowns electronically.

Electronic Assignments and the Web Connectivity Option As was described previously, one of the key features of the Y Science simulations is the ability to

give assignments to students using either worksheets out of an accompanying workbook or

electronically. Although worksheets are a convenient method to give assignments to students,

electronic assignments offer the largest variety of activities and the most control over them. The

purpose of the Instructor Utilities component of Y Science is to allow instructors to create

electronic assignments, submit them to students, retrieve the student lab books, and assign

scores. The ability to give assignments and retrieve results is only available when students

running the software have access to the Y Science database (see the Database section below).

Installing a direct access version in a local area network is one way of doing this; however, this

generally limits students to working in a computer lab.

A more flexible approach has been developed where the necessary information for assignments

from the instructor and the results from students can be passed indirectly through a servlet engine

running on a TomCat server. (Details on installing and setting up the servlet engine can be found

Page 7: Instructor utilities guide

3

in the Installation and Overview guide.) This method of passing data is called the Web

Connectivity Option or Web Database Access. The advantages of this method include (a) it

allows an institution to still setup the software in a computer lab without requiring read/write

privileges on a network drive (a moderate security hole) and (b) students can install their own

copies of the software and still have access to electronic assignments wherever they are as long

as they have access to the internet. The general principles upon which the Web Connectivity

Option is based are described next.

1. The database containing the class lists, assignments, lab books, and scores must still be

maintained but it can now be stored on a local computer if only one instructor will be using it

or it can be stored on a network drive if multiple instructors will be using the same servlet

engine to pass data to and from the students. See the Database section below for more

details.

2. The Web Connectivity Option works by using the servlet engine as a vehicle to receive data

from both the instructor and students and save it temporarily on the server. The instructor

will send (update) data for each class (from the main database), which the student can, in

turn, retrieve and download to their own computer. In a like manner, a student submits

(updates) their results for an assignment to the server and the instructor, in turn, will retrieve

those results and incorporate them into the main database. This synchronization of the

instructor and student databases is the responsibility of the individual users. If regular

synchronization is not performed by both the students and instructor, then unpredictable

results can occur. On the student side, this synchronization occurs automatically as long as

there is an internet connection.

3. For Instructor Utilities, the Update and Retrieve functions can be performed at two locations.

First, the Class Roll folder for each class has an Update Web button and Retrieve Web button.

Clicking these buttons performs the indicated action for the selected class. Secondly, the

Utilities drawer contains a Web Tools folder where multiple classes can be selected and the

Update and Retrieve functions performed for the selected classes.

4. The information a student must have to use the Web Connectivity Option is their username,

password, and the URL address for the servlet engine. The username and password are

assigned when a student is added to a class. Details on using the student side of the Web

Connectivity Option is given in the individual laboratory user guides. Details on setting up

classes and assignments are given in the Instructor Utilities user guide.

5. Before the Web Connectivity Option can be used, the Web Connectivity Option must be

enabled and the URL address for the servlet engine specified in the Web Tools folder. Details

on configuring the Web Connectivity Option and other important web functions are found in

the Web Tools section.

Page 8: Instructor utilities guide

4

Quick Start

Getting into the Stockroom The stockroom (shown in Figure 1), as entered via the stockroom door in the hallway, is the

laboratory management side of Y Science and is used by instructors to establish classes, make

assignments, and view the results, grades, and lab books of the students. Access to this part of

the stockroom (or Instructor Utilities) is allowed only to those individuals with administrative

rights by typing in an administrative username and password at the stockroom card reader. The

stockroom is divided into three main areas or functions:

(1) Class Management

(2) Grading

(3) Utilities

Figure 1. The stockroom main screen. The upper two drawers of the filing cabinet access

class management functions, the bottom drawer accesses database backup and

restore functions as well as other utilities, and the stack of lab books accesses

grading functions. Click the bell for help.

Page 9: Instructor utilities guide

5

Brief descriptions of these areas are given next.

Class Management Class Management functions are accessed by clicking one of the top two drawers of the filing

cabinet. Some of the functions available in these drawers include creating classes, managing

access privileges, defining assignments for the different labs, and viewing scores and lab books.

Grading The grading of a specific assignment for an entire class is accessed by clicking the stack of lab

books on the desk. Depending on the type of assignment being graded, various options are

available to make the assignment of scores as painless as possible.

Utilities Since the class lists, assignments, scores, and lab books are stored in a centralized database, basic

backup and restore functions are available to protect against accidental or intentional corruption

of the database. These functions are accessed by clicking the bottom drawer of the filing cabinet.

Other functions include broadcasting messages to a class or set of classes, handling web

connectivity for multiple classes, and changing the database location.

Database

The database that contains the classes, students, assignments, scores, and lab books is kept in the

Data folder, which is either installed with the software or in another common access location.

The database is stored as encrypted text files and cannot be accessed or modified without the

encryption key. All login information is stored in a separate file, and student lists, assignments,

and scores are stored in files for each individual class. A separate subdirectory is created for each

student inside the Data directory and contains the data for each student’s lab book. Because the

database is centralized and contains important grading information, simple backup and restore

functionality has been added to protect against accidental or intentional corruption of the

database. The backup and restore functions are not intended to protect against hardware failures.

Multiple databases can be managed using the same Instructor Utilities by changing the database

path in the Database folder in the Utilities drawer of the filing cabinet.

In a direct access client/server installation, the database (and other common files and directories)

must be kept on a mapped (PC) or named (Mac) network drive that all Y Science client

computers can access with read/write/erase privileges. In a web access client/server installation,

the database can be stored on a network drive if several instructors will need access to the

database or it can be kept on a local drive, even on a portable computer, as long as there is an

internet connection to allow for the update and retrieval of the web data. Details on using the

web connectivity functionality can be found in the Web Connectivity Option section.

Note: Multiple instances of the Instructor Utilities that are using the same database can be open

at any given time. However, during grading, adding classes and students, and making

assignments it is highly recommended that only one instance of Instructor Utilities is

open at a time.

Page 10: Instructor utilities guide

6

Class Management

Class management functions are accessed by clicking one of the top two drawers of the filing

cabinet. Inside the drawer, there are several green hanging folders and manila folders within the

hanging folders. Each hanging folder represents a class (a collection of students), and each

manila folder represents a management function for the selected class. The class management

drawer is closed by clicking the bottom of the drawer where it is labeled close. Closing the

drawer brings the instructor back to the main stockroom.

Classes are selected by clicking the hanging folder label for the indicated class (which brings that

label forward). The green arrows to the left and right of the hanging folders cycle through the list

of classes six classes at a time. A new class is created by clicking the Add Class button in the

Class Roll folder. Details on adding and managing classes follow.

The manila folders in each hanging folder perform specific class management functions. A brief

description of each folder is given. Details are found in their respective help sections.

Figure 2. The Class Management drawer showing the Class Roll manila folder.

Page 11: Instructor utilities guide

7

Class Roll. Add and delete classes; add, delete, and import students; specify usernames and

passwords; update to and retrieve from the web; assign stockroom access privileges.

Inorganic. Define and release assignments for the inorganic qualitative analysis laboratory.

Quantum. Define and release assignments for the quantum experiments.

Gases. Define and release assignments for the gases experiments.

Titration. Define and release assignments for the titration experiments.

Calorimetry. Define and release assignments for the calorimetry or thermodynamic experiments.

Mechanics. Define and release assignments for the mechanics experiments.

Density. Define and release assignments for the density experiments.

Circuits. Define and release assignments for electronic circuit experiments.

Optics. Define and release assignments for the optics experiments.

Organic. Define and release assignments for organic synthesis and organic qualitative analysis

experiments.

Scores. View scores assigned to each student for each assignment, export scores, view lab books,

and determine availability of lab books for grading.

Class Roll

Overview The class roll folder contains class and student information as well as functions for adding and

deleting classes and student records, importing student information, and defining access

privileges. (See Figure 2.) The folder is divided into three areas:

(1) class information

(2) function buttons

(3) a spreadsheet view of student records.

Details on the three areas of the folder are given in their respective sections below. An overview

of the routine or common functions performed in the class roll folder is described here.

Adding a Class. A new class is added by clicking the button in the Class Roll folder labeled Add

Class followed by filling in the Class Name, Section, and Instructor text boxes. Pressing Tab or

Enter automatically advances to the next text box. Pressing Tab or Enter in the Instructor text

Page 12: Instructor utilities guide

8

box saves the class information. The laboratories that can be accessed by this class must also be

selected.

Adding Students. Students can be added individually by clicking the Add Member button or by

clicking in an empty row of the spreadsheet. Students can also be imported from a tab-delimited

text file.

Deleting a Class. The currently selected class can be deleted by clicking the Delete Class button.

Deleting Students. The currently highlighted member can be deleted by clicking the Delete

Member button.

Modifying Information. Class information or member information can be modified by clicking

the appropriate text box and typing the correction. The Save Class or Save Member button,

respectively, may be pressed to save the modified information.

Updating and Retrieving from the Web. If the Web Connectivity Option is being used, class data

(class lists, assignments, scores, etc.) for the currently selected class can be updated to the servlet

engine by clicking on the Update Web button. Student data is retrieved from the servlet engine

by clicking on the Retrieve Web button.

Note on Organizing Classes. Since only a few individuals require access to the stockroom to

make assignments and grade lab books, it is suggested that a separate administrative class be

created for those who require access to the stockroom. Selecting the Admin rights in the Rights

section of the spreadsheet grants access to the stockroom for the selected individual. Grading

rights are also available for individuals, which grants access only to the lab books for grading.

Class Information The class information area shows the class name, section number, instructor name, and the

selected (and available) laboratory experiments for the selected hanging folder. (See Figure 2.)

The class name, section number, and instructor can be modified by clicking the appropriate text

box. Pressing Tab or Enter advances the cursor to the next text box except after the instructor

box which, instead, saves the class information to the database. Pressing the Save Class button

also saves the class information to the database. It is not necessary to perform a Save Class when

selecting the experiments that will be available to the class. These changes are saved

automatically.

Function Buttons These buttons perform most of the class roll functionality and are shown in Figure 2. A detailed

description of these buttons is given next.

Save Class. This button is active when text is being entered or modified in the class information

text boxes. Pressing this button saves the currently entered information in all three text boxes.

Import Class. This button is used to import members into the currently selected class using a tab-

delimited text file. Clicking the button brings up a dialog box which allows the import file to be

Page 13: Instructor utilities guide

9

located and selected. If errors are found during the import process, an error file is created (and

placed in the installed Y Science directory) and an appropriate error message is displayed. The

format of the import file is as follows:

Last First MI User Name Password Frog [Tab] Kermit [Tab] T [Tab] [Tab] green

Bird [Tab] Big [Tab] [Tab] [Tab] yellow

Grouch[Tab] Oscar [Tab] T [Tab] [Tab] dirty

Ernie [Tab] [Tab] [Tab] [Tab] ducky

Bert [Tab] [Tab] [Tab] [Tab] pigeon

Etc.

Only the last name and password are required with four [Tab]s on each line. Usernames are

created automatically (if the column is left blank) and middle names are truncated to initials

automatically. Class members that are imported are always given student access rights. An

import file can be easily created by importing a class list into a spreadsheet program, editing the

list to the preceding format, and saving the list as a tab-delimited text file.

Add Class. This button begins a new hanging folder for a new class.

Delete Class. This button deletes the currently selected class. A warning is given before the

deletion occurs.

Add Member. This button adds a member to the currently selected class. Text entry starts on the

left with the last name and proceeds to the right by pressing Tab or Enter. The mouse can also be

used to advance to the next field. Pressing Tab or Enter after the ID has been entered saves the

member automatically to the database. Pressing the Save Member button will also save the

member.

Save Member. When a new member is being added to a class or member information is being

modified, this button saves the current entries to the database.

Delete Member. This button deletes the currently selected member. A warning is given before

the deletion occurs.

Delete All. This button deletes all the members in the currently selected class without deleting

class information. A warning is given before the deletion occurs.

Retrieve Web. This button performs a Retrieve function from the servlet engine for the selected

class and automatically synchronizes the local database. If there is no new data to retrieve then a

warning is given. If the instructor proceeds to retrieve the data, then a force retrieve is done

which retrieves all the data from the server and synchronizes the local database replacing any

duplicate information. See the Web Tools folder in Utilities for more ways of retrieving data and

for specifying the URL address.

Page 14: Instructor utilities guide

10

Update Web. This button performs an Update function to the servlet engine for the selected class.

If there is no new data to send, then a warning is given. If the instructor proceeds to update the

server, then a force update is done which replaces all the data on the server. Note that the Update

function must be performed before students can be authenticated over the web. The update

function must also be performed any time modifications are made to the class data in order to

provide the students in the class with the most up-to-date information.

Cancel. This button cancels text entry in any of the class information or member information text

boxes.

Help. This button accesses the help screen for class rolls.

Student Records The list of members for the class is given in the spreadsheet. Listed for each member is the last

name, first name, middle initial, username, password (usually the student ID), and administrative

privileges. A member can be added by clicking the Add Member button or by clicking on a blank

line in the spreadsheet. The last name and password are required for each member. The first

name and middle initial are optional. The username is generated automatically, but it can also be

specified. The username and password is used by the member to gain access to the different

laboratories in Y Science and must be unique to each member. Selecting Admin rights for a

member gives that person administrative privileges, which means they can enter the stockroom

and create, modify, and delete classes, students, and assignments. Selecting Grading rights for a

member gives that person grading privileges, which means they can enter the stockroom and

access the grading functionality in the lab books. A user with Grading rights does not have the

ability to enter the Class Management or Utilities functions.

When adding a member, text entry is started on the left with the last name and proceeds to the

right by pressing Tab or Enter. The mouse can also be used to advance to the next field. Pressing

Tab or Enter after the password has been entered saves the member automatically to the

database. Pressing the Save Member button will also save the member. The information for a

member can be modified by clicking the appropriate text box. The change is saved by pressing

Tab or Enter until the password is saved or by pressing the Save Member button. Scrolling

through the member list is accomplished using the scroll bar.

Page 15: Instructor utilities guide

11

Inorganic Assignments

Overview The inorganic assignment folder allows the instructor to define and release inorganic qualitative

analysis unknowns to the class in the inorganic laboratory. These unknowns (or assignments) are

given to the students in the left slot of the unknown rack in the inorganic stockroom, and the

student’s work on these assignments is recorded (by the student) in the lab book. A new section

is created in the lab book for each assignment accepted by the student. A student reports their

unknown by pressing the Report button in the lab book and then selecting the cations they

determined to be present based on their analysis. After submitting their results, a score is

automatically computed by subtracting points for each incorrect positive or negative result. This

score can be changed at a later time if necessary.

Each unknown is made up of a set of cations that has been selected by the instructor and

constitutes the cations the students will be trying to separate and identify. The instructor can

assign unknowns to the students in four different ways, but the different types of unknowns only

differ by how the actual cations are assigned to the students. These four unknown types are

Figure 3. The Inorganic Assignment folder showing a Random/By Student assignment.

Page 16: Instructor utilities guide

12

Random/By Class, Random/By Student, Manual/By Class, and Manual/By Student where

Random means the cations are assigned to the students randomly based on certain criterion,

Manual means the cations are assigned manually by the instructor, By Student means a different

unknown (but from the same set of cations) is assigned to each student, and By Class means each

student in the class receives the same unknown. As part of the assignment, the instructor must

also specify the total points possible, the number of points deducted per wrong answer, the date

the assignment will be available to the students (the start date), and the date when the assignment

is due.

The inorganic assignment folder is shown in Figure 3 and can be divided into three general areas:

(a) class information, (b) assignment/archive buttons, and (c) the assignment area. The following

details are on these three areas.

Class Information In the upper-left of the inorganic assignment folder is the class information area where

information on the currently selected class is given, followed by three buttons that are used to

create, retrieve, or archive inorganic assignments. Class information cannot be modified in this

folder.

Assignment/Archive Buttons Create New Assignment. This button creates a blank assignment, which can be defined by the

instructor and then released to the class. Details on defining an inorganic assignment are given in

the Assignments section.

Retrieve Assignment. This button retrieves an inorganic assignment from a set of assignments

that have been previously archived. Details on archiving and retrieving inorganic assignments

are given in the Archiving and Retrieving Assignments section.

Archive Assignment. This button saves or archives the currently selected or defined inorganic

assignment. Details on archiving and retrieving inorganic assignments are given in the Archiving

and Retrieving Assignments section.

Assignments The general procedure for creating an assignment includes the following steps:

1. Create a blank assignment using the Create New Assignment button. (This is not necessary

if it is the first assignment.)

2. Enter a title for the assignment.

3. Specify the assignment as Random/By Class, Random/By Student, Manual/By Class, or

Manual/By Student.

4. Define the cation set.

5. Assign the unknowns as appropriate for the assignment type. (See #3.)

Page 17: Instructor utilities guide

13

6. Assign the points possible, points for deductions, the start date, and the due date.

The assignment area can be divided into the following parts: (a) Assignment Number, (b)

Assignment Title, (c) Assignment Type, (d) Student List, (e) Cation Set, (f) Function Buttons,

and (g) Points, Deductions, Start Date, and Due Date. Each of these are described in the

following list:

(a) Assignment Number. The number of the current assignment is shown in the assignment

number box. Assignments that have already been created can be accessed using the left and

right arrows next to the box. It can take several seconds to update the assignment information

as each assignment is accessed. Rapidly advancing through the assignments bypasses the

assignment update for each intermediate assignment. The assignment number only reflects

the order in which they were created. The start date determines when they are accessible to

the students.

(b) Assignment Title. Each assignment must be given a title. The title is intended as an aid to

identify the type of unknown that has been assigned, and it is also used as the default name

when archiving the assignment. (See Archiving and Retrieving Assignments for details.)

Assignment titles are entered by clicking the text box and typing the appropriate text.

(c) Assignment Type. The type of assignment is selected by clicking the Create Unknown and

Assign Unknown drop-down menus. The Create Unknown menu allows the unknown to be

assigned Randomly or Manually, and the Assign Unknown menu allows the unknown to be

assigned By Student or By Class. The combination of these two drop-down menus yields the

four different types of unknowns: Random/By Class, Random/By Student, Manual/By Class,

or Manual/By Student.

(1) Random Assignment. In a Random assignment, the cations that have been selected for the

cation set (see Cation Set below) are assigned randomly based on the Minimum and

Maximum parameters. (See Figure 3.) The Minimum and Maximum parameters only

appear on the folder when a Random unknown has been selected. The Minimum

parameter defines the minimum number of cations that can be assigned from the cation

set. A “1” would indicate that no fewer than one cation would be present in the unknown

out of the cations in the cation set, a “2” would mean that no fewer than two cations

would be in the unknown, and so on. A special case of “0” (zero) is allowed and indicates

that no cations or a water unknown could be assigned. Similar to the Minimum parameter,

the Maximum parameter defines the maximum number of cations that can be assigned as

an unknown from the cation set. Some restrictions to these parameters include (i)

Maximum cannot be greater than the number of cations in the set and (ii) Minimum

cannot be greater than Maximum. The Minimum and Maximum parameters are adjusted

by clicking the up and down arrows next to each parameter.

(2) Manual Assignment. In a Manual assignment, an unknown is assigned by selecting the

cations for each unknown manually from the cations in the cation set. (See Cation Set.)

Cations are selected from the cation set by clicking the cation tiles in the Cation Set box.

Page 18: Instructor utilities guide

14

(3) By Class. When an assignment is given by class, then every student in the class will

receive the same unknown. For a Random assignment, the unknown is randomly selected

from the cation set, and for a Manual assignment, the cations in the unknown are selected

manually.

(4) By Student. When an assignment is given by student, then every student in the class will

receive a unique unknown. For a Random assignment, each unknown is randomly

selected from the cation set, and for a Manual assignment, the cations in each unknown

are selected manually for each student.

(d) Student List. A student list (see Figure 3) is provided for By Student assignments, for making

Manual (or individual) assignments and to show the unknowns that have been assigned to

each student. The list shows three students. The middle student in the box is the currently

selected student, and there is a student before and after. Student names in red indicate an

assignment has not been given, whereas student names in blue indicate an assignment has

been given. The up and down arrows are used to scroll through the list. When an assignment

has been made (name in blue), the cations that have been assigned to that student are

highlighted in the Cation Set box. Changes in the assignments can be made up until the start

date.

(e) Cation Set. Before an unknown can be given to the students in the class, a cation set must be

defined. This is done by selecting cations from the Cation List and placing them in the Cation

Set box. Cations are selected clicking and dragging a cation tile from the list to the Cation Set

box. Cations can be removed from the Cation Set box and returned to the list by clicking and

dragging from the Cation Set to the Cation List. For Manual assignments, cations are

assigned from the Cation Set box by clicking once on the desired cation tiles. For a By Class

assignment, this cation selection process is only done once. For a By Student assignment, the

cation selection process must be done for each student. Pressing Save saves the assignment

for the indicated student (see Student List) and automatically advances the student list to the

next student. For a Random assignment, cations in the Cation Set box cannot be selected

manually, but once the assignment has been saved, the depressed tiles in the Cation Set box

indicate the cations that have been assigned to the class or to the indicated student.

(f) Function Buttons. The four function buttons are Save, Cancel, Delete, and Help. The Save

button saves the current assignment. For Random assignments, pressing the Save button

actually assigns the unknowns to the class (By Class) or to each student (By Student). The

Cancel button resets the current assignment to a blank assignment if it has not yet been

saved; otherwise, it restores the assignment to its last saved state. The Delete button deletes

an assignment that has not been released, and the Help button opens the help window for

inorganic assignments.

(g) Points, Deductions, Start Date, and Due Date. The points, deductions, start date, and due

date for the assignment are specified in these text boxes. The points are the total numbers of

points assigned for the assignment, and the deductions are the numbers of points to be

deducted for each wrong answer by the student (either a false positive or false negative). The

Page 19: Instructor utilities guide

15

minimum score possible is zero. By default, text entry starts in the title box and pressing Tab

or Enter advances the cursor to the points box, and then the deductions box. The start date is

the date (starting at midnight) the assignment will be available to the students, and the due

date is the last day the assignment will be available (ending at midnight). Enter the start date

and due date by clicking on the calendar icon in their respective boxes and choosing the

desired day. You may scroll between months by using the arrows on either side of the month

and year display at the top of the calendar box. An assignment cannot be modified, including

the start date, once it has been released to the students, but it is possible to change the due

date. An assignment can only be canceled while it is released by deleting it.

Archiving and Retrieving Assignments Defining an inorganic qualitative analysis unknown can be a time-consuming and laborious

process, especially if there are several unknowns and there are several classes for which these

unknowns need to be defined. To make this process less time consuming, inorganic assignments

can be archived, or saved, and then retrieved using the Archive Assignment and Retrieve

Assignment buttons.

To archive an assignment, define an inorganic assignment following the steps and procedures

that were described in the Assignments section. Pressing the Archive Assignment button will save

the cation set, the assignment type, the assignment title, the points, and the deductions. A dialog

box will come up asking for a name for the archive and where to save it. The assignment archive

can be stored anywhere, but the default location is the Assignment /Inorganic directory located

where the database is stored. Any number of archives can be stored with any combination of

unknowns.

To retrieve an assignment, an inorganic assignment must first be created. Pressing the Retrieve

Assignment button will bring up a dialog box where the instructor may select from any of the

available archives. Selecting an archive will automatically define the assignment based on the

information that was saved during the archive. At this point, the start date and due date for the

assignment must still be specified, and the actual unknowns must be assigned to the students by

saving the assignment (pressing the Save button) for a Random assignment or by selecting the

cations from the cation set for a Manual assignment.

Page 20: Instructor utilities guide

16

Quantum Assignments

Overview The quantum assignment folder allows the instructor to define and release text-based instructions

(or assignments) for performing a number of simulated experiments that demonstrate many of

the concepts and ideas that led to the development of quantum mechanics. The level of these

experiments can be very basic or very sophisticated, depending on the level of the class and the

purpose for performing the experiments. These assignments are given to the students using the

clipboard in the quantum stockroom, and the student’s work on these assignments is recorded

(by the student) in the lab book. A new section is created in the lab book for each assignment

accepted by the student.

The purpose of the quantum laboratory is to allow a student to explore and better understand the

foundational experiments that led up to the development of quantum mechanics. Because of the

very sophisticated nature of most of these experiments, the quantum laboratory is the most

“virtual” of the Y Science laboratory simulations. In general, the laboratory consists of an optics

Figure 4. The Quantum Assignments folder.

Page 21: Instructor utilities guide

17

table where various sources, samples, modifiers, and detectors can be placed to perform different

experiments. These devices are located in the stockroom and can be taken out of the stockroom

and placed on the optics table. The emphasis here is to teach the students to probe a sample (e.g.,

a gas, metal foil, two-slit screen, etc.) with a source (e.g., a laser, electron gun, alpha-particle

source, etc.) and detect the outcome with a specific detector (a phosphor screen, spectrometer,

etc.). Heat, electric fields, or magnetic fields can also be applied to modify an aspect of the

experiment. As in all Y Science laboratories, the focus is to allow students the ability to explore

and discover, in a safe and level-appropriate setting, the concepts that are important in the

various areas of chemistry. Complete details on the quantum laboratory, its use and limitations,

and the scope of the simulations can be found in the Quantum Users Guide.

Because these physical chemistry experiments can be complex and not necessarily intuitive to set

up properly, a set of 15 preset experiments has been defined and is accessible to the student

through the clipboard in the stockroom. These preset experiments are defined using a set of INI

variables that describe the various aspects of each experiment. Details on how to change the

preset experiments are found in Appendix A. These preset experiments can also be turned off as

will be described later.

Assignments in the quantum laboratory consist of a set of instructions outlining what is required

of the students to complete the assignment. These assignments are text based, and when a student

accepts the assignment it is displayed on the clipboard. If the student decides to proceed, the

assignment is displayed in the laboratory TV for reference during the experiment. As installed,

the quantum simulation comes with a set of predefined assignments with varying levels of

difficulty. However, the number and difficulty of experiments that can be performed in the

quantum laboratory is enormous; therefore, the ability to import custom assignments and add

them to the database of assignments has also been provided. These custom assignments can also

include custom preset experiments.

Shown in Figure 4 is an example of a quantum assignment folder. The folder can be divided into

two general areas: (1) laboratory setup and (2) assignments. Details on these two areas of the

folder are given in their respective sections.

Laboratory Setup The laboratory setup area of the quantum assignment folder consists of a class information area

for the currently selected class at the top, followed by the laboratory setup options, followed by

three buttons that are used to create a new assignment, import a custom assignment, and delete a

custom assignment. Class information cannot be modified in this folder.

Preset Experiments. The clipboard in the quantum stockroom contains a list of 15 preset

experiments that the student can select to automatically set up experiments out in the laboratory.

Deselecting this option will turn off access to these preset experiments. Details on modifying the

preset experiments available to the students are found in Appendix A. This setting can be

changed at any time.

Highlight Drop Zones. When individual items of equipment are brought from the stockroom

counter to the optics table, there are specific positions that are allowed for each type of

Page 22: Instructor utilities guide

18

equipment. To help the student see where these allowed drop zones are located, spotlights appear

on the optics table indicating the allowed positions as each item is dragged from the stockroom

counter and dropped on the optics table. Deselecting this setting turns off the spotlights. This

setting can be changed at any time.

Create New Assignment. This button creates a blank assignment that can be defined by the

instructor and then released to the class. Details on defining assignments are given in the

Assignments section.

Import Assignment. The Quantum laboratory comes with a set of predefined assignments with

varying levels of difficulty that demonstrate the concepts and ideas that led up to the

development of quantum mechanics (and beyond). However, it is recognized that the types of

experiments and their level of difficulty will most often need to be custom tailored for the level

of the class, the level of the students, and the individual teaching style of the instructor. This

button allows a custom assignment to be imported into the quantum assignment database.

Pressing the button brings up a dialog box, which allows the instructor to locate the new

assignment file and then bring it into the quantum assignment database. Once the file has been

successfully imported, it is not necessary to keep the original file. This import file must be a text-

(or ASCII-) based file with the following format:

[Assignment with a preset experiment]

1 Assignment Title 2

3 PRESET:preset_file.ini 4

5 Descriptive text of assignment without hard-returns except at paragraphs.

[Assignment without a preset experiment]

1 Assignment Title 2

3 Descriptive text of assignment without hard-returns except at paragraphs.

The first line is the assignment title and will be used to identify the assignment in the assignment

list (see Figure 4) and on the clipboard in the stockroom. The second line must be blank. The

third line is an optional line. If the word “PRESET:” is present on the third line followed by a

preset experiment file, then, when the assignment is accepted by the student, the preset

experiment will be set up automatically in the laboratory after exiting the stockroom. An

assignment does not necessarily have to have a preset assignment. It is only meant as an option

that allows different levels of experiments to be assigned to the students. If the PRESET: line is

missing then the third line in the text file is assumed to be the beginning of the assignment

description. If the PRESET: line is wrong or an invalid or missing file is found, the third line is

also interpreted as the beginning of the assignment description. Preset experiments for

assignments must be located in the Assignment/Quantum directory located in the installed Y

Science directory and must have the extension “.ini”. Note also that there should be no space

between the “PRESET:” and the file name. Details on defining preset experiments are found in

Appendix A, although several have been included with the software.

Page 23: Instructor utilities guide

19

Delete Imported. This button will delete the currently selected assignment (displayed in the

assignment list) from the quantum assignment database if the selected assignment is an imported

assignment. Imported assignments are identified with an “*” after the title. A warning will be

given before the deletion is allowed to proceed.

Assignments The general procedure for creating an assignment includes the following steps:

1. If the desired assignment is not present in the quantum assignment database, write the

assignment using the format described and import the assignment.

2. Create a blank assignment using the Create New Assignment button. (This is not necessary

if it is the first assignment.)

3. Select the desired experiment using the Select Experiment drop-down list.

4. Assign the points possible, the start date, and the due date.

Shown in Figure 4 is the assignment area for a quantum assignment. The parts of the assignment

area are the following: (a) Assignment Number, (b) Select Experiment, (c) Description Box, (d)

Function Buttons, and (e) Points, Start Date, and Due Date. Each of these is described in the

following list:

(a) Assignment Number. The number of the current assignment is shown in the assignment

number box. Assignments that have already been created can be accessed using the left and

right arrows next to the box. It can take several seconds to update the assignment information

as each assignment is accessed. Rapidly advancing through the assignments bypasses the

assignment update for each intermediate assignment. The assignment number only reflects

the order in which they were created. The start date determines when they are accessible to

the students.

(b) Select Experiment. The list of available experiments in the quantum assignment database is

contained in the Select Experiment drop-down list. Experiments are listed by title and sorted

alphabetically. Experiments with an “*” at the end are imported assignments and can be

deleted using the Delete Imported button. Experiments are selected by clicking the desired

experiment. Currently selected experiments can be replaced by clicking a new experiment.

(c) Description Box. The description box contains the text of the actual experiment for review.

No editing of the experiment description can be done in this box. If a preset experiment is

indicated as part of the experiment, it will also be listed here, but not shown to the student.

(d) Function Buttons. The four function buttons are Save, Cancel, Delete, and Help. The Save

button saves the current assignment. The Cancel button resets the current assignment to a

blank assignment if it has not yet been saved; otherwise, it restores the assignment to its last

saved state. The Delete button deletes an assignment even if it has been released, and the

Help button opens the help window for quantum assignments.

Page 24: Instructor utilities guide

20

(e) Points, Start Date, and Due Date. The points, start date, and due date for the assignment are

specified in these text boxes. The points are the total numbers of points assigned for the

assignment, and the minimum score possible is zero. The start date is the date (starting at

midnight) the assignment will be available to the students, and the due date is the last day the

assignment will be available (ending at midnight). Enter the start date and due date by

clicking on the calendar icon in their respective boxes and choosing the desired day. You

may scroll between months by using the arrows on either side of the month and year display

at the top of the calendar box. An assignment cannot be modified, including the start date,

once it has been released to the students, but it is possible to change the due date. An

assignment can only be canceled while it is released by deleting it.

Gases Assignments

Overview The gases assignment folder allows the instructor to define and release text-based instructions (or

assignments) for performing a set of simulated physical chemistry experiments that demonstrate

the behavior of ideal, real, and van der Waals gases under varying experimental conditions. The

Figure 5. The Gases Assignments folder.

Page 25: Instructor utilities guide

21

level of these experiments can be very basic or very sophisticated, depending on the level of the

class and the purpose for performing the experiments. These assignments are given to the

students using the clipboard in the gases stockroom, and the student’s work on these assignments

is recorded (by the student) in the lab book. A new section is created in the lab book for each

assignment accepted by the student.

The gas experiments included in the Y Science simulated laboratory allow students to explore

and better understand the behavior of ideal gases, real gases, and van der Waals gases (a model

real gas). The gases laboratory contains four experiments each of which includes the four

variables used to describe a gas: pressure (P), temperature (T), volume (V), and the number of

moles (n). The four experiments differ by allowing one of these variables to be the dependent

variable while the others are independent. The four experiments include (1) V as a function of P,

T, and n using a balloon to reflect the volume changes; (2) P as a function of V, T, and n using a

motor driven piston; (3) T as a function of P, V, and n again using a motor driven piston; and (4)

V as a function of P, T, and n but this time using a frictionless, massless piston to reflect volume

changes and using weights to apply pressure. The gases that can be used in these experiments

include an ideal gas; a van der Waals gas whose parameters can be changed to represent any real

gas; real gases including N2, CO2, CH4, H2O, NH3, and He; and eight ideal gases with different

molecular weights that can be added to the experiments to form gas mixtures. As in all Y Science

laboratories, the focus is to allow students the ability to explore and discover, in a safe and level-

appropriate setting, the concepts that are important in the various areas of chemistry. Complete

details on the gases laboratory, its use and limitations, and the scope of the simulations can be

found in the Gases Users Guide.

Because these gas experiments can be complex and not necessarily intuitive to set up properly, a

set of 15 preset experiments has been defined and is accessible to the student through the

clipboard in the stockroom. These preset experiments are defined using a set of INI variables that

describe the various aspects of each experiment. Details on how to change the preset experiments

are found in Appendix A. These preset experiments can also be turned off as will be described

later.

Assignments in the gases laboratory consist of a set of instructions outlining what is required of

the students to complete the assignment. These assignments are text based, and when a student

accepts the assignment it is displayed on the clipboard. If the student decides to proceed, the

assignment is displayed in the laboratory TV for reference during the experiment. As installed,

Gases comes with a set of predefined assignments with varying levels of difficulty. However, the

number and difficulty of experiments that can be performed in the gases laboratory is large;

therefore, the ability to import custom assignments and add them to the database of assignments

has also been provided. These custom assignments can also include custom preset experiments.

Shown in Figure 5 is an example of a gases assignment folder. The folder can be divided into

two general areas: (1) laboratory setup and (2) assignments. Details on these two areas of the

folder are given in their respective sections.

Page 26: Instructor utilities guide

22

Laboratory Setup The laboratory setup area of the gases assignment folder consists of a class information area for

the currently selected class at the top, followed by the laboratory setup options, followed by three

buttons that are used to create a new assignment, import a custom assignment, and delete a

custom assignment. Class information cannot be modified in this folder.

Preset Experiments. The clipboard in the gases stockroom contains a list of 15 preset

experiments that the student can select to automatically set up experiments out in the laboratory.

Deselecting this option will turn off access to these preset experiments. Details on modifying the

preset experiments available to the students are found in Appendix A. This setting can be

changed at any time.

van der Waals Parameters. One of the gases available in the gases laboratory is a van der Waals

gas. The a and b parameters used to define the van der Waals gas can be changed in the

laboratory by clicking on the cylinder label. Changing the a and b parameters here on the

assignment folder will change the default values that will be initially set for each student in the

class as they enter the laboratory. The units for the a and b parameters are as specified on the

folder.

Units. The units for the pressure, volume, and temperature variables can be changed at will by

the student using the Units buttons located on the LCD controllers. Specifying the units here on

the assignment folder will change the default units that will be initially used on the LCD

controllers for each experiment.

Create New Assignment. This button creates a blank assignment that can be defined by the

instructor and then released to the class. Details on defining assignments are given in the

Assignments section.

Import Assignment. The gases laboratory comes with a set of predefined assignments with

varying levels of difficulty that demonstrate the behavior of ideal, real, and van der Waals gases

under varying experimental conditions. However, it is recognized that the types of experiments

and their level of difficulty will most often need to be custom tailored for the level of the class,

the level of the students, and the individual teaching style of the instructor. This button allows a

custom assignment to be imported into the gases assignment database. Pressing the button brings

up a dialog box, which allows the instructor to locate the new assignment file and then bring it

into the gases assignment database. Once the file has been successfully imported, it is not

necessary to keep the original file. This import file must be a text- (or ASCII-) based file with the

following format:

[Assignment with a preset experiment]

1 Assignment Title 2

3 PRESET:preset_file.ini 4

5 Descriptive text of assignment without hard-returns except at paragraphs.

Page 27: Instructor utilities guide

23

[Assignment without a preset experiment]

1 Assignment Title 2

3 Descriptive text of assignment without hard-returns except at paragraphs.

The first line is the assignment title and will be used to identify the assignment in the assignment

list (see Figure 5) and on the clipboard in the stockroom. The second line must be blank. The

third line is an optional line. If the word “PRESET:” is present on the third line followed by a

preset experiment file, then, when the assignment is accepted by the student, the preset

experiment will be set up automatically in the laboratory after exiting the stockroom. An

assignment does not necessarily have to have a preset assignment. It is only meant as an option

that allows different levels of experiments to be assigned to the students. If the PRESET: line is

missing then the third line in the text file is assumed to be the beginning of the assignment

description. If the PRESET: line is wrong or an invalid or missing file is found, the third line is

also interpreted as the beginning of the assignment description. Preset experiments for

assignments must be located in the Assignment/Gases directory located in the installed Y Science

directory and must have the extension “.ini”. Note also that there should be no space between the

“PRESET:” and the file name. Details on defining preset experiments are found in Appendix A,

although several have been included with the software.

Delete Imported. This button will delete the currently selected assignment (displayed in the

assignment list) from the gases assignment database if the selected assignment is an imported

assignment. Imported assignments are identified with an “*” after the title. A warning will be

given before the deletion is allowed to proceed.

Assignments The general procedure for creating an assignment includes the following steps:

1. If the desired assignment is not present in the gases assignment database, write the

assignment using the format described and import the assignment.

2. Create a blank assignment using the Create New Assignment button. (This is not necessary

if it is the first assignment.)

3. Select the desired experiment using the Select Experiment drop-down list.

4. Assign the points possible, the start date, and the due date.

Shown in Figure 5 is the assignment area for a gases assignment. The parts of the assignment

area are the following: (a) Assignment Number, (b) Select Experiment, (c) Description Box, (d)

Function Buttons, and (e) Points, Start Date, and Due Date. Each of these is described in the

following list:

(a) Assignment Number. The number of the current assignment is shown in the assignment

number box. Assignments that have already been created can be accessed using the left and

right arrows next to the box. It can take several seconds to update the assignment information

as each assignment is accessed. Rapidly advancing through the assignments bypasses the

Page 28: Instructor utilities guide

24

assignment update for each intermediate assignment. The assignment number only reflects

the order in which they were created. The start date determines when they are accessible to

the students.

(b) Select Experiment. The list of available experiments in the gases assignment database is

contained in the Select Experiment drop-down list. Experiments are listed by title and sorted

alphabetically. Experiments with an “*” at the end are imported assignments and can be

deleted using the Delete Imported button. Experiments are selected by clicking the desired

experiment. Currently selected experiments can be replaced by clicking a new experiment.

(c) Description Box. The description box contains the text of the actual experiment for review.

No editing of the experiment description can be done in this box. If a preset experiment is

indicated as part of the experiment, it will also be listed here, but not displayed to the student

when they read the description in the lab.

(d) Function Buttons. The four function buttons are Save, Cancel, Delete, and Help. The Save

button saves the current assignment. The Cancel button resets the current assignment to a

blank assignment if it has not yet been saved; otherwise, it restores the assignment to its last

saved state. The Delete button deletes an assignment even if it has been released, and the

Help button opens the help window for quantum assignments.

(e) Points, Start Date, and Due Date. The points, start date, and due date for the assignment are

specified in these text boxes. The points are the total numbers of points assigned for the

assignment, and the minimum score possible is zero. The start date is the date (starting at

midnight) the assignment will be available to the students, and the due date is the last day the

assignment will be available (ending at midnight). Enter the start date and due date by

clicking on the calendar icon in their respective boxes and choosing the desired day. You

may scroll between months by using the arrows on either side of the month and year display

at the top of the calendar box. An assignment cannot be modified, including the start date,

once it has been released to the students, but it is possible to change the due date. An

assignment can only be canceled while it is released by deleting it.

Titration Assignments

Overview The titration assignment folder allows the instructor to define and release acid-base or

potentiometric assignments to classes using the titration laboratory. Titration assignments consist

of acids and/or bases or potentiometric reagents of unknown concentration. When an assignment

is released to the students, the bottles containing the unknowns will be located on the left side of

the “Unknowns” shelf in the titration stockroom, and upon accepting the assignment the

student’s work on these assignments will be recorded by the student in the lab book. A new

section is created in the lab book for each assignment accepted by the student. The students

report their assignments by clicking on the Report button in the lab book and then entering the

concentrations of the unknowns they were assigned using data gathered from their experimental

work and calculations. After submitting their results, a score can be automatically assigned based

on pre-defined automatic grading criteria. This score can be changed at a later time if necessary.

Page 29: Instructor utilities guide

25

The virtual titration laboratory allows students to perform precise, quantitative titrations

involving acid-base and electrochemical reactions. The available laboratory equipment consists

of a 50 mL buret, 5, 10, and 25 mL pipets, graduated cylinders, beakers, a stir plate, a set of 8

acid-base indicators, a pH meter/voltmeter, a conductivity meter, and an analytical balance for

weighing out solids. Acid-base titrations can be performed on any combination of mono-, di-,

and tri-protic acids and mono-, di-, and tri-basic bases. The pH of these titrations can be

monitored using a pH meter, an indicator, and a conductivity meter, all as a function of volume,

and this data can be saved to an electronic lab book for later analysis. A smaller set of

potentiometric titrations can also be performed. Systematic and random errors in the mass and

volume measurements have been included in the simulation by introducing buoyancy errors in

the mass weighings, volumetric errors in the glassware, and characteristic systematic and random

errors in the pH/voltmeter and conductivity meter output. These errors can be ignored, which

will produce results and errors typical of high school or freshman-level laboratory work, or the

buoyancy and volumetric errors can be measured and included in the calculations to produce

results better than 0.1% in accuracy and reproducibility.

Figure 6. The Titration Assignments folder.

Page 30: Instructor utilities guide

26

Because these titration experiments include a significant amount of detail, a set of 15 preset

experiments has been defined and is accessible to the student through the clipboard in the

stockroom. These preset experiments are defined using a set of INI variables that describe the

various aspects of each experiment. Details on how to change the preset experiments are found in

Appendix A. These preset experiments can also be turned off which will be described later.

The titration laboratory allows both acid-base and potentiometric titrations, however assignments

for each type of titration are essentially the same. A titration assignment consists of (1) selecting

the reagents that will be assigned to the students, (2) specifying the reagents as known or

unknown, (3) specifying the concentrations of the reagents, and (4) selecting and defining the

reagents on the stockroom shelves that will be available to the student during the assignment.

When a titration assignment has been released, the assigned reagents (usually unknowns) will

appear on the left side of the “Unknowns” shelf in the stockroom. Selecting some or all of these

reagents will constitute accepting the assignment, which will then cause the reagent bottles

available in the stockroom to be reconfigured as defined in the assignment. The student now

proceeds with the titration experiment and reports their results using the lab book.

The titration assignment folder is divided into two areas: (1) laboratory setup and (2)

assignments. Details on these two areas of the folder and on defining a titration assignment are

given below.

Laboratory Setup Shown in Figure 6 is the laboratory setup area of the titration assignment folder. Information on

the currently selected class is given at the top, followed by the laboratory setup options, followed

by three buttons that are used to create assignments and retrieve or archive titration assignments.

Class information cannot be modified in this folder. It should be noted that the settings specified

in this area of the titration folder apply to the selected class as a whole and not to a given

assignment.

Allow Presets. The clipboard in the titration stockroom contains a list of 15 preset experiments

that the student can select to automatically set up experiments out in the laboratory or to assign a

set of pre-defined unknowns. Answers for the unknowns are given in the titration section of the

Instructor’s Manual. Deselecting this option will turn off access to these preset experiments.

Details on modifying the preset experiments available to the students are found in Appendix A.

This setting can be changed at any time.

Auto save and graphing. In the titration laboratory, students have the ability to save the data

associated with a titration (volume, pH/voltage, and conductivity) to the lab book for later

analysis and to view a graph of the pH/voltage and conductivity as a function of volume during

the course of the titration. This ability to save titration data to the lab book includes

automatically reading the volume of titrant delivered from the buret. Deselecting this option will

prevent students from saving titration data to the lab book and from monitoring the titration

using the graphing function. Students will be forced to manually read the buret and record the

necessary data to the lab book.

Activity coefficients. In order to achieve the most accurate calculations of pH and voltage for the

titrations, activity coefficients, as calculated from the extended Debye-Huckle limiting law, are

Page 31: Instructor utilities guide

27

used in the equilibrium calculations. Deselecting this option will turn off the use of activity

coefficients. Turning off activity coefficients may be useful when students are expected to

perform their own equilibrium calculations and compare them to the results from the virtual

laboratory. Students also have the ability to turn activity coefficients on or off in the stockroom.

Glassware errors. Actual volumetric burets and pipets do not deliver volumes that correspond

exactly to the scale etched on the barrel. These volumetric errors are simulated in the laboratory

by assigning appropriate error functions to each piece of precision glassware available in the

laboratory. These glassware errors are unique to each student but remain constant over time.

Deselecting this option will turn off these error functions, and the buret and pipets will deliver

the volumes as indicated.

Buoyancy errors. Items that are weighed on a balance under standard air pressure are buoyed up

by the air causing the observed mass, as displayed by the balance, to be different than the true

mass. This buoyancy correction is small but does make a statistically significant contribution

when accuracies approaching 0.1% are needed. The mass readings displayed on the analytical

balance in the simulation are observed masses and have been reverse corrected from the true

mass. The balance will give the true mass when this option is deselected.

Base Barometric Pressure. The buoyancy errors applied to the balance readings require

knowledge of the density of air among other things. The density of air can be calculated using a

variety of methods, but each requires knowledge of the temperature and barometric pressure.

Therefore, in order to correct for buoyancy errors, the student must know the current temperature

and barometric pressure in the virtual laboratory. The temperature is constant at 25°C, but the

barometric pressure is assigned a new random value every day. The base or average pressure

used for assigning the daily barometric pressure is specified here. The swing in pressures that can

be assigned for any given day is ±20 Torr around the indicated base pressure.

Create New Assignment. This button creates a blank assignment that can be defined by the

instructor and then released to the class. Details on defining assignments are given in the

Assignments section.

Retrieve Assignment. This button retrieves a titration assignment from a set of assignments that

have been previously archived. Details on archiving and retrieving titration assignments are

given in the Archiving and Retrieving Assignments section.

Archive Assignment. This button saves or archives the currently selected titration assignment.

Details on archiving and retrieving qualitative analysis assignments are given in the Archiving

and Retrieving Assignments section.

Assignments The general procedure for creating an assignment includes the following steps:

1. Create a blank assignment using the Create New Assignment button. (This is not necessary

if it is the first assignment.)

Page 32: Instructor utilities guide

28

2. Enter a title for the assignment.

3. Specify the assignment as Acid/base or Potentiometric

4. Select reagents for the assignment shelf.

5. Specify the assignment as By Class or By Student.

6. Type or paste assignment instructions.

7. Define the stockroom reagents that will be available during the assignment.

8. Assign the points possible, auto-grading criterion, the start date, and the due date.

The assignment area can be divided into two general areas, each accessed by clicking on their

respective tab on the left: (1) The assignment area and (2) The stockroom shelves (the Acid/Base

or Potentiometric tab). The assignment area is used to define the major portions of the

assignment including the unknowns, points possible, grading, start date, and due date. The

stockroom shelves (either Acid/Base or Potentiometric) area is used to define the stockroom

reagents that will be available during the assignment. Details for each area are given below.

The Assignment Tab (a) Assignment Number. The number of the current assignment is shown in the assignment

number box. Assignments that have already been created can be accessed using the left and

right arrows next to the box. It can take several seconds to update the assignment information

as each assignment is accessed. Rapidly advancing through the assignments bypasses the

assignment update for each intermediate assignment. The assignment number only reflects

the order in which they were created. The start date determines when they are accessible to

the students.

(b) Assignment Title. Each assignment must be given a title. The title is intended as an aid to

identify the type of unknown that has been assigned, and it is also used as the default name

when archiving the assignment. (See Archiving and Retrieving Assignments for details.)

Assignment titles are entered by clicking on the text box and typing the appropriate text.

(c) Assignment Type. Titration assignments can be either Acid/base or Potentiometric. An

assignment is defined as Acid/base or Potentiometric by clicking on the appropriate radio

button. The default assignment type is Acid/base.

(d) Assignment Shelf. A titration assignment can consist of up to three reagent bottles usually

representing unknowns that will appear on the “Unknowns” shelf in the stockroom. For acid-

base assignments, two of these bottles can be any combination of acids and/or bases and the

third can be an inert salt. For potentiometric assignments, there can only be two bottles, one

of which must be an oxidant and the other a reductant. The third bottle is not allowed. The

three buttons in the Assignment area represent the three reagents that can be assigned as an

unknown. The first two buttons are used to select the acids and/or bases for an acid-base

Page 33: Instructor utilities guide

29

assignment or the oxidant and reductant for a potentiometric assignment, while the third

button is for the inert salt. An “x” in the box on each button indicates that a reagent has been

selected for that position on the “Unknowns” shelf, and the name of the selected reagent will

be labeled on the button.

Clicking on a reagent button will bring up a dialog box where (1) the reagent to be assigned

to that bottle can be selected from a dropdown list, (2) the concentration for the reagent can

be specified as Fixed or Random, and (3) the concentration will be labeled as Known or

Unknown to the student. A Fixed concentration means that the concentration to be assigned

to that bottle will be constant and the same for each student. A Random concentration

indicates that the concentration will be assigned randomly within a concentration range

specified by a minimum and maximum concentration. A Random unknown or known can be

assigned for the class or uniquely for each student (see Unknown Type below). Note that

concentrations for aqueous reagents are specified in molarity and the concentrations for

solids are in weight percent. Clicking on the dropdown arrow to the left of the Assignment

Shelf buttons will drop down the details (concentration, unknown type, and its known or

unknown designation) associated with each assigned reagent.

(e) Unknown Type. Concentrations for bottles on the Assignment Shelf and on the stockroom

shelves can be specified manually (Fixed) or they can be assigned randomly. Fixed

concentrations are the same for each student in the class, but concentrations assigned

Randomly can be the same or unique for each student. The Assign Unknown dropdown list

allows the concentrations that are generated randomly to be the same for the entire class (By

Class) or to be unique for each student (By Student).

(f) Student List. A student list (not shown in Figure 6 but an example can be seen in Figure 3) is

provided for By Student assignments to show the unknowns that have been assigned to each

student. The list shows three students. The middle student in the box is the currently selected

student, and there is a student before and after. Student names in red indicate an assignment

has not been given, whereas student names in blue indicate an assignment has been given.

The up and down arrows are used to scroll through the list. When an assignment has been

made (name in blue), the concentrations that have been assigned to that student are given in

the reagent bottle drop down list. Changes in the assignments can be made up until the start

date.

(g) Tools Available. In titration experiments, the equivalence point can be determined using

various techniques. For acid-base titrations, a pH meter, indicators, and a conductivity meter

are available. For potentiometric titrations, a voltmeter and a conductivity meter are

available. The Tools Available section is used to specify which of the allowed techniques

will be available for an assignment. The default is all that all techniques are available.

(h) Assignment Instructions. As part of an assignment, it is possible to include instructions for

the student to use as they do their experimental work. These instructions are not a mandatory

part of the assignment but are optional depending on the level of guidance that is needed for

a particular assignment. Instructions are simply typed or pasted into the Instructions text box.

These instructions will be available for viewing on the clipboard in the stockroom when

Page 34: Instructor utilities guide

30

assigned unknowns are on the “Unknowns” shelf, and they will be available on the TV in the

laboratory after an assignment has been accepted.

(i) Function Buttons. The four function buttons are Save, Cancel, Delete, and Help. The Save

button saves the current assignment. For Random assignments, pressing the Save button

assigns the unknowns to the class (By Class) or to each student (By Student). The Cancel

button resets the current assignment to a blank assignment if it has not yet been saved;

otherwise, it restores the assignment to its last saved state. The Delete button deletes an

assignment even if it has been released, and the Help button opens the help window for

titration assignments.

(j) Points and Auto-grading. Scoring for an assignment is specified in these boxes. The points

are the total number of points possible for the assignment. The Auto-grade check box is used

to turn on auto-grading. If auto-grading is turned off, then it is the instructor’s responsibility

to inspect the student’s results and assign a score (see Grading). If auto-grading is turned on,

then the % Error and Deduct values must be included as part of the assignment. Auto-grading

works by subtracting the number of points specified in the Deduct box from the total points

possible for every interval the student’s answer is outside the range specified in % Error. For

example, using the % Error of 1 and a Deduct value of 2 shown in Figure 6, if the student’s

answer were wrong by 2.2%, 4 points would be deducted. If two unknowns are assigned,

then both will be used to deduct points. The minimum score possible is zero.

(k) Start Date and Due Date. The start date and due date are used to specify when an assignment

will be available for the class. By default, text entry starts in the title box and pressing Tab or

Enter advances the cursor to the points box, and then the deductions box. The start date is the

date (starting at midnight) the assignment will be available to the students, and the due date is

the last day the assignment will be available (ending at midnight). Enter the start date and

due date by clicking on the calendar icon in their respective boxes and choosing the desired

day. You may scroll between months by using the arrows on either side of the month and

year display at the top of the calendar box. An assignment cannot be modified, including the

start date, once it has been released to the students, but it is possible to change the due date.

An assignment can only be canceled while it is released by deleting it.

The Stockroom Shelves The stockroom shelves tab in the assignment area will be labeled as either Acid/Base or

Potentiometric depending on the type of assignment that has been selected. Clicking on the tab

will bring the user to a series of buttons, each of which represents a bottle on the stockroom

shelves (see Figure 7). For acid-base assignments, there will be a set of buttons for the acid shelf,

the bases shelf, and the inert salts. For potentiometric assignments, there will be a set of buttons

for the oxidants and for the reductants. The purpose of these buttons is to allow each bottle on

the stockroom shelves to be reconfigured as necessary for the assignment defined in the

assignment area. Reagents can be deselected so they will not be available for students during the

assignment, concentrations can be changed, and concentrations can be converted into unknowns

(although these unknowns cannot be reported and graded as part of the assignment). Combined

with the unknowns that are assigned on the “Unknowns” shelf, the ability to reconfigure the

Page 35: Instructor utilities guide

31

reagents on the stockroom shelves provides an enormous amount of flexibility for the level of

assignments.

Clicking on a reagent button will bring up a dialog box where (1) the reagent availability can be

deselected (the default state is all reagents are available), (2) the concentration for the reagent

can be specified as Fixed or Random, and (3) the concentration is Known or Unknown to the

student. An “x” in the box on each button indicates that a reagent is available for the assignment.

A Fixed concentration means that the concentration to be assigned to that bottle will be constant

and the same for each student. A Random concentration indicates that the concentration will be

assigned randomly within a concentration range specified by a minimum and maximum

concentration. A Random unknown or known can be assigned for the class or uniquely for each

student. Note that concentrations for aqueous reagents are specified in molarity and the

concentrations for solids are in weight percent. Clicking on the dropdown arrow to the left of the

buttons will drop down the details (concentration, unknown type, and its known or unknown

designation) associated with each reagent.

Figure 7. The stockroom shelves definition area in the Titration Assignment folder. Shown

here are the buttons to define an acid-base assignment.

Page 36: Instructor utilities guide

32

Archiving and Retrieving Assignments Defining a titration assignment can be a time-consuming and laborious process, especially if

there are several unknowns and there are several classes for which these unknowns need to be

defined. To make this process less time consuming, titration assignments can be archived, or

saved, and then retrieved using the Archive Assignment and Retrieve Assignment buttons.

To archive an assignment, define a titration assignment following the steps and procedures that

were described in the Assignments section. Pressing the Archive Assignment button will save the

entire assignment except the start date and due date. A dialog box will come up asking for a

name for the archive and where to save it. The assignment archive can be stored anywhere, but

the default location is the Assignment/Titrations directory located where the database is stored.

Any number of archives can be stored with any combination of unknowns.

An assignment is retrieved by clicking on the Retrieve Assignment button, which will bring up a

dialog box where the instructor may select from any of the available archives. Selecting an

archive will automatically define the assignment based on the information that was saved during

the archive. At this point, the start date and due date for the assignment must still be specified,

and the actual unknowns must be assigned to the students by saving the assignment (pressing the

Save button). It is not necessary that a new assignment be created first before retrieving an

archive.

Calorimetry Assignments

Overview The calorimetry assignment folder allows the instructor to define and release text-based

instructions (or assignments) for performing a set of simulated calorimetry experiments that

demonstrate the concepts important in the study of chemical thermodynamics. The level of these

experiments can be very basic or very sophisticated, depending on the level of the class and the

purpose for performing the experiments. These assignments are given to the students using the

clipboard in the calorimetry stockroom, and the student’s work on these assignments is recorded

(by the student) in the lab book. A new section is created in the lab book for each assignment

accepted by the student.

There are three different calorimeters in the virtual calorimetry laboratory that allow students to

measure various thermodynamic processes including heats of combustion, heats of solution,

heats of reaction, the heat capacity, and the heat of fusion. The calorimeters provided in the

simulations are a classic “coffee cup” calorimeter, a Dewar flask, and a bomb calorimeter. The

calorimetric method used in each calorimeter is based on measuring the temperature change in

the calorimeter caused by the different thermodynamic processes. Instructors can choose from a

wide selection of organic materials to measure the heats of combustion; salts to measure the

heats of solution; acids and bases for heats of reaction; metals and alloys for heat capacity

measurements; and ice for a melting process. Boiling point elevation and freezing point

depressions can also be assigned to be measured. Systematic and random errors in the mass and

volume measurements have been included in the simulation by introducing buoyancy errors in

the mass weighing, volumetric errors in the glassware, and characteristic systematic and random

errors in the thermometer measurements.

Page 37: Instructor utilities guide

33

Because these calorimetry experiments can be complex and not necessarily intuitive to set up

properly, a set of 15 preset experiments has been defined and is accessible to the student through

the clipboard in the stockroom. These preset experiments are defined using a set of INI variables

that describe the various aspects of each experiment. Details on how to change the preset

experiments are found in Appendix A. These preset experiments can also be turned off as will be

described later.

The calorimetry laboratory is used for measurements of the heat of combustion, the heat of

solution, the heat capacity of a metal, and the heat of reaction, however assignments for each

type of calorimetry experiment are essentially the same. A calorimetry assignment consists of (1)

selecting the type of measurement to be assigned (organic, salt, metal, reaction), (2) selecting the

reagents or metals that will be assigned to the students, (3) specifying the reagents as knowns or

unknowns, (4) specifying the points and grading option, and (5) specifying the start date and due

date. When a calorimetry assignment has been released, the assigned reagents or metals will

appear on the left side of the “Unknowns” shelf in the stockroom. Selecting one or all of these

Figure 8. The Calorimetry Assignments folder.

Page 38: Instructor utilities guide

34

reagents or metals will constitute accepting the assignment. The student now proceeds with the

calorimetry experiment and reports their results using the lab book.

The calorimetry assignment folder is divided into two areas: (1) laboratory setup and (2)

assignments. Details on these two areas of the folder and on defining a calorimetry assignment

are given below.

Laboratory Setup Shown in Figure 8 is the laboratory setup area of the calorimetry assignment folder. Information

on the currently selected class is given at the top, followed by the laboratory setup options,

followed by three buttons that are used to create assignments and retrieve or archive calorimetry

assignments. Class information cannot be modified in this folder. It should be remembered that

the settings specified in this area of the calorimetry folder apply to the selected class as a whole

and not to a given assignment.

Allow preset experiments. The clipboard in the calorimetry stockroom contains a list of 15 preset

experiments that the student can select to automatically set up experiments out in the laboratory.

Deselecting this option will turn off access to these preset experiments. Details on modifying the

preset experiments available to the students are found in Appendix A. This setting can be

changed at any time.

Auto save and graphing. In the calorimetry laboratory, students have the ability to save the

temperature versus time data from the thermometer to the lab book for later analysis and to view

a graph of the temperature as a function of time during the course of an experiment. Deselecting

this option will prevent students from saving temperature data to the lab book and from

monitoring the temperature using the graphing function. Students will be forced to manually

monitor and record the temperature in the lab book.

Glassware errors. Actual graduated cylinders do not deliver volumes that correspond exactly to

the scale etched on the cylinder. These volumetric errors are simulated in the laboratory by

assigning appropriate error functions to each piece of glassware available in the laboratory.

Deselecting this option will turn off these error functions, and the graduated cylinders will

deliver the volumes as indicated.

Buoyancy errors. Items that are weighed on a balance in air are buoyed up by the air causing the

observed mass, as displayed by the balance, to be different than the true mass. This buoyancy

correction is small but does make a statistically significant contribution when accuracies

approaching 0.1% are needed. The mass readings displayed on the analytical balance in the

simulation are observed masses and have been reverse corrected from the true mass. The balance

will give the true mass when this option is deselected.

Base Barometric Pressure. The buoyancy errors applied to the balance readings require

knowledge of the density of air among other things. The density of air can be calculated using a

variety of methods, but each requires knowledge of the temperature and barometric pressure.

Therefore, in order to correct for buoyancy errors, the student must know the current temperature

and barometric pressure in the virtual laboratory. The temperature is constant at 25°C, but the

Page 39: Instructor utilities guide

35

barometric pressure is assigned a new random value every day. The base or average pressure

used for assigning the daily barometric pressure is specified here. The swing in pressures that can

be assigned for any given day is ±20 Torr around the indicated base pressure.

Create New Assignment. This button creates a blank assignment that can be defined by the

instructor and then released to the class. Details on defining assignments are given in the

Assignments section.

Retrieve Assignment. This button retrieves a calorimetry assignment from a set of assignments

that have been previously archived. Details on archiving and retrieving calorimetry assignments

are given in the Archiving and Retrieving Assignments section.

Archive Assignment. This button saves or archives the currently selected calorimetry assignment.

Details on archiving and retrieving calorimetry assignments are given in the Archiving and

Retrieving Assignments section.

Assignments The general procedure for creating an assignment includes the following steps:

1. Create a blank assignment using the Create New Assignment button. (This is not necessary

if it is the first assignment.)

2. Enter a title for the assignment.

3. Specify the assignment type as Organics (combustion), Salts (solution), Metals (heat

capacity), or Reactions.

4. Select the reagents or metals for the assignment shelf.

5. Specify the assignment as By Class or By Student.

6. Type or paste assignment instructions.

7. Assign the points possible, auto-grading criterion, the start date, and the due date.

Shown in Figure 8 is the assignment area for a calorimetry assignment. The parts of the

assignment area are the following: (a) Assignment Number, (b) Assignment Title, (c)

Assignment Type, (d) Report In, (e) Assignment Shelf, (f) Auto-Grade and Points, (g) Assign

Unknown, (h) Student List, (i) Assignment Instructions, (j) Function Buttons, and (k) Start date

and Due Date. Each of these is described in the following list:

(a) Assignment Number. The number of the current assignment is shown in the assignment

number box. Assignments that have already been created can be accessed using the left and

right arrows next to the box. It can take several seconds to update the assignment information

as each assignment is accessed. Rapidly advancing through the assignments bypasses the

assignment update for each intermediate assignment. The assignment number only reflects

Page 40: Instructor utilities guide

36

the order in which they were created. The start date determines when they are accessible to

the students.

(b) Assignment Title. Each assignment must be given a title. The title is intended as an aid to

identify the type of measurement that has been assigned, and it is also used as the default

name when archiving the assignment. (See Archiving and Retrieving Assignments for

details.) Assignment titles are entered by clicking on the text box and typing the appropriate

text.

(c) Assignment Type. The type of measurement that can be assigned for a calorimetry assignment

includes the heat of combustion (Organics), the heat of solution (Salts), the heat capacity of a

metal (Metals), or the heat of reaction (Reactions). The assignment type is selected by

clicking on the appropriate radio button. The default assignment type is Organics (heat of

combustion).

(d) Report In. When reporting the enthalpy or heat capacity for the selected assignment type, the

answers can be reported per mole or per gram. For reagents that are assigned as unknowns

(allowed only for Organics, Salts, and Metals), reporting answers per gram is the only option.

For reactions, answers are reported per mole of the first reagent. The default unit is per mole.

(e) Assignment Shelf. The assignment shelf is used to specify the reagents or metals that will be

available for students on the “Unknowns” shelf in the stockroom for the selected assignment

type. For Organics, Salts, and Metals, up to two reagents or metals can be selected, but for

Reaction assignments only one reaction pair can be selected. If two reagents or metals are

assigned, then the heat or heat capacity of both must be reported for the assignment. For By

Class assignments, the same reagents or metals will be given to each student in the class. For

By Student assignments, the reagents or metals must be selected individually for each

student. If the Unknown box is checked, then the identity of the reagents or metals will be

hidden from the students (not available for Reaction assignments).

(f) Auto-Grade and Points. Scoring for an assignment is specified in these boxes. The points are

the total number of points possible for the assignment. The Auto-grade check box is used to

turn on auto-grading. If auto-grading is turned off, then it is the instructor’s responsibility to

inspect the student’s results and assign a score (see Grading). If auto-grading is turned on,

then the % Error and Deduct values must be included as part of the assignment. Auto-grading

works by subtracting the number of points specified in the Deduct box from the total points

possible for every interval the student’s answer is outside the range specified in % Error. For

example, using the % Error of 1 and a Deduct value of 2 shown in Figure 8, if the student’s

answer were wrong by 2.5%, then the student would lose 4 points. If two unknowns are

assigned, then both will be used to deduct points. The minimum score possible is zero. The

Compare to option specifies if the reported answers will be compared to the standard state

value or to the non-standard state value actually used in the simulation. This option is only

available when Auto-Grade has been selected.

(g) Assign Unknown. Assignments can be given to students either By Class or By Student. In a

By Class assignment, each student in the class will receive the same reagents or metals. In a

Page 41: Instructor utilities guide

37

By Student assignment, the reagents or metals can be different for each student, but the

reagents or metals must be assigned manually to each student. By default, assignments are

defined By Class.

(h) Student List. A student list (see Figure 8) is provided for By Student assignments to show the

reagents that have been assigned to each student. The list shows three students. The middle

student in the box is the currently selected student, and there is a student before and after.

Student names in red indicate an assignment has not been given, whereas student names in

blue indicate an assignment has been given. The up and down arrows are used to scroll

through the list. When an assignment has been made (name in blue), the reagents that have

been assigned to that student are given in the drop down list. Changes in the assignments can

be made up until the start date.

(i) Assignment Instructions. As part of an assignment, it is possible to include instructions for

the student to use as they do their experimental work. These instructions are not a mandatory

part of the assignment but are optional depending on the level of guidance that is needed for

a particular assignment. Instructions are simply typed or pasted into the Instructions text box.

These instructions will be available for viewing on the clipboard in the stockroom when

assigned unknowns are on the “Unknowns” shelf, and they will be available on the TV in the

laboratory after an assignment has been accepted.

(j) Function Buttons. The four function buttons are Save, Cancel, Delete, and Help. The Save

button saves the current assignment. For By Student assignments, pressing the Save button

saves the assignment for the selected student only. The Cancel button resets the current

assignment to a blank assignment if it has not yet been saved; otherwise, it restores the

assignment to its last saved state. The Delete button deletes an assignment even if it has been

released, and the Help button opens the help window for calorimetry assignments.

(k) Start Date and Due Date. The start date and due date are used to specify when an assignment

will be available for the class. By default, text entry starts in the title box and pressing Tab or

Enter advances the cursor to the points box, and then the deductions box. The start date is the

date (starting at midnight) the assignment will be available to the students, and the due date is

the last day the assignment will be available (ending at midnight). Enter the start date and

due date by clicking on the calendar icon in their respective boxes and choosing the desired

day. You may scroll between months by using the arrows on either side of the month and

year display at the top of the calendar box. An assignment cannot be modified, including the

start date, once it has been released to the students, but it is possible to change the due date.

An assignment can only be canceled while it is released by deleting it.

Archiving and Retrieving Assignments Defining a calorimetry assignment can be a time-consuming and laborious process, especially if

there are several assignments and there are several classes for which these assignments need to

be defined. To make this process less time consuming, calorimetry assignments can be archived,

or saved, and then retrieved using the Archive Assignment and Retrieve Assignment buttons.

Page 42: Instructor utilities guide

38

To archive an assignment, define a calorimetry assignment following the steps and procedures

that were described in the Assignments section. Pressing the Archive Assignment button will save

the entire assignment except the start date and due date. A dialog box will come up asking for a

name for the archive and where to save it. The assignment archive can be stored anywhere, but

the default location is the Assignment/Calorimetry directory located where the database is stored.

Any number of archives can be stored with any combination of assignments.

An assignment is retrieved by clicking on the Retrieve Assignment button, which will bring up a

dialog box where the instructor may select from any of the available archives. Selecting an

archive will automatically define the assignment based on the information that was saved during

the archive. At this point, the start date and due date for the assignment must still be specified,

and the actual reagents must be assigned to the students by saving the assignment (pressing the

Save button). It is not necessary that a new assignment be created first before retrieving an

archive.

Mechanics, Circuits, and Optics Assignments

Overview The mechanics, circuits, and optics assignment folders allow the instructor to define and release

text-based instructions (or assignments) for performing a set of simulated physics experiments

that demonstrate the concepts of mechanics, electrical circuits, and optics. The level of these

experiments can be very basic or very sophisticated, depending on the level of the class and the

purpose for performing the experiments. These assignments are given to the students using the

clipboard found in each laboratory, and the student’s work on these assignments is recorded (by

the student) in the lab book. A new section is created in the lab book for each assignment

accepted by the student. Although Mechanics, Circuits, and Optics each have their own

assignment folders, the method for delivering these assignments is essentially identical and will

be described together here.

There are five different types of experiments within the mechanics simulation: Free Motion,

Ramp Motion, Billiards Ball Motion, Falling Rod Rotational Motion, and Planetary Motion.

Each experiment operates within the general framework of the lab and many of the same objects

and forces are used with each type of experiment. The circuit laboratory allows students to build

circuits using either a breadboard or schematic representation. Using the breadboard students

will connect components as they would in an ordinary circuit laboratory by adding resistors, light

bulbs, capacitors, or inductors of any combination and a battery or function generator. When

using the schematic the students can “draw” a circuit schematic on paper as they would to plan a

circuit. The optics laboratory allows students to use lenses and mirrors to modify the images of

various objects and light sources and view the results with a virtual eye. The physics of color can

also be explored using filters and prisms. As in all Y Science laboratories, the focus is to allow

students the ability to explore and discover, in a safe and level-appropriate setting, the concepts

that form the foundation of classical physics. Complete details on these laboratories, their uses

and limitations, and the scope of the simulations can be found in the Mechanics, Circuits, or

Optics Users Guide.

Page 43: Instructor utilities guide

39

Because these physics experiments can be complex and not necessarily intuitive to set up

properly, a set of 15 preset experiments for each of these simulations have been defined and are

accessible to the student through the clipboard found in each laboratory. These preset

experiments are defined using a set of INI variables that describe the various aspects of each

experiment. Details on how to change the preset experiments are found in Appendix A. These

preset experiments can also be turned off as will be described later.

Assignments in these laboratories consist of a set of instructions outlining what is required of the

students to complete the assignment. These assignments are text based, and when a student

accepts the assignment it is displayed on the clipboard. If the student decides to proceed, the

assignment is displayed in the laboratory TV for reference during the experiment. As installed,

Mechanics, Circuits, or Optics come with a set of predefined assignments with varying levels of

difficulty. However, the number and difficulty of experiments that can be performed in the

laboratories are large; therefore, the ability to import custom assignments and add them to the

database of assignments has also been provided. These custom assignments can also include

custom preset experiments.

Figure 9. The Mechanics Assignments folder. The assignment folders for Circuits and Optics

are identical except for the sidebar options.

Page 44: Instructor utilities guide

40

Shown in Figure 9 is an example of a mechanics assignment folder. Assignment folders for

Circuits and Optics are similar. The folder can be divided into two general areas: (1) laboratory

setup and (2) assignments. Details on these two areas of the folder are given in their respective

sections.

Laboratory Setup The laboratory setup area of the assignment folder consists of a class information area for the

currently selected class at the top, followed by the laboratory setup options, followed by three

buttons that are used to create a new assignment, import a custom assignment, and delete a

custom assignment. Class information cannot be modified in this folder. The laboratory setup

options are unique to each laboratory simulation.

Preset Experiments. (All) The clipboard found in each laboratory contains a list of 15 preset

experiments that the student can select to automatically set up experiments out in the laboratory.

Deselecting this option will turn off access to these preset experiments. Details on modifying the

preset experiments available to the students are found in Appendix A. This setting can be

changed at any time.

Ideal Wires. (Circuits) In the circuit laboratory, wires can be either ideal or non-ideal. Ideal

means they connect the nodes and contribute no resistance to the circuit. Non-ideal means they

are assumed to have some small resistance as every real wire does. Deselecting this option turns

off ideal wires.

Ideal Components. (Circuits) Resistors, capacitors, and inductors can be treated as ideal or non-

ideal components. Ideal means the stated value of the component is the actual value. For non-

ideal or real components a tolerance can be set such that the value of the component is randomly

assigned to be within a certain chosen range as occurs for real components. Deselecting this

option turns off ideal components.

Show Component Values. (Circuits) For a circuit built on the breadboard, mousing over each

component will show its nominal value, and for the engineering paper the component values are

displayed next to each component. Deselecting this option will hide the component values to

force a measurement or a calculation of the component values.

Display in Centimeters. (Optics) In the optics laboratory, the units for the various objects can be

displayed in centimeters or inches. Deselecting this option will display the units in centimeter.

Note that although the units can be displayed in centimeters, the hole spacing on the optics table

is still fixed at 2 inches.

Create New Assignment. This button creates a blank assignment that can be defined by the

instructor and then released to the class. Details on defining assignments are given in the

Assignments section.

Import Assignment. Each laboratory comes with a set of predefined assignments with varying

levels of difficulty that demonstrate the various concepts in the physics of motion, circuits, and

Page 45: Instructor utilities guide

41

optics. However, it is recognized that the types of experiments and their level of difficulty will

most often need to be custom tailored for the level of the class, the level of the students, and the

individual teaching style of the instructor. This button allows a custom assignment to be

imported into the assignment database. Pressing the button brings up a dialog box, which allows

the instructor to locate the new assignment file and then bring it into the assignment database.

Once the file has been successfully imported, it is not necessary to keep the original file. This

import file must be a text- (or ASCII-) based file with the following format:

[Assignment with a preset experiment]

1 Assignment Title 2

3 PRESET:preset_file.ini 4

5 Descriptive text of assignment without hard-returns except at paragraphs.

[Assignment without a preset experiment]

1 Assignment Title 2

3 Descriptive text of assignment without hard-returns except at paragraphs.

The first line is the assignment title and will be used to identify the assignment in the assignment

list (see Figure 9) and on the clipboard. The second line must be blank. The third line is an

optional line. If the word “PRESET:” is present on the third line followed by a preset experiment

file, then, when the assignment is accepted by the student, the preset experiment will be set up

automatically in the laboratory. An assignment does not necessarily have to have a preset

assignment. It is only meant as an option that allows different levels of experiments to be

assigned to the students. If the PRESET: line is missing then the third line in the text file is

assumed to be the beginning of the assignment description. If the PRESET: line is wrong or an

invalid or missing file is found, the third line is also interpreted as the beginning of the

assignment description. Preset experiments for assignments must be located in the

Assignment/Mechanics, Assignment/Circuits, or Assignment/Optics directory located in the

installed Y Science directory and must have the extension “.ini”. Note also that there should be

no space between the “PRESET:” and the file name. Details on defining preset experiments are

found in Appendix A, although several have been included with the software.

Delete Imported. This button will delete the currently selected assignment (displayed in the

assignment list) from the assignment database if the selected assignment is an imported

assignment. Imported assignments are identified with an “*” after the title. A warning will be

given before the deletion is allowed to proceed.

Assignments The general procedure for creating an assignment includes the following steps:

1. If the desired assignment is not present in the assignment database, write the assignment

using the format described and import the assignment.

Page 46: Instructor utilities guide

42

2. Create a blank assignment using the Create New Assignment button. (This is not necessary

if it is the first assignment.)

3. Select the desired experiment using the Select Experiment drop-down list.

4. Assign the points possible, the start date, and the due date.

Shown in Figure 9 is the assignment area for a mechanics assignment. The assignment areas for

a circuits and optics assignment are identical. The parts of the assignment area are the following:

(a) Assignment Number, (b) Select Experiment, (c) Description Box, (d) Function Buttons, and

(e) Points, Start Date, and Due Date. Each of these is described in the following list:

(a) Assignment Number. The number of the current assignment is shown in the assignment

number box. Assignments that have already been created can be accessed using the left and

right arrows next to the box. It can take several seconds to update the assignment information

as each assignment is accessed. Rapidly advancing through the assignments bypasses the

assignment update for each intermediate assignment. The assignment number only reflects

the order in which they were created. The start date determines when they are accessible to

the students.

(b) Select Experiment. The list of available experiments in the assignment database is contained

in the Select Experiment drop-down list. Experiments are listed by title and sorted

alphabetically. Experiments with an “*” at the end are imported assignments and can be

deleted using the Delete Imported button. Experiments are selected by clicking the desired

experiment. Currently selected experiments can be replaced by clicking a new experiment.

(c) Description Box. The description box contains the text of the actual experiment for review.

No editing of the experiment description can be done in this box. If a preset experiment is

indicated as part of the experiment, it will also be listed here, but not shown to the student.

(d) Function Buttons. The four function buttons are Save, Cancel, Delete, and Help. The Save

button saves the current assignment. The Cancel button resets the current assignment to a

blank assignment if it has not yet been saved; otherwise, it restores the assignment to its last

saved state. The Delete button deletes an assignment even if it has been released, and the

Help button opens the help window for the assignment folder.

(e) Points, Start Date, and Due Date. The points, start date, and due date for the assignment are

specified in these text boxes. The points are the total numbers of points assigned for the

assignment, and the minimum score possible is zero. The start date is the date (starting at

midnight) the assignment will be available to the students, and the due date is the last day the

assignment will be available (ending at midnight). Enter the start date and due date by

clicking on the calendar icon in their respective boxes and choosing the desired day. You

may scroll between months by using the arrows on either side of the month and year display

at the top of the calendar box. An assignment cannot be modified, including the start date,

once it has been released to the students, but it is possible to change the due date. An

assignment can only be canceled while it is released by deleting it.

Page 47: Instructor utilities guide

43

Density Assignments

Overview The density assignment folder allows the instructor to define and release a set of solid and/or

liquid unknowns to classes using the density laboratory. Density assignments consist of solids

and/or liquids with unknown densities. When an assignment is released to the students, the

assigned solids and/or liquids are placed in graduated cylinders and the student is required to

determine the densities of the assigned materials. These assignments are given to the students

using the clipboard hanging on the wall in the laboratory, and the student’s work on these

assignments is recorded (by the student) in the lab book. A new section is created in the lab book

for each assignment accepted by the student.

The density laboratory allows students the ability to measure the mass and volume of a large set

of liquids and solids which, in turn, will allow them to explore the fundamental concepts

governing density and buoyancy. The laboratory has a set of graduated cylinders that can be

filled with various liquids such as water, corn syrup, mercury, jet fuel, tar, plus many others.

These cylinders can be filled with one or two liquids to study miscibility or the relative density

of the liquids. The laboratory also contains a large selection of solids that can be dropped into

Figure 10. The Density Assignments folder.

Page 48: Instructor utilities guide

44

these cylinders, and the students can then observe whether the solids float or sink in the selected

liquids. The density of the solids can be calculated by measuring the mass of the solids and the

volume of liquid displaced in the cylinders after the solids have been dropped into the liquid. The

density of the liquids can be determined by measuring the mass and volume of the liquid.

In order to provide students with a set of standard experiments to investigate the concepts of

density and buoyancy, a set of 15 preset experiments has been defined and is accessible to the

student through the clipboard hanging on the wall. These preset experiments are defined using a

set of INI variables that describe the various aspects of each experiment. Details on how to

change the preset experiments are found in Appendix A. These preset experiments can also be

turned off as will be described later.

The density laboratory is used for measurements of volume and mass and the combination of

these measurements is used to investigate the density of both solids and liquids. A density

assignment consists of (1) selecting whether the assigned materials will be real or virtual, (2)

specifying the assignment as the same for the class or different for each student, (3) specifying

the unknown solids and liquids, (4) specifying the points and grading option, and (5) specifying

the start date and due date. When a density assignment has been released, the assignment will

appear on the clipboard. A student accepts the assignment by clicking on the Accept button,

which will then display any assignment instructions. The student now proceeds with the density

experiment and reports their results using the lab book.

The density assignment folder is divided into two areas: (1) laboratory setup and (2)

assignments. Details on these two areas of the folder and on defining a density assignment are

given below.

Laboratory Setup Shown in Figure 10 is the laboratory setup area of the density assignment folder. Information on

the currently selected class is given at the top, followed by the laboratory setup options, followed

by three buttons that are used to create assignments and retrieve or archive density assignments.

Class information cannot be modified in this folder. It should be remembered that the settings

specified in this area of the density folder apply to the selected class as a whole and not to a

given assignment.

Preset Experiments. The clipboard in the density laboratory contains a list of 15 preset

experiments that the student can select to automatically set up experiments in the laboratory.

Deselecting this option will turn off access to these preset experiments. Details on modifying the

preset experiments available to the students are found in Appendix A. This setting can be

changed at any time.

Glassware Errors. Actual graduated cylinders do not deliver volumes that correspond exactly to

the scale etched on the cylinder. These volumetric errors are simulated in the laboratory by

assigning appropriate error functions to each piece of glassware available in the laboratory.

Deselecting this option will turn off these error functions, and the graduated cylinders will

deliver the volumes as indicated.

Page 49: Instructor utilities guide

45

Create New Assignment. This button creates a blank assignment that can be defined by the

instructor and then released to the class. Details on defining assignments are given in the

Assignments section.

Retrieve Assignment. This button retrieves a density assignment from a set of assignments that

have been previously archived. Details on archiving and retrieving density assignments are given

in the Archiving and Retrieving Assignments section.

Archive Assignment. This button saves or archives the currently selected density assignment.

Details on archiving and retrieving density assignments are given in the Archiving and

Retrieving Assignments section.

Assignments The general procedure for creating an assignment includes the following steps:

1. Create a blank assignment using the Create New Assignment button. (This is not necessary

if it is the first assignment.)

2. Enter a title for the assignment.

3. Specify the assignment type as Real or Virtual.

4. Select the fluids and/or solids that will go into the five graduated cylinders.

5. Specify the assignment as By Class or By Student.

6. Type or paste assignment instructions.

7. Assign the points possible, auto-grading criterion, the start date, and the due date.

Shown in Figure 10 is the assignment area for a density assignment. The parts of the assignment

area are the following: (a) Assignment Number, (b) Assignment Title, (c) Fluids, (d) Solids, (e)

Material Type, (f) Assign Unknown, (g) Student List, (h) Assignment Instructions, (i) Reporting,

(j) Function Buttons, (k) Auto-Grade and Points, and (l) Start Date and Due Date. Each of these

is described in the following list:

(a) Assignment Number. The number of the current assignment is shown in the assignment

number box. Assignments that have already been created can be accessed using the left and

right arrows next to the box. It can take several seconds to update the assignment information

as each assignment is accessed. Rapidly advancing through the assignments bypasses the

assignment update for each intermediate assignment. The assignment number only reflects

the order in which they were created. The start date determines when they are accessible to

the students.

(b) Assignment Title. Each assignment must be given a title. The title is intended as an aid to

identify the type of measurement that has been assigned, and it is also used as the default

Page 50: Instructor utilities guide

46

name when archiving the assignment. (See Archiving and Retrieving Assignments for

details.) Assignment titles are entered by clicking on the text box and typing the appropriate

text.

(c) Fluids. The five fluid buttons represent the five graduated cylinders in the laboratory. These

buttons are used to select the fluids that will be used for the unknowns. Clicking on any of

the buttons brings up a dialog box containing (1) a drop down list where you specify if the

fluid should be selected manually or randomly, (2) the list of available fluids, and (3) the

Save and Cancel buttons. When selecting fluids manually, you must select a fluid for each

graduated cylinder and for each student if assigning a unique unknown for each student (see

below). When selecting unknown fluids randomly, you must select a group or range of fluids

from which the program will randomly assign an unknown to the class or to each student.

These fluid assignments are made at the time the overall assignment is saved.

(d) Solids. The five solid buttons represent the five graduated cylinders in the laboratory. These

buttons are used to select the solids that will be used for the unknowns. Clicking on any of

the buttons brings up a dialog box containing (1) a drop down list where you specify if the

solid should be selected manually or randomly, (2) the list of available solids, and (3) the

Save and Cancel buttons. When selecting solids manually, you must select a solid for each

graduated cylinder and for each student if assigning a unique unknown for each student (see

below). When selecting unknown solids randomly, you must select a group or range of solids

from which the program will randomly assign an unknown to the class or to each student.

These solid assignments are made at the time the overall assignment is saved.

(e) Material Type. The type of measurement that can be assigned for a density assignment

includes Real or Virtual. A Real assignment uses real solids and fluids for the basis of the

unknowns. A Virtual assignment allows the use of virtual materials having a range of

densities and viscosities selected randomly by the program at the time the assignment is

saved. The range of densities for these materials is defined in the Fluids and Solids sections

of the assignment folder. The default assignment type is Real.

(f) Assign Unknown. Assignments can be given to students either By Class or By Student. In a

By Class assignment, each student in the class will receive the same unknown solid or fluid.

In a By Student assignment, the unknowns can be assigned randomly or manually to each

student. By default, assignments are defined By Class.

(g) Student List. A student list (not shown in Figure 10) is provided for By Student assignments

to show the unknowns that have been assigned to each student. The list shows three students.

The middle student in the box is the currently selected student, and there is a student before

and after. Student names in red indicate an assignment has not been given, whereas student

names in blue indicate an assignment has been given. The up and down arrows are used to

scroll through the list. When an assignment has been made (name in blue), the unknowns that

have been assigned to that student are given in the Fluids and Solids sections. Changes in the

assignments can be made up until the start date.

Page 51: Instructor utilities guide

47

(h) Assignment Instructions. As part of an assignment, it is possible to include instructions for

the student to use as they do their experimental work. These instructions are not a mandatory

part of the assignment but are optional depending on the level of guidance that is needed for

a particular assignment. Instructions are simply typed or pasted into the Instructions text box.

These instructions will be available for viewing on the clipboard when an assignment is

accepted, and they will be available on the TV in the laboratory while the assignment is out

in the laboratory.

(i) Reporting. When reporting the unknown densities for the selected assignment, the answers

can be reported either Numerically or on a Relative basis. Numerically means the answers

will be reported as numbers and graded against actual values. Relative means the densities

will be ranked from lowest to highest but no absolute values will need to be given. Answers

will be graded Numerically by default.

(j) Function Buttons. The four function buttons are Save, Cancel, Delete, and Help. The Save

button saves the current assignment. For By Student assignments, pressing the Save button

saves the assignment for the selected student only. The Cancel button resets the current

assignment to a blank assignment if it has not yet been saved; otherwise, it restores the

assignment to its last saved state. The Delete button deletes an assignment even if it has been

released, and the Help button opens the help window for density assignments.

(k) Auto-Grade and Points. Scoring for an assignment is specified in these boxes. The points are

the total number of points possible for the assignment. The Auto-grade check box is used to

turn on auto-grading. If auto-grading is turned off, then it is the instructor’s responsibility to

inspect the student’s results and assign a score (see Grading). If auto-grading is turned on,

then the %Error and Deduct values must be included as part of the assignment. Auto-grading

works by subtracting the number of points specified in the Deduct box from the total points

possible for every interval the student’s answer is outside the range specified in % Error. For

example, using the % Error of 3 and a Deduct value of 5 shown in Figure 10, if the student’s

answer were wrong by 6.5%, then the student would lose 10 points. If two unknowns are

assigned, then both will be used to deduct points. The minimum score possible is zero. Keep

in mind that because of inherent uncertainties in the volume measurements, typical

uncertainties in measured densities will be about 3%.

(l) Start Date and Due Date. The start date and due date are used to specify when an assignment

will be available for the class. By default, text entry starts in the title box and pressing Tab or

Enter advances the cursor to the points box, and then the deductions box. The start date is the

date (starting at midnight) the assignment will be available to the students, and the due date is

the last day the assignment will be available (ending at midnight). Enter the start date and

due date by clicking on the calendar icon in their respective boxes and choosing the desired

day. You may scroll between months by using the arrows on either side of the month and

year display at the top of the calendar box. An assignment cannot be modified, including the

start date, once it has been released to the students, but it is possible to change the due date.

An assignment can only be canceled while it is released by deleting it.

Page 52: Instructor utilities guide

48

Archiving and Retrieving Assignments Defining a density assignment can be a time-consuming and laborious process, especially if there

are several assignments and there are several classes for which these assignments need to be

defined. To make this process less time consuming, density assignments can be archived, or

saved, and then retrieved using the Archive Assignment and Retrieve Assignment buttons.

To archive an assignment, define a density assignment following the steps and procedures that

were described in the Assignments section. Pressing the Archive Assignment button will save the

entire assignment except the start date and due date. A dialog box will come up asking for a

name for the archive and where to save it. The assignment archive can be stored anywhere, but

the default location is the Assignment/Density directory located where the database is stored. Any

number of archives can be stored with any combination of assignments.

An assignment is retrieved by clicking on the Retrieve Assignment button, which will bring up a

dialog box where the instructor may select from any of the available archives. Selecting an

archive will automatically define the assignment based on the information that was saved during

the archive. At this point, the start date and due date for the assignment must still be specified,

and the actual reagents must be assigned to the students by saving the assignment (pressing the

Save button). It is not necessary that a new assignment be created first before retrieving an

archive.

Organic Assignments

Overview The organic assignment folder allows the instructor to define and release organic synthesis and

organic qualitative analysis assignments to the class in the organic laboratory. These assignments

are given to the students using the clipboard in the organic stockroom, and the student’s work on

these assignments is recorded (by the student) in the lab book. A new section is created in the lab

book for each assignment accepted by the student.

In the organic laboratory, the instructor has the option to specify whether (a) compound names

are listed as IUPAC names or common names, (b) if the TV tutorial is available to the student

during practice sessions, and (c) if the spectra library is available to the students. These settings

are independent of the assignments and can be changed at any time.

The instructor can assign to the students of a class any number of synthesis or qualitative

analysis experiments. For either type of assignment, the instructor specifies the total points

possible, the date the assignment will be available to the students (the start date), and the date

when the assignment is due. A synthesis assignment involves selecting one of 17 different

reactions, which defines a set of available starting materials, and a product that each student in

the class will make, purify, and characterize. An organic qualitative analysis assignment involves

assigning unknowns (compounds with an unknown structure) to each student either randomly or

individually, and the student, in turn, will use the analytical techniques and functional group tests

in the laboratory to determine the structure of the unknown. The organic assignment folder is

divided into two areas: (1) laboratory setup and (2) assignments. Details on these two areas of

the folder are given in their respective sections below.

Page 53: Instructor utilities guide

49

Laboratory Setup Shown in Figure 11 and Figure 12 is the laboratory setup area of the organic assignment folder.

Information on the currently selected class is given at the top, followed by the laboratory setup

options, followed by three buttons that are used to create assignments and retrieve or archive

qualitative analysis assignments. Class information cannot be modified in this folder.

Display Names As. In various parts of the organic laboratory, the names of compounds are

displayed either as pop-ups, on the chalkboard, or on the TV. Selecting IUPAC or Common

specifies in what format these names will appear. This setting can be changed at any time.

Tutorial. When Tutorial is selected, the tutorial mode is enabled on the laboratory TV and the

student has the ability to see the contents of different solutions on the lab bench when an

assignment is not out in the laboratory. During an assignment, the tutorial mode is automatically

disabled. This setting can be changed at any time.

Figure 11. The Organic Assignment folder showing a synthesis assignment.

Page 54: Instructor utilities guide

50

Spectra Library. A library of approximately 700 FTIR and NMR spectra are available to the

student through the spectra library option on the laboratory TV. Selecting Spectra Library

allows the students to have access to this library in the laboratory and to save these spectra in

their lab books. When a spectra is saved in the lab book from the spectra library, the spectra is

clearly labeled as coming from the library. Note that the spectra for the qualitative unknowns are

contained in the library; therefore, it is suggested that the library be disabled while qualitative

analysis assignments are available to the students. This setting can be changed at any time.

Create New Assignment. This button creates a blank assignment that can be defined by the

instructor and then released to the class. Details on defining a synthesis or qualitative analysis

assignment are given in the Assignments section.

Retrieve Assignment. This button retrieves a qualitative analysis assignment from a set of

assignments that have been previously archived. Details on archiving and retrieving qualitative

analysis assignments are given in the Archiving and Retrieving Assignments section.

Figure 12. The Organic Assignment folder showing a qualitative analysis experiment.

Page 55: Instructor utilities guide

51

Archive Assignment. This button saves or archives the currently selected qualitative analysis

assignment. Details on archiving and retrieving qualitative analysis assignments are given in the

Archiving and Retrieving Assignments section.

Assignments The general procedure for creating an assignment includes the following steps:

1. Create a blank assignment using the Create New Assignment button. (This is not necessary

if it is the first assignment.)

2. Specify the type of the assignment as Synthesis or Qualitative Analysis.

3. For synthesis assignments, choose the reaction and product to be made by the students.

4. For qualitative analysis experiments, choose the set of unknowns (or retrieve an archive)

and assign them to the students.

5. Assign the points possible, the start date, and the due date.

Shown in Figure 12 is the assignment area for a qualitative analysis assignment. A synthesis

assignment screen is similar (shown in Figure 11) except for the contents of the two scroll boxes

and the absence of the student list (described subsequently). The parts of the assignment area are

the following: (a) Assignment Number; (b) Assignment Type; (c) Reactions/Class Scroll Box;

(d) Products/Unknown Scroll Box; (e) Points, Start Date, and Due Date; (f) Student List; (g)

Structure Display Box; and (h) Function Buttons. Each of these is described in the following list:

(a) Assignment Number. The number of the current assignment is shown in the assignment

number box. Assignments that have already been created can be accessed using the left and

right arrows next to the box. It can take several seconds to update the assignment information

as each assignment is accessed. Rapidly advancing through the assignments bypasses the

assignment update for each intermediate assignment. The assignment number only reflects

the order in which they were created. The start date determines when they are accessible to

the students.

(b) Assignment Type. The type of assignment is selected by clicking the Synthesis or Qualitative

radio buttons. For a qualitative analysis assignment, additional information defining the

assignment is also listed. Show C–H Analysis specifies whether a C–H analysis of the

unknowns will be available to the student for this assignment. Qualitative analysis unknowns

can be assigned randomly or individually. In a random assignment, a set of unknowns is

defined by the instructor and then randomly assigned to each student in the class. In an

individual assignment, an unknown can be selected for each student in the list.

(c) Reactions Scroll Box. For a synthesis assignment, the first scroll box is labeled as

“Reactions” and lists 17 named reactions. These same reactions are listed on the clipboard in

the organic stockroom. Selecting a reaction on the clipboard defines a set of starting

materials from which the student is free to choose to perform a reaction. Although the

Page 56: Instructor utilities guide

52

starting materials were chosen to demonstrate the chemistry of the named reaction, the

student is not forced to perform that reaction, but instead, can choose any of the 15 reagents

in the laboratory to perform any other viable reaction. Thus, any named reaction (or starting

material set) is capable of producing a number of products in addition to the products of the

named reaction. Selecting a named reaction in the reactions scroll box defines a list of

products (shown in the products scroll box) that can be assigned to the class to make from the

starting material set. A reaction is chosen by clicking the appropriate reaction.

Class Scroll Box. For a qualitative analysis assignment, the first scroll box is labeled as

“Class” and lists 11 classes of unknowns grouped by functional group. Selecting a functional

group in the class scroll box defines a list of unknowns containing that functional group

(shown in the unknown scroll box) that can be assigned to the students. A functional group is

chosen by clicking the appropriate group.

(d) Products Scroll Box. Once a reaction has been selected, a list of the products that can be

made from the starting material set for the reaction is listed in the products scroll box. (See

Appendix B for a complete list.) The products that are listed first are products that

correspond to the selected named reaction. Other products are also listed that demonstrate

different reactions or selectivity, but can be made from the same selected starting materials

using other reagents and reaction conditions. Clicking a product selects that product, but does

not save the assignment. Above the products scroll box is a drop-down menu, which allows

the products to be listed by IUPAC name or Common name.

Products Scroll Box. (for qualitative assignments) Once a class or functional group has been

selected, a list of products containing that functional group is listed in the products scroll

box. (See Appendix C for a complete list of unknowns.) Within a class, products are

generally listed with single functional groups first followed by multiple functional group

unknowns and from less difficult to more difficult. Above the products scroll box is a drop-

down menu, which allows the products to be listed by IUPAC name or Common name.

Unlike a synthesis assignment, where there is only one product that can be assigned, for a

random assignment it is typical to select a set of unknowns, which, in turn, will be assigned

randomly to the students. Sets of unknowns do not have to be restricted to one functional

group, but can extend to other functional groups as well. A single product is selected by

clicking the name. Multiple products are selected by Ctrl-click (both for the Mac and PC) and

ranges of products are selected by Shift-click. For individual assignments, an unknown is

assigned to each student by selecting a class (functional group) and a single unknown. After

the product is selected, the assignment is automatically saved and the student list is advanced

to the next student. This process should proceed until each student has an unknown.

(e) Points, Start Date, and Due Date. The points, start date, and due date for the assignment are

specified in these text boxes. The points are the total numbers of points assigned for the

assignment, and the minimum score possible is zero. The start date is the date (starting at

midnight) the assignment will be available to the students, and the due date is the last day the

assignment will be available (ending at midnight). Enter the start date and due date by

clicking on the calendar icon in their respective boxes and choosing the desired day. You

may scroll between months by using the arrows on either side of the month and year display

Page 57: Instructor utilities guide

53

at the top of the calendar box. An assignment cannot be modified, including the start date,

once it has been released to the students, but it is possible to change the due date. An

assignment can only be canceled while it is released by deleting it.

(f) Student List. For qualitative analysis assignments, a student list is provided for making

individual assignments and to show the unknowns assigned to each student. The list shows

three students. The middle student in the box is the currently selected student, and there is a

student before and after. Student names in red indicate an assignment has not been given,

whereas student names in blue indicate an assignment has been given. The up and down

arrows are used to scroll through the list. When an assignment has been made (name in blue),

the class and unknown are highlighted in the class and unknown scroll boxes, and the

structure of the unknown is shown in the structure display box. Updating the assignment

information as each student is accessed can take several seconds. Rapidly advancing through

the students bypasses the assignment update for the intermediate students. Changes in the

assignments can be made up until the start date.

(g) Structure Display Box. Mousing over a product or unknown listed in the product/unknown

scroll box shows the structure of the compound in the structure display box. When a product

has been selected, the structure is shown in the display box by default. For qualitative

analysis unknowns, the structure of the unknown assigned to the selected student is shown by

default in the display box.

(h) Function Buttons. The four function buttons are Save, Cancel, Delete, and Help. The Save

button saves the current assignment. The Cancel button resets the current assignment to a

blank assignment if it has not yet been saved; otherwise, it restores the assignment to its last

saved state. The Delete button deletes an assignment even if it has been released, and the

Help button opens the help window for organic assignments.

Archiving and Retrieving Assignments When defining a qualitative analysis assignment, the instructor is required to define a set of

possible unknowns by selecting from the available set of compounds given in each class of

unknown. This can be a time-consuming and laborious process, especially if these sets are large

and need to be defined for several classes. To make this process simpler, these sets can be

archived or saved and then retrieved using the Archive Assignment and Retrieve Assignment

buttons. These buttons are only active for qualitative analysis assignments. Archiving is not

possible for synthesis assignments.

To archive an assignment, define a qualitative analysis assignment following the steps and

procedures that were described in the Assignments section. Pressing the Archive Assignment

button will save the unknown set and the number of points allocated for the assignment. A dialog

box will appear asking for a name for the archive and where to save it. The assignment archive

can be stored anywhere, but the default location is the Assignment /Organic directory located

where the database is stored. Any number of archives can be stored with any combination of

unknowns.

Page 58: Instructor utilities guide

54

To retrieve an assignment, a qualitative analysis assignment must first be created. Inside a

qualitative analysis assignment, pressing the Retrieve Assignment button will bring up a dialog

box where the instructor may select from any of the available archives. Selecting an archive will

automatically define the set of unknowns based on the archive and allocate the number of points

for the assignment if that was also saved as part of the archive. At this point, the start date and

due date for the assignment must still be specified, and the actual unknowns must be assigned to

the students by saving the assignment (pressing the Save button).

Scores

Overview The scores folder (see Figure 13) shows the scores that have been earned by each student in the

class for each assignment, allows these scores to be exported in a tab-delimited text file, shows

the assignments that need to be graded, and allows the lab books to be inspected. The scores

folder is divided into three areas: (1) class and student information, (2) function buttons, and (3)

a spreadsheet view of student records. Each of these areas is described in the following sections.

Figure 13. The Scores folder inside the Class Management drawer.

Page 59: Instructor utilities guide

55

Class and Student Information Shown in Figure 13 is the class and student information area of the scores folder. Information on

the currently selected class is given at the top, followed by detailed student information for the

selected student in the spreadsheet. Class and student information cannot be modified in this

folder.

Function Buttons The two function buttons are View Lab Book and Export Scores. Selecting a student in the

spreadsheet enables the View Lab Book button. Clicking View Lab Book brings up the lab book

for the selected student starting in the Practice section. It is possible to record or modify scores

for assignments that have been reported. See Grading for more details. The Export Scores button

exports the current scores to a tab-delimited text file. A dialog box is used to specify the file

name and path.

Student Records The list of members is given in the spreadsheet with the assignments and points possible listed

across the top. Members can be listed by Name or by ID (password). When an assignment has

been reported by a student but has not been graded, a small lab book icon appears in the cell

corresponding to the student and the assignment. The lab book icon indicates that an assignment

is available for grading for that student. Clicking the lab book icon brings up the lab book for the

student in the assignment section that needs to be graded. While in the lab book, it is possible to

record a score for the assignment or simply view the lab book and then return to the scores

folder. See Grading for more details. When a grade has been recorded for the assignment, the lab

book icons are replaced with the actual score.

Grading

Overview Each student is given an electronic lab book to record their notes and submit their results for

grading. These lab books may be reviewed and graded (assigned a score) by (1) clicking the

stack of lab books on the stockroom desk, (2) clicking a lab book icon in the Scores folder, or (3)

clicking the View Lab Book button in the Scores folder. Each method launches the electronic lab

book and allows the instructor to navigate through a student’s notes, results, and conclusions and

record grades for assignments. Each method differs, however, in how the students and

assignments are selected.

The lab book is organized by sections and pages. The section name and current page number for

the section is listed at the top of the page. The first section is labeled Practice and is always the

section that is available to the student anytime an assignment is not out in the laboratory. When

an assignment is accepted for the first time, a new section is created in the lab book (named with

the assignment number) where only the notes associated with that assignment can be recorded.

Each assignment will have its own section, and these sections can only be modified while the

assignment is out in the laboratory. Once an assignment has been submitted for grading, no other

modifications are allowed. After an assignment has been submitted, an extra page is added to the

end of the section where grading information will be posted. This last page also contains the

Page 60: Instructor utilities guide

56

student’s reported answers for unknowns, and grading comments from the instructor can also be

recorded here.

Described in the following sections are the navigation tools for the lab book, recording scores,

and the different methods the lab book can be accessed.

Navigation Moving around inside the lab book from page to page and section to section is accomplished

using the five buttons grouped at the top of the left page of the lab book. (See Figure 14.) The

description of the functionality for each of these buttons follows.

The Previous and Next buttons are used to go to the previous or next page in the current section.

If a page in either the downward or upward direction is not available in the section, the button is

grayed out and not active.

Figure 14. The grading view of the lab book as accessed through the stack of lab books in

the stockroom.

Page 61: Instructor utilities guide

57

The Search Notes button is used to specify a word or phrase that can be

searched for in the current section or in the entire lab book. Shown on the

right is the Search dialog area that is placed on the left page of the lab

book when the Search Notes button has been pressed. The text box is used

to enter the word or words that will be searched for in the current section

or in all sections. The Search button initiates the search for the word or

words typed in the text box. If a match is found, the page with the match

will be shown on the right page of the lab book with the match

highlighted. Pressing the Search button again will search for the next

occurrence. After a match has been found, pressing the OK button will

close the Search dialog and switch the lab book to the new page. Pressing the Cancel button

closes the Search dialog and keeps the lab book on the old page. The Current Section and All

Sections radio buttons specify whether the search is to be made on the current section or over all

sections in the lab book, respectively.

The Go To Page button is used to

jump to any page in any of the sections

in the lab book. Shown on the right is

the Go To dialog box that is displayed

when the Go To Page button is

pressed. The first box lists the

currently available sections in the lab

book by name. Clicking one of these

will then list the available pages for the

highlighted section in the second box.

Clicking one of the pages will switch the lab book to the indicated page and section. Pressing the

Cancel button keeps the lab book on the old page.

The Exit button exits the lab book.

Accessing the Lab Book A student’s lab book can be accessed in three ways.

1. Stack of Lab Books. Clicking the

stack of lab books on the

stockroom desk launches the

electronic lab book with a dialog

box (shown in the accompanying

figure) that allows a specific class

and assignment to be selected. The

first box shows the current list of

classes. Selecting one of these

classes then lists in the second box

the assignments that have been defined for the selected class. Selecting one of the

assignments listed in the second box removes the dialog box and displays the lab book for the

Page 62: Instructor utilities guide

58

first student in the class with the lab book in the selected assignment section. (See Figure 14.)

In the middle of the left page is a student list where the student shown in the box is the

student to whom the current lab book belongs. Recording a score for this assignment

automatically advances the lab book to the next student. Other students in the class can also

be accessed using the up and down arrow keys in the student list. Other assignments can be

viewed or graded using the Go To Page button or the Search Notes button. Pressing Exit

returns to the select class/select assignment dialog box.

2. Lab Book Icon. When an assignment has been reported by a student, but has not been graded,

a small lab book icon is placed in the cell corresponding to the student and the assignment in

the Scores spreadsheet. The lab book icon indicates that an assignment is available for

grading for that student. Clicking the lab book icon brings up the lab book for the student in

the assignment section that needs to be graded. Recording a score for the assignment replaces

the lab book icon with the score in the spreadsheet.

3. View Lab Book. Selecting a student listed in the Scores spreadsheet and clicking the View

Lab Book button brings up the lab book for the student starting in the Practice section. The

assignment sections of the lab book can be accessed using the Go To Page button or the

Search Notes button. Scores can be modified or recorded in the assignment sections.

Recording Scores In assignment sections of the lab book, a score box and Record button are available at the bottom

left page of the lab book. (See Figure 14.) If a score has already been recorded for the

assignment, then the score is shown in the score box; otherwise, the score box is blank. A score

is recorded or modified by (1) clicking the score box, typing the score, and pressing Enter or (2)

clicking the Record button. A score can be recorded for an assignment even if the assignment has

not been submitted; however, this will prevent the student from further work on the assignment

even if the due date has not passed. Also note that when recording scores, comments can be

recorded in the comment box (not shown) for each assignment for later student viewing.

Utilities

Overview Since the class lists, assignments, scores, and lab books are stored in a centralized database, basic

backup and restore functions are available to protect against accidental or intentional corruption

of the database. In addition to these database utilities, there is also a Message utility that allows

an instructor to broadcast important information or reminders to the students of a selected class

on the chalkboard in the organic laboratory or the chalkboard in the general chemistry

laboratory. All of these functions are accessed by clicking the bottom drawer of the filing

cabinet. Inside the utilities drawer are manila folders, each of which performs a specific utility

function. These functions are described in the sections that follow.

Backup The Backup folder contains a list of the 22 most recent backups listed by date and time with the

most recent backups listed first. Clicking the Perform Backup button performs a complete

backup of the current database. When the number of backups reaches 22, the oldest backup is

Page 63: Instructor utilities guide

59

discarded to make room for the newest backup. These backups are stored in the Backup directory

in the Y Science directory and, therefore, do not protect against hardware failures.

Restore The Restore folder contains a list of the 22 most recent backups listed by date and time with the

most recent backups listed first. Clicking one of the backups generates another list containing the

classes that were stored in the selected backup. Clicking the Restore All button replaces the

current database with the selected backup. A warning is given before the restore proceeds to

delete the current database. A specific class within a backup can be restored by first selecting the

class and then clicking the Restore Class button. A warning is given before the restore proceeds

to delete the current class and replace it with the backup.

Reset The reset folder simply contains a Reset button, which, when pressed, deletes the current

database and resets it to a known state containing one class (Admin) and two members. One of

the members has administrative privileges for access to the stockroom. It is important that after

the reset operation, the new administrative password is either noted or changed so future access

to the stockroom can be ensured.

Messages When administering classes and assignments inside of Y Science, it is sometimes necessary or

useful to send out brief messages reminding the students of deadlines, giving them hints, or

warning them of problems. The Messages folder (see Figure 15) allows an instructor to compose

a message, select the classes where the message will be sent, and define at what time the

message will be released to the student and when the message will expire. Messages that have

been sent are displayed on the chalkboards in the general chemistry laboratory and in the organic

laboratory. Multiple messages can be sent and made available to students at the same time. The

process for creating and sending messages is divided into three steps: (a) compose the message,

(b) select the class or classes where the message will be sent, and (c) define when the message

will be sent and when it will expire.

(a) Composing a Message. A new message is created by first clicking the Create New Message

button (unless this is the first message, in which case the message area is already set up for a

new message). The actual text to be sent to the students can be typed directly into the

message box or can be pasted in from another program. The message can be as long as

needed since scrolling will be available for the students at the chalkboards.

(b) Selecting the Classes. Once the message has been typed or entered, the classes for whom the

message is intended must be selected. Located on the left of the Messages folder is a list of

classes for the current database. Classes are selected by clicking the desired class. Multiple

classes are selected by Ctrl-click (both for the Mac and PC) and a range of classes is selected

by Shift-click.

(c) Sending the Message. Once the message has been composed and the destination classes

selected, the time of delivery for the message must be defined next. Below the message text

box are the Send options. A message can be sent Now or On a specified date by selecting the

Page 64: Instructor utilities guide

60

appropriate radio button. If a date is specified, the date must selected using the usual calendar

functionality described in the assignment folders. The duration of the message or how long

the message will be available to the selected classes is defined by specifying the number of

days (from the send date) the message will be available or by specifying the Until. The

message is not actually sent until the Send Message button is pressed.

(d) Miscellaneous. The number of the current message is shown in the message number box at

the top of the folder. Messages that have already been created and saved can be accessed

using the left and right arrows next to the box. It can take several seconds to update the

message information as each message is accessed.

At the bottom of the Messages folder are the normal four buttons for Save, Cancel, Delete,

and Help. The Save button will save the current message for later action. The Cancel button

will cancel the current message or current changes and revert back to the previously saved

state. The Delete button will delete the current message, and Help will access the Utilities

Help screen.

Figure 15. The Messages folder as accessed from the Utilities drawer.

Page 65: Instructor utilities guide

61

Web Tools The Web Connectivity Option allows the instructor to give electronic assignments to the students

of one or more classes and, in turn, receive their answers and results through a servlet engine.

Details on configuring and using the Web Connectivity Option is given in the Overview section

at the beginning of this users guide. The Web Tools folder, shown in Figure 16, allows the

instructor to configure the Web Connectivity Option and perform several web connectivity

functions. Details on configuring the web option and using the web connectivity functions is

given here. Details on installing the servlet engine are given in the Installation and Overview

Guide, and details on administering the servlet engine are given in the Y Science Server

Administration section below.

Servlet URL. The Web Connectivity Option works by having a servlet engine collect data from

both the instructor and student and store it temporarily on the server. Both the instructor and the

student must specify the URL address of the servlet engine before the Web Connectivity Option

can be used. The Servlet URL text field is used to specify the URL address of the servlet engine

being used by Instructor Utilities. The servlet engine is actually a very small Java program that

Figure 16. The Web Tools folder as accessed through the Utilities drawer. The Web Tools

folder is used to test the servlet engine, update and retrieve data from the web,

and set the URL address.

Page 66: Instructor utilities guide

62

runs on a TomCat server; as a result, several instances or contexts of the servlet engine can run

simultaneously on any given server. It is recommended that each context on the server be used to

pass only one managed database between the instructor and the students since the servlet engine

does not check for duplicate classes nor duplicate students. The format of the URL address will

take the form of http://localhost:8080/Context/y where the localhost will be the IP address or

registered server name of the server and Context is the name of the context war file of the servlet

engine running on the server. The default Context is “yscience”.

Test Connection. Clicking the Test Connection button will query the servlet engine at the

specified URL address to test the servlet engine configuration and the indicated URL address. If

the test is not successful, then trouble shoot the following issues: (1) the TomCat server is not

running, (2) the servlet engine is not running or not configured, (3) there is no internet

connection, or (4) the URL address is incorrect.

Test Server. Clicking the Test Server button will query the servlet engine at the specified URL

address to test the servlet engine configuration, the indicated URL address, and tests the writing

and reading of files on the server. A common problem when configuring the servlet engine is the

servlet engine runs correctly but incorrect permissions have been granted to the servlet

preventing the writing and reading of files. This test insures that the correct permissions have

been established.

Clear All. Clicking the Clear All button will clear all the stored data off the context at the

specified URL address. If more than one database is using the same context, then data from the

other database will also be cleared.

Select Classes. The update and retrieve functions for the Web Connectivity Option can be

performed for each class using the Update Web and Retrieve Web buttons located in the Class

Roll folder for each class. However, if there are several sections of the same class, it will be

easier to select all these classes and perform the update and/or retrieve at the same time. Listed in

the Select Classes scroll box is a list of all the classes for the current database. Multiple classes

are selected by Ctrl-click (both for the Mac and PC) and ranges of classes are selected by Shift-

click. All classes in the list can be selected by clicking on the Select All box. The Update,

Retrieve, or Clear buttons below the Select Classes scroll box operate on these selected classes.

Update Web. This button performs an Update function to the servlet engine for the selected

classes. If there is no new data to send, then a warning is given. If the instructor proceeds to

update the server, then a force update is done which replaces all the data on the server. Note that

the Update function must be performed before students can be authenticated over the web and

allowed to turn on their own Web Connectivity Option. The update function must also be

performed any time modifications are made to the class data in order to provide the students in

the class with the most up-to-date information.

Retrieve Web. This button performs a Retrieve function from the servlet engine for the selected

classes and automatically synchronizes the local database. If there is no new data to retrieve then

a warning is given. If the instructor proceeds to retrieve the data then a force retrieve is done

Page 67: Instructor utilities guide

63

which retrieves all the data from the server and synchronizes the local database replacing any

duplicate information.

Force Update/Retrieve Web. The Force Update Web and Force Retrieve Web buttons are

identical to the regular Update and Retrieve functions except the Force functions copy all the

data either from the local database to the server (update) or from the server to the database

(retrieve). A regular Update or Retrieve moves only the data that is new or has been modified.

Clear Web. Clicking on this button clears the data for the selected off the context at the specified

URL address. This is a destructive process and prevents any students who may try to upload data

from doing so. A class can be re-established by simply performing and Update function.

Database Local Database Location. The database that contains the classes, students, assignments, scores,

and lab books is stored either locally inside the main installed Y Science directory or it could be

stored elsewhere such as on a network drive where it can be shared with other client computers

in a direct access installation. Details on the database structure can be found in the Database

section. The Local Database Location text field allows the instructor to specify the location of

the working database that will be used by Instructor Utilities which, in turn, allows an instructor

to manage multiple databases. The path that is entered in the text field must be a complete path

and must end with /Data/ (or :Data:) For the OS X operating system, the path separators must be

colons (“:”). If an entered path does not contain a valid Y Science database then an initial

database will be created automatically. If you enter a valid Y Science database path, then you will

be prompted to enter a username and password to gain entry to the new database. The entered

path can be saved by either using the Return key or by clicking on the Save button.

Page 68: Instructor utilities guide

64

Y Science Server Administration

Introduction

Requirements In the Web Connectivity Option, assignments and student results are passed between the

instructor and student using a small server application that stores both the assignment and student

data temporarily on the server. This server application (hereafter called a servlet or servlet

engine) runs inside a TomCat server (or any other equivalent application server) that can be

installed on a Windows, OS X, or Unix platform. The server computer can be any computer that

has an IP address and does not have to be anything fancy. The following is a general list of

requirements and other general information needed to setup and run the servlet engine. (Note that

in the following description administrator is either the instructor setting up the servlet engine or

a technical support individual.)

1. The server must have the latest version of Java 2SE JRE 5.0 installed (currently that is 5.0

Update 8). For OS X machines, this will be on the OS X installation disk. You must be using

Tiger 10.4 or greater. For Windows and Unix, this can be downloaded from

http://java.sun.com/javase/downloads.

2. The server must also have the TomCat (also called Jakarta) application server (or an

equivalent) installed. A copy of TomCat for Windows and OS X is included on Y Science

installation CD in the Servlet folder.

3. A directory will need to be established on the server where the data can be stored temporarily

by the servlet engine. All users who will be administering TomCat will need to have

read/write privileges to this directory. This should only be a problem in Unix.

4. It is not recommended that different Y Science databases use the same servlet engine since

there is no checking for duplicate class names and students. This is easily solved since

multiple instances of the servlet engine can run simultaneously on the server. Each instance

of the servlet engine is called a context and must be managed independently.

5. The URL address for the servlet engine will have the following format:

http://localhost:8080/Context/y where the localhost will be the IP address or registered server

name of the server and Context is the name of the context war file of the servlet engine

running on the server. The default Context is “yscience”. This URL address will be needed

by the instructor and students.

6. In order for the Web Connectivity Option to work, the servlet engine must be running on a

server that is accessible to the client computers who will be using it. If the server is behind a

firewall, then it is the administrator’s responsibility to ensure that any client computers

outside the firewall can still see the server.

7. When running TomCat on any version of Windows other than Windows 2000 Server or

Windows 2003 Server, there can only be, at most, 10 simultaneous connections to the

Page 69: Instructor utilities guide

65

TomCat server from the clients. This is by Microsoft's design; however, the connection time

with the server should be short for each client and should not cause a significant problem

except with large numbers of users.

In the following discussion, it is assumped that you have successfully installed and know how to

start and stop the servlet engine. Specific instructions for installing and configuring the servlet

engine can be found in the Installation and Overview Guide. Given below is a description of how

to initially configure and access the servlet administration page, followed by a description of the

various servlet options within the servlet administration page.

Access and Initial Configuration After the servlet engine has been installed on the server, you need to configure each context you

may have deployed. The servlet engine will not work until it has been configured. To do this, use

your browser to go to the link http://localhost:8080/yscience/admin (or use your other context

names in place of “yscience”) and use the username chemlab and the password chemlab (case

sensitive) to gain access to the context manager or servlet administration page. This will be the

address you use each time you need to access the servlet administration page.

The first time you access the servlet administration page, you will be asked to specify where the

database will be located, that is, the path where you will save the context data. (You will need a

new folder for each context.) You will also need to enter a new username and password since the

initial chemlab username and password will not work after the sevlet has been configured. When

this information has been entered, click the Update Path button and everything should be ready

for use. Repeat this step for all contexts you have deployed. Please Note: For OS X, the path

used for specifying where the context data will be stored must be entered using Linux syntax.

That is, if the path on your Mac is Macintosh HD:Users:YourName:ServletData then the path

you should enter is /Users/YourName/ServletData. We recommend that spaces not be used in

any of the folder names.

Administrative Pages

After the servlet engine has been initially configured, the administratin page can be re-visited to

customize various servlet settings, perform diagnostics, and perform various other administrative

functions. The servlet administration page is divided into the following sections: (1) General

Settings, (2) Server Diagnostic, (3) Users, (4) Logs, (5) Database Settings, and (6) Change

Password. Detailed descriptions of these sections are given next.

General Settings Session Timeout Time The servlet can only transfer data to and from the server one session at a

time, although the time required for each session is typically very brief. This setting is the

maximum time a session can last for both students and administrators before a session timout is

invoked. The default timout setting is usually sufficient except updating and retrieving for very

large classes.

Select Server DB Version The Y Science server can administor to both older version 2.5 (v2.5)

and v3.0+ products. Although the different versions use different servlet protocols, you can

Page 70: Instructor utilities guide

66

specifiy with this setting the product version and protocols you wish to use. Selecting v2.5+

(default) allows the servlet to use both protocols, while v2.5 and v3.0 force the servlet to restrict

access to the indicated versions.

Server Status This allows you to turn the transfer of data through the servlet engine on and off.

However, this option does not actually turn the servlet application on and off.

Server Diagnostic This section performs a wide set of servlet function diagnostics to insure the servlet is

functioning properly. Mostly these tests confirm that data can be written to and read from the

specified server database location. After the diagnostic is performed, the test results are

displayed with brief explainations for any failures.

Users Here you can add and delete servlet administrator users. Only those who need access to the

administration portion of the server should be added to the list of users. To add a new user,

simply enter in the username and password of the new user, verify the password by entering it

again, and then click the Add User button. The password must be at least five characters long.

Logs A history of all access to and use of the servlet can be stored in log files for later inspection for

diagnostic purposes. The following options allow control of the logging functions performed by

the servlet engine.

Logging Level This specifies the level of detail to be stored in the log files. These levels include

off, severe, warning, info, and config. Off gathers no information, Severe lists only errors,

Warning lists errors and warnings, Info displays a general log of those who access the server

along with errors and warnings., and Config stores all attempted actions.

File Size Limit This is the maximum or limiting log file size before a new log file is created.

Number of Old Log Files to Keep This is the maximum number of old log files to keep before

the oldest file is deleted.

Log File Format This allows you to choose plain text or XML as the file format for the log files.

Database Settings This section allows you to specify a new database path to store the database information on the

server. Note that specifiying a new database path is a distructive process and resets all database

settings back to their default state and requires entering a new username and password. Setting a

new database path in this section is equivalent to an initial configuration when the servlet engine

was first installed. Changing to a new database path does not erase information stored in

previous database locations and that information can be restored by typing in the old database

path.

Page 71: Instructor utilities guide

67

Note that for OS X based servers, the path used for specifying where the context data will be

stored must be entered using Linux syntax. That is, if the path on your Mac is Macintosh

HD:Users:YourName:ServletData then the path you should enter is

/Users/YourName/ServletData. We recommend that spaces not be used in any of the folder

names.

Change Password This section allows you to change the password for the servlet adminstrator who is currently

logged into the system. The new password must be more than 5 characters long and must be

entered twice.

Page 72: Instructor utilities guide

A-1

Appendix A

INI Variables and Management Issues

Many of the functions and simulation parameters used in Y Science are controlled by INI

variables. INI variables are numerical or text settings that are contained in a small set of INI files

found in the various Y Science directories. These INI files are text-based files all with the

extension “.ini” and can be viewed or edited in any simple text-based editor. It should be noted

that in these INI files, variables are grouped together in sections by a header line with the format

[name], where name is the name of the section. When adding INI variables to a file, the section

names, if not already present in the file, must be added along with the new variables.

During the installation of Y Science, these INI variables are set at what is considered to be the

optimal settings for most applications. However, many of these INI variables can be changed to

fit individual needs and applications. Given in this appendix is a description of most of these INI

variables and how they fit within the greater scope of Y Science. Along with a description of

these INI variables, many issues associated with the management and implementation of Y

Science will also be discussed.

ChemLab INI File

The ChemLab.ini file is the main INI file that controls the overall operation of the software.

Most of what is described in this section is a more detailed description of how the Y Science

simulations are configured and how some of these INI variables can be reconfigured. Given

below is a description of the INI variables that can be modified.

Database Issues When Y Science is installed, a Chemlab.ini file is created in the main Y Science directory that has

the format

[Database]

DatabasePath = path\Data\ (PC)

or

DatabasePath = path:Data: (Mac)

where path is the path to the Y Science directory chosen at the time of the installation. This INI

variable points to the Data directory where the login, class management files, and electronic lab

books are stored. For client installations, this variable points to the database on the server. For

local installations, the variable points to the local database.

During a direct client installation, the installer creates this variable based on where the client

installer was launched. If the installer was launched from the server in the Y Science directory,

then the variable should point to the correct database. If the direct client installer was copied to a

removable media (say, a USB drive), which is then used to install the client program, the INI

variable will default to the removable media drive. During the installation, an option is given to

enter the correct path for the server database. This path must include the \Data\ (:Data:) part of

the path to the database.

Page 73: Instructor utilities guide

A-2

As Y Science has been developed and as new features have been added, the format of the

database has been forced to change. When students are using older versions of the software with

new versions of Instructor Utilities, there could be database incompatibilities. An INI variable

has been added which will control how these incompatibilities will be handled.

[General]

Autoupgrade = No or Yes (default) or Force

A No will always prompt the user to upgrade the database, A Yes will automatically upgrade the

database if it is a student user, and Force will always upgrade the database for any version of the

software.

Lab Book Issues To increase the speed and reliability of the electronic lab book in a Direct Database Access

mode, a copy of the lab book is placed on the local drive of the computer when the lab book is

opened in the laboratory or in Instructor Utilities. When this is done, a lock is placed on the file

to prevent two users (the instructor and the student) from modifying the file at the same time. In

the event of a hardware crash while the lab book is open, this lock remains in effect even when

the program is restarted. This lock can be overridden by the instructor by opening the lab book

inside Instructor Utilities using the View Lab Book button in the Score folder.

When a student has their lab book open in the laboratory, the lab book information is stored in

memory. Saves of the lab book are made only at the time the lab book is exited, when an

assignment is submitted, or when a grade is assigned. To protect against loosing data because of

hardware crashes, the lab book is automatically saved every 5 minutes (300 seconds). The timer

interval between automatic saves can be changed by adding the variable

[Labbook]

SaveTimer = nnnn

to the Chemlab.ini file, where nnnn is the time in seconds between saves. If this line is absent in

the INI file, the time interval defaults to 300 seconds. If nnnn is set to zero, then automatic

saving is turned off.

Servlet Engine URL If the Web Connectivity Option is being used, the URL address for the servlet engine is stored

with the INI variable

[Manage]

WebURL=http://localhost:8080/Context/y

where localhost is the IP address or registered name of the server on which the servlet engine

resides and Context is the name of the servlet engine context (usually “yscience”). In Instructor

Utilities, the URL address is specified in the Web Tools folder. When a student version is first

installed, the URL address is initially left blank and when the first student activates the Web

Page 74: Instructor utilities guide

A-3

Connectivity Option, they must type in the full path of the URL. From then on, the URL address

of the most recently successful authenticated student is used as the default address.

Automatic Web Updates If the Web Connectivity Option is used on the student side, an INI variable

[General]

Web_Install=aConnect

can be set that forces an automatic retrieve when the students enter the laboratory and automatic

updates when the student submits assignments and exits the laboratory. Automatic Updates can

be set individually in the Web Options section of the student lab book, but this variable forces

automatic updates. For security reasons, this variable is mandatory for computer lab installations

using the Web Connectivity Option and is automatically set during a web client install (see the

installation instructions for more details).

Window Behavior Macromedia Director has a feature that causes overlapping windows to still be active even for

windows that are underneath, so when the cursor is clicked on the active window that click is

also recorded on the inactive window. We have addressed this problem by providing three cursor

options with INI variables.

[Window Behavior]

All_Windows_Cursor = Off, Clicks (default), or Always

Popup_Windows = Off, Clicks (default), or Always

Both INI variables work the same way but are applied to different types of windows.

All_Windows_Cursor applies only to the main laboratory windows, and Popup_Windows

applies to the popup windows (lab book, meters, detectors, etc.). Off means an inactive window

cannot be activated except by clicking on the window bar at the top. Clicks means the cursor will

not change when over an inactive window but clicking anywhere on the window will activate the

window. Always means all inactive windows will behave as if they were active.

Inorganic INI Files

There are no INI files currently used for the inorganic simulation.

Quantum INI Files

The quantum simulation consists of a set of fundamental experiments that demonstrate the ideas

and concepts leading up to the development of quantum mechanics. Much of the operation of the

laboratory and the parameters defining the experiments is controlled using INI variables located

in the files Lab.ini, Video.ini, Spectro.ini, Phosphor.ini, KE.ini, and Diode.ini. The variables in

Lab.ini generally control aspects of the entire quantum simulation or experimental parameters

that are in more than one experiment. The Lab.ini file is located in the QuantumDB directory in

Page 75: Instructor utilities guide

A-4

the ChemLabQ directory. The Video.ini, Spectro.ini, Phosphor.ini, KE.ini, and Diode.ini files

contain INI variables that are specific to the operation of each of the indicated detectors. These

variables generally control and define the operation of the various quantum experiments and are

located in the Detectors directory in the ChemLabQ directory. There is one additional set of INI

files and these define the preset experiments located on the stockroom clipboard and used in the

quantum assignments. Described in each of the following sections are the INI variables

contained in each of these INI files. The purpose for providing this information is to grant

instructors the ability to change or adjust the quantum simulation to suit their own needs.

Lab.ini INI Variables Description

[Settings] Required header line.

Move_Detector_Forward=1 For monitors with resolutions of 1024 x 768 or less, there may not be enough room for the main lab window and detector window to be open at the same time and comfortably see changes in the detector as changes are made in the lab. Setting this variable to 1 forces the detector window to be on top after any change is made in the lab. Setting this variable to 0 forces normal window operation.

IntenEGunDisp=1 e/s,10 e/s,100 e/s, 1000 e/s,1 nA,1 uA,1 mA,1 A

The electron gun allowed intensity values displayed on the LCD controller.

IntenEGunVal=1 e/s,10 e/s,100 e/s,1000 e/s, 0.05,0.3,0.7,1

The electron gun intensities assigned to the corresponding display values. It is not suggested that the e/s values be changed.

IntenLaserDisp=1 p/s,10 p/s,100 p/s,1000 p/s, 1 nW,1 uW,1 mW,1 W,1 kW,1 MW

The laser allowed intensity values displayed on the LCD controller.

IntenLaserVal=1 p/s,10 p/s,100 p/s,1000 p/s, 0.05,0.2,0.4,0.6,0.8,1

The laser intensities assigned to the corresponding display values. It is not suggested that the p/s values be changed.

IntenBulbDisp=1 nW,1 uW,1 mW,1 W,1 kW, 1 MW

The super light bulb allowed intensity values displayed on the LCD controller.

IntenBulbVal=0.05,0.2,0.4,0.6,0.8,1 The super light bulb intensities assigned to the corresponding display values.

WavelengthDisp=nm,um,mm The allowed units displayed on the laser LCD controller.

WavelengthVal=1e-9,1e-6,1e-3 The multipliers assigned to the corresponding units on the laser LCD.

WavelengthMax=999 The maximum setting on the maximum scale on the laser LCD controller.

WavelengthMin=020 The minimum setting on the minimum scale on the laser LCD controller.

KEnergyDisp=me,eV,keV The allowed units displayed on the electron gun LCD controller.

KEnergyVal=1e-3,1,1e3 The multipliers assigned to the corresponding units on the electron gun LCD.

KEnergyMax=050 The maximum setting on the maximum scale on the electron gun LCD controller.

KEnergyMin=001 The minimum setting on the minimum scale on the electron gun LCD controller.

AlphaKEnergy=5.4e6 The kinetic energy of the alpha particles from the alpha source in eV.

BDisp=uT,mT,T The allowed units displayed on the magnetic field LCD controller.

BVal=1e-6,1e-3,1 The multipliers assigned to the corresponding units on the magnetic field LCD.

BMax=100 The maximum setting on the maximum scale on the magnetic field LCD controller.

Page 76: Instructor utilities guide

A-5

BMin=0 The minimum setting on the minimum scale on the magnetic field LCD controller.

EDisp=V,kV The allowed units displayed on the electric field LCD controller.

EVal=1,1e3 The multipliers assigned to the corresponding units on the electric field LCD.

EMax=005 The maximum setting on the maximum scale on the electric field LCD controller.

EMin=00 The minimum setting on the minimum scale on the electric field LCD controller.

HeatDisp=0 K The allowed units displayed on the heater LCD controller.

HeatVal=10 The multipliers assigned to the corresponding units on the heater LCD.

HeatMax=400 The maximum setting on the maximum scale on the heater LCD controller.

HeatMin=30 The minimum setting on the minimum scale on the heater LCD controller.

SlitDisp=nm,um,mm The allowed units displayed on the two-slit LCD controller.

SlitVal=1e-9,1e-6,1e-3 The multipliers assigned to the corresponding units on the two-slit LCD.

SlitMax=100 The maximum setting on the maximum scale on the two-slit LCD controller.

SlitMin=1 The minimum setting on the minimum scale on the two-slit LCD controller.

Laser_Open_Delay=75 The delay time in msec before the laser lid is removed during a mouse over.

T_Heat_Glow = 399 The temperature at which the heating element begins to glow in K.

T_Gas_XPLD = 700 The temperature at which the gas holder explodes.

T_Liquid_XPLD = 400 The temperature at which the liquid holder explodes.

T_Oil_XPLD = 450 The temperature at which the oil mist begins to smoke.

T_Red = 700 The temperature at which the foils turn dull red when heated.

T_Orange = 900 The temperature at which the foils turn orange when heated.

T_white = 1100 The temperature at which the foils turn white when heated.

Color_A=4096 The first of the visible light scaling parameters used in the spectrometer color window to simulate the sensitivity of the human eye.

Color_B=8.317766167 The second scaling parameter. The equation is Iobs = Imax ln(I A) B[ ] .

Setting_Delay=400 The delay time in msec before a change in any LCD controller is processed.

Gas_Glow=300 The AC voltage at which any gas will begin to emit.

PB_Gx=76.20 The distance, in cm, between position 7 and position 9 on the table. This is used to calculate the deflection of particles in any particle bending experiment.

PB_Ey=91.44 The distance, in cm, between position 9 and position 8 or 10 on the table. This is used to calculate whether a particle will hit a detector in position 8 or 10.

PB_n=40 The number of iterations to use when solving the differential equation while a charged particle moves through the electric or magnetic fields.

PB_EB_Length=0.050 The length of the electric and magnetic fields, in m, for the E and B modifiers in position 7 on the table. This is used in the particle bending experiments.

PB_E_Dist=0.050 The spacing between the electric plates for the E modifier in position 7. This is used for calculating the applied electric field using E = V/d.

Page 77: Instructor utilities guide

A-6

Video.ini INI Variables Description

[Video]

OilYMin=29 The y pixel position where the oil drops disappear from the screen.

OilYMax=379 The y pixel position where the oil drops appear on the screen.

OilXMin=75 The left-most pixel position (xmin) where the oil drops can fall.

OilXMax = 330 The right-most pixel position (xmax) where the oil drops can fall.

PixelFactor=1 The number of pixels used when calculating the speed of the oil drops per pixel.

Oil_Y_Pixel_D_nm=2857 Defines the number of nm per pixel in the oil mist.

Oil_SlowMo_Factor = 5 Defines the slow-motion factor when the slow-motion button is pressed.

Oil1=1.00e-06 Defines the diameters of the 10 different oil drops in m.

Oil2=1.13e-06

Oil3=1.25e-06

Oil4=1.38e-06

Oil5=1.42e-06

Oil6=1.51e-06

Oil7=1.64e-06

Oil8=1.69e-06

Oil9=1.79e-06

Oil10=1.92e-06

Oil1_Size=01 There are 10 graphics that depict 10 different size drops where 01 is the

Oil2_Size=01 smallest drop and 10 is the largest. These variables assign the drop graphic for

Oil3_Size=01 the 10 different size drops defined earlier.

Oil4_Size=01

Oil5_Size=02

Oil6_Size=02

Oil7_Size=02

Oil8_Size=02

Oil9_Size=03

Oil10_Size=03

MaxIntensity=1 The intensity of the egun that blows away the oil drops.

EPlate_D=0.010 The spacing of the electric plates in the oil mist chamber in m.

oilDensity=821 Density of the oil in kg m-3 for the oil mist.

airDensity=1.22 Density of the air in kg m-3 for the oil mist.

airVisc = 1.4607e-5 Viscosity of the air in kg m-1 s-1 for the oil mist.

atmoPres=1.00 Air pressure in atmospheres for the oil mist.

SpotPixel=2 The size of the spots for the two-slit single photon experiments.

PixelPerCM=50 The number of pixels per cm in the x direction on the video screen for the two-slit experiment. Essentially defines the size of the screen.

Video_Slit_D=0.01 The distance of the screen from the slits in m.

SlitTopY=126 The top pixel position for the interference pattern.

SlitBottomY=239 The bottom pixel position for the interference pattern.

SpotSqueeze=0.9 Used to adjust a set of random numbers to give a gaussian distribution.

BaseIntensity=0.25 The intensity of each spot as they hit the screen in the single photon experiment. Overlapping spots add intensity.

Spot_Dis_mSec=750 The time, in msec, spots on the video screen persist before disappearing when

Page 78: Instructor utilities guide

A-7

not in Persist Mode.

BoxExtend=100 For some configurations, the outer fringes of an interference pattern can be very long. This variable sets an upper bound on this size for certain situations.

Large_Spot_Size=8 The size of a simple laser spot on the video camera in pixels.

Slit_Rect_W=400 The width of the white rectangle in a bulb/two-slit combination.

Slit_Rect_H=20 The height of the white rectangle in a bulb/two-slit combination.

Slit_Width_Pixel=187 The width, in pixels, the two-slit graphic can move.

Spectro.ini INI Variables Description

[Spectro]

BB_Min = 10 The minimum wavelength, in nm, for the blackbody spectrum.

BB_Max = 5000 The maximum wavelength, in nm, for the blackbody spectrum.

Zoom_Min = 1 The maximum, full-scale zoom, in nm, for the blackbody experiment.

Graph_Resolution=300 The number of points to use to graph the blackbody curve.

Zoom_Min_PE=0.1 The maximum, full-scale zoom, in nm, for the photoemission experiment.

PE_Detail_Switch=5 The full-scale zoom, in nm, where a switch is made between the low-resolution and high-resolution photoemission files.

Adsorb_Detail_Switch=10 The full-scale zoom, in nm, where a switch is made between the low-resolution and high-resolution adsorption files.

Raman_Scale_Factor=1e4 The multiplication factor for the center Raman peak.

Raman_Broad_Factor=.10 The gaussian broadening parameter for the center Raman peak.

Raman_Sat_Scale_Factor=0.01 The multiplication factor for the satellite Raman peak.

Raman_Sat_Broad_Factor=.010 The gaussian broadening parameter for the satellite Raman peak.

Raman_Wave_Min_nm=110 The minimum laser wavelength where a Raman experiment will work.

Raman_Wave_Max_nm=999 The maximum laser wavelength where a Raman experiment will work.

Phosphor.ini INI Variables Description

[Phosphor]

Spot_Diameter=10 The diameter, in pixels, for general spots that appear on the phosphor screen.

Spot_Remain_mSec=300 The time, in msec, spots persist on the phosphor screen when not in Persist Mode.

Spot_R=108 The R-value for a full-intensity spot.

Spot_G=165 The G-value for a full-intensity spot.

Spot_B=78 The B-value for a full-intensity spot.

Base_Intensity=0.2 The intensity of each spot as they hit the screen in the single particle experiments. Overlapping spots add intensity.

SpotPixel=2 The size of the spots for the two-slit single particle experiments.

PixelPerCM=50 The number of pixels per cm in the x direction on the phosphor screen for the two-slit experiment. Essentially defines the size of the screen.

Phosphor_Slit_D=0.01 The distance of the screen from the slits in m.

SlitTopY=108 The top pixel position for the interference pattern.

SlitBottomY=221 The bottom pixel position for the interference pattern.

SpotSqueeze=0.9 Used to adjust a set of random numbers to give a gaussian distribution.

Page 79: Instructor utilities guide

A-8

BaseIntensity=0.25 The intensity of each spot as they hit the screen in the single particle, two-slit experiment. Overlapping spots add intensity.

Spot_Dis_mSec=750 The time, in msec, spots on the phosphor screen persist before disappearing when not in Persist Mode.

BoxExtend=100 For some configurations, the outer fringes of an interference pattern can be very long. This variable sets an upper bound on this size for certain situations.

Ruth_Diam=50 The base diameter, in pixels, for the forward scattering spot in the Rutherford experiment. Spot size changes size based on nuclear cross section.

Eo=5.4 The energy of the alpha particles in MeV.

Ruth_Intensity=1e5 The intensity of the alpha-particle flux in particles per second.

T=0.001 The thickness of the metal foil in cm.

Area_cm2=144 The area of the phosphor screen in cm2.

DistB_cm=138.2 The distance from position 5 to position 1 in cm.

DistI_cm=81.3 The distance from position 5 to position 4 in cm.

DistE_cm=190.9 The distance from position 5 to position 8 in cm.

DistG_cm=172.7 The distance from position 5 to position 9 in cm.

Ruth_Spread=0.1 The fade parameter for the forward-scattering Rutherford spot.

Ruth_Dis=300 The time, in msec, the backscattering spots persist before disappearing when not in Persist Mode.

Ruth_Spot_Size=6 The size of the backscattering spots in pixels.

Ruth_Spot_Fade=12 The fade parameter for the backscattering spots.

Ruth_Spot_Power=3 A second fade parameter for the backscattering spots.

Sigma=100 A second fade parameter for the forward scattering spot.

PB_Base_Intensity=.25 The intensity of a single particle spot as it hits the screen in the particle-bending experiments. Overlapping spots add intensity.

PB_Spot_Dis_mSec=300 The time, in msec, spots on the phosphor screen persist before disappearing when not in Persist Mode.

PB_ScreenW=12 The screen width, in cm, for the particle-bending experiment.

PB_SpotSize=10 The size of a particle-bending spot in pixels.

PB_Fade=15 The fade parameter for a particle-bending spot.

Grid_Red=100 The grid color R-value.

Grid_Green=100 The grid color G-value.

Grid_Blue=100 The grid color B-value.

Grid_Space_CM=1 The spacing between major grid lines.

KE.ini INI Variables Description

PE_Min = 0 The minimum energy, in eV, for graphing on the bolometer.

PE_Max = 60 The maximum energy, in eV, for graphing on the bolometer.

PE_Zoom_Min = 2 The maximum, full-scale zoom, in eV, for the blackbody experiment.

PE_R=0 The graphing line color R-value.

PE_G=200 The graphing line color G-value.

PE_B=0 The graphing line color B-value.

Time_Interval_mSec=1000 The time interval between measurements in the integrated mode.

Time_Scale_Sec=60 The full-scale time in the integrated mode.

Page 80: Instructor utilities guide

A-9

Diode.ini INI Variables Description [Diode]

Time_Interval_mSec=1000 The time interval between measurements.

Time_Scale_Sec=60 The full-scale time.

Line_R=25 The graphing line color R-value.

Line_G=25 The graphing line color G-value.

Line_B=25 The graphing line color B-value.

BB_Min=100 The wavelength to starting integrating the blackbody intensity.

BB_Max=5000 The wavelength to stop integrating the blackbody intensity.

BB_Resolution=3000 The number of points to use to perform the integration.

Preset Experiments Located on the clipboard in the quantum stockroom is a set of 15 preset experiments listed by

title. If allowed by the instructor, students can select one of these experiments and, upon

returning to the laboratory, the selected experiment will be automatically set up and running. A

preset experiment can also be used for assignments so a student can accept an assignment with

the experiment already set up for them. Preset experiments are intended to provide flexibility for

the instructor so the quantum simulation can be adapted to the level of the class or the individual

teaching style of the instructor. Several experiments have already been defined and are installed

with the software. This section describes how these files can be modified.

Each preset experiment is defined using an INI file. For the preset experiments on the clipboard,

these files have the name Experimentn.ini, where n is a number between 1 and 15 and represents

experiments 1 through 15 on the clipboard. These files are located in the Presets directory in the

ChemLabQ directory. For the preset experiments used in assignments, these files must be located

in the Assignments/Quantum directory and can have any name, but must have the extension

“.ini”. Information on how to use preset experiments in assignments is given in the “Quantum

Assignments” section. Note that in client installations, any modified preset experiments for the

clipboard must be modified for each client installation.

Given subsequently is a description of a preset experiment INI file and the variables that are used

to define an experiment. Before reviewing the INI file information, here are some important

points to keep in mind: (a) All of the variables described have default values, so variables may be

left blank or not used at all. An experiment can be set up or defined to any degree desired by the

instructor. (b) Some variables are mutually exclusive; that is, the use of one variable may mean

another variable cannot be used. Some error checking exists for such situations, but the error

checking is not comprehensive. (c) The LCD control boxes for various pieces of equipment use

three different INI variables to define their initial settings: one for the numeric value on the LCD

box, one to define the location of the decimal place, and the other to define the units. Not all of

these need to be used to define the initial settings. (d) Positions on the table are defined using

numbers from 1 to 10 as indicated in the following figure:

Page 81: Instructor utilities guide

A-10

Positions 1, 2, and 3 are for sources, position 5 is for samples, position 5 is also for electric or

magnetic field modifiers or heat, position 7 is for electric or magnetic field modifiers, and

positions 1, 3, 4, 6, 8, 9, and 10 are for detectors.

The following two tables show the INI variables used in preset experiments. The first lists all the

variables that can be used and their allowed values. Default values are given in red. The second

is an example of a preset experiment for the Millikan Oil Drop Experiment to show how the

variables can be used.

Complete Preset Experiment INI Variable List

INI Variables Description

[Title]

Title=Experiment Title Defines the title of the experiment as shown on the clipboard. Not used for preset assignments.

[Source]

Source=none, alpha, bulb, egun, laser Defines the source for the experiment. The allowed values are shown.

Position=1, 2, 3 (Default = stockroom counter) Defines the position for the source.

On_Off=on, off Sets the source initially on or initially off.

Intensity= (Default = lowest intensity) Sets the source intensity. See Lab.ini file for allowed values.

Setting=nnn (Default = lowest value) Sets the three digits on the LCD source control box.

Setting_Units= (Default = smallest units) Sets the units on the LCD source control box. See Lab.ini file for allowed values.

Setting_Decimal_Position=1, 2, 3 Sets the decimal place on the LCD source control box. 1 is after the first digit, 2 the second digit, and 3 is after the right-most digit.

[Sample]

Holder=none, oil mist, liquid, metal, gas, two slit

Defines the sample holder that will be used in the experiment. The allowed values are shown.

Sample= (Default = empty) Defines the liquid, metal, or gas sample to be used. Allowed values are given in the Liquid, Metal, or Gas Tables found in the QuantumDB directory.

Position=5 (Default = stockroom counter) Defines the position for the sample. 5 is the only allowed position.

Spacing=nnn (Default = lowest value) Sets the three digits on the LCD spacing control box for the two-slit sample.

1 4 8

2 5 7 9

3 6 10

Page 82: Instructor utilities guide

A-11

Spacing_Units=nm, um, mm Sets the units on the LCD spacing control box. The allowed values are shown.

Spacing_Decimal_Position=1, 2, 3 Sets the decimal place on the LCD spacing control box. 1 is after the first digit, 2 is after the second digit, and 3 is after the right-most digit.

[Detector]

Detector=none, phosphor, spectro, video, diode, bolometer

Defines the detector that will be used in the experiment. The allowed values are shown.

Position=1, 3, 4, 6, 8, 9, 10 (Default =

stockroom counter) Puts the detector in the specified position. The allowed values are shown.

On_Off=on, off Turns the detector initially on or initially off.

[Modifiers]

Modifier=none, heat, E_field, B_field, E_B_field

Defines the modifiers that will be used in the experiment. The allowed values are shown. To use an electric and magnetic field combination, utilize the E_B_field value. Heat cannot be used in combination with another modifier.

Position=5, 7 (Default = stockroom counter) Puts the modifiers in position 5 or 7. Heat can only be in position 5. The electric and magnetic fields must be in the same position.

E_Setting=nnn (Default = lowest value) Sets the three digits on the LCD electric field control box.

E_Setting_Units=V, kV Sets the units on the LCD electric field control box. The allowed values are shown.

E_Setting_Decimal_Position=1, 2, 3 Sets the decimal place on the LCD electric field control box. 1 is after the first digit, 2 is after the second digit, and 3 is after the right-most digit.

B_Setting=nnn (Default = lowest value) Sets the three digits on the LCD magnetic field control box.

B_Setting_Units=uT, mT, T Sets the units on the LCD magnetic field control box. The allowed values are shown.

B_Setting_Decimal_Position=1, 2, 3 Sets the decimal place on the LCD magnetic field control box. 1 is after the first digit, 2 is after the second digit, and 3 is after the right-most digit.

H_Setting=nnn (Default = lowest value) Sets the temperature on the heat modifier. The units of the specified temperature must be in Kelvin and the ones digit must be 0 (zero).

An Example of a Millikan Oil Drop Preset Experiment INI Variables Description [Title]

Title=Millikan Oil Drop Experiment Defines the title of the experiment shown on the clipboard. Not used for preset assignments.

[Source]

Source=eGun Defines the source as the electron gun.

Position=2 Puts the source at position 2.

On_Off=on Turns the source on initially.

Intensity=1 nA Sets the source intensity to 1 nA.

Setting=100 Sets the electron gun energy to 100 on the LCD box.

Setting_Units=me Sets the electron gun energy units to meV.

Setting_Decimal_Position=3 Puts the electron gun energy decimal place to the right-most position.

[Sample]

Holder=oil mist Defines the holder as the oil mist.

Position=5 Puts the oil mist in position 5.

[Detector]

Page 83: Instructor utilities guide

A-12

Detector=video Defines the detector as the video camera.

Position=9 Puts the video camera in position 9.

On_Off=on Turns the video camera on.

[Modifiers]

Modifier=E_field Defines the modifier as the electric field.

Position=5 Puts the modifier in position 5.

E_Setting=0 Sets the electric field initially to zero.

E_Setting_Units=V Sets the units on the electric field LCD box to volts (V).

E_Setting_Decimal_Position=3 Puts the decimal place to the right-most position.

Gases INI Files

The gases laboratory consists of a set of simulated physical chemistry experiments that

demonstrate the behavior of ideal, real, and van der Waals gases under varying experimental

conditions. Much of the operation of the laboratory and the parameters defining the experiments

is controlled using INI variables located in the two files Gases.ini and Units.ini located in the

GasINI directory in the ChemLabG directory. The variables in Gases.ini generally control

aspects of the four different gas experiments, and the variables in Units.ini control the operation

of the LCD controllers, unit conversions, and significant figures. There is one additional set of

INI files and these define the preset experiments located on the stockroom clipboard and used in

the gases assignments. Described in each of the following sections are the INI variables

contained in each of these INI files. The purpose for providing this information is to grant

instructors the ability to change or adjust the gases simulation to suit their own needs.

Gases.ini INI Variables Description [General] Slider_Delay_mSec=500 The time in milliseconds that the slider remains stationary before changing the

digits on the LCD. Slider_Change_Rate_mSec=500 The time in milliseconds between the changing of digits of the LCD when the

slider is dragged up or down. Labbook_Save_Method=Any_Change This specifies when data will be saved to the lab book. “Any_Change” saves

the data after every change. “Slider” saves the data only after the slider is released.

Labbook_Data_Line_Limit = 1000 The limit of lines that the lab book will save before it automatically starts a new page.

Limit_Error_Per=.1 When iterating the solutions for real gases, this variable specifies how close (in percent) the iterations have to be before the algorithm says it is done.

Auto_Min_Max=0 Defines whether the LCD’s go automatically to the max or min when a number higher or lower than that amount is selected. Zero is off.

[Experiment_1] (The following apply only to the Balloon Experiment.) Volume_Init_m^3=0 The initial volume of experiment in units of m3. Volume_Unit=m^3 The initial units of volume. Balloon_Max_Vol_m^3=0.012 The maximum allowed volume of the balloon in m3 before it pops. Pressure_Init_Pa=100000 The initial pressure in units of Pascals. Pressure_H2O_Init_Pa=100000 The initial pressure in units of Pascals if the gas chosen is H2O. Pressure_Max_Pa=1e9 The maximum pressure allowed in the experiment in units of Pascals.

Page 84: Instructor utilities guide

A-13

Pressure_Min_Pa=0 The minimum pressure of the experiment. Pressure_Unit=Pa The initial units of pressure. Temp_Init_K=298 The initial temperature in Kelvin. Temp_H2O_Init_K=400 The initial temperature, in Kelvin, if the gas chosen is H2O. Temp_Max_K=3000 The maximum temperature allowed in the experiment in Kelvin. Temp_Min_K=0 The minimum temperature of the experiment. Temp_Unit=K The initial unit of temperature. n_Init=0 The initial number of moles. n_max=50.0 The maximum number of moles allowed in the experiment. Flow_Rate_1=0.01 The number of moles per second that are released from the gas regulator at Flow_Rate_2=0.02 the different flow rates selected on the regulator. Flow_Rate_3=0.04 Flow_Rate_4=0.06 Flow_Rate_5=0.08 Flow_Rate_6=0.1 Flow_Rate_7=0.15 Flow_Rate_8=0.2 Flow_Rate_9=0.25 Flow_Rate_10=.3 Regulator_Pressure_1_Pa=138000 The pressure setting for the regulator at the various needle positions. Regulator_Pressure_2_Pa=276000 Regulator_Pressure_3_Pa=414000 Regulator_Pressure_4_Pa=552000 Regulator_Pressure_5_Pa=690000 Regulator_Pressure_6_Pa=827000 Regulator_Pressure_7_Pa=965000 Regulator_Pressure_8_Pa=1103000 Regulator_Pressure_9_Pa=1241000 Regulator_Pressure_10_Pa=1517000 P_Atmosphere_Pa=101010 The pressure settings on the regulator are actually relative to atmospheric

pressure. This variable specifies what is atmospheric pressure in the lab. Wide_Update_Time_mSec = 333 Time in milliseconds for the experiment to be updated in the zoomed out mode

when gas is being added. Temp_1_K=50 The temperature, in Kelvin, where the bath liquid changes color to indicate

changes in temperature (sea green to light blue). Temp_2_K=150 The temperature where the cord changes color from light blue to dark blue. Temp_3_K=250 The temperature where the cord changes color from dark blue to forest green. Temp_4_K=350 The temperature where the cord changes color from forest green to yellow. Temp_5_K=450 The temperature where the cord changes color from yellow to goldenrod. Temp_6_K=550 The temperature where the cord changes color from goldenrod to red. Real_Approx_Error_Per=0.0001 The error limit for iterating real gas solutions in per cent. [Experiment_2] (The following apply only to the Pressure Experiment.) Volume_Init_m^3=0.004 The initial volume of experiment in units of m3. Volume_H2O_Init_m^3=0.004 The initial volume of experiment in units of m3 if the gas chosen is H2O. Volume_Unit=m^3 The initial units of volume. Vol_Max_m^3=0.004 The maximum allowed volume of the experiment in units of m3. Vol_Min_m^3=0.0 The minimum allowed volume of the experiment in units of m3.

Page 85: Instructor utilities guide

A-14

Pressure_Init_Pa=0 The initial pressure in units of Pascals. Pressure_H2O_Init_Pa=0 The initial pressure in units of Pascals if the gas chosen is H2O. Pressure_Max_Pa=1e9 The maximum pressure, in units of Pascals, allowed in the experiment. Pressure_Min_Pa=0 The minimum pressure of the experiment. Pressure_Unit=Pa The initial units of pressure. Temp_Init_K=298 The initial temperature in Kelvin. Temp_H2O_Init_K=400 The initial temperature, in Kelvin, if the gas chosen is H2O. Temp_Max_K=3000 The maximum temperature, in Kelvin, allowed in the experiment. Temp_Min_K=0 The minimum temperature of the experiment. Temp_Unit=K The initial unit of temperature. n_Init=0 The initial number of moles. n_max=50.0 The maximum number of moles allowed in the experiment. Flow_Rate_Pa_1=10000.0 The rate the pressure is increased in the experiment (Pa/sec) for the different Flow_Rate_Pa_2=20000.0 regulator settings. Flow_Rate_Pa_3=30000.0 Flow_Rate_Pa_4=40000.0 Flow_Rate_Pa_5=50000.0 Flow_Rate_Pa_6=60000.0 Flow_Rate_Pa_7=70000.0 Flow_Rate_Pa_8=80000.0 Flow_Rate_Pa_9=90000.0 Flow_Rate_Pa_10=100000.0 Regulator_Pressure_1_Pa=138000 The pressure setting for the regulator at the various needle positions. Regulator_Pressure_2_Pa=276000 Regulator_Pressure_3_Pa=414000 Regulator_Pressure_4_Pa=552000 Regulator_Pressure_5_Pa=690000 Regulator_Pressure_6_Pa=827000 Regulator_Pressure_7_Pa=965000 Regulator_Pressure_8_Pa=1103000 Regulator_Pressure_9_Pa=1241000 Regulator_Pressure_10_Pa=1517000 P_Atmosphere_Pa=101010 The pressure settings on the regulator are actually relative to atmospheric

pressure. This variable specifies what is atmospheric pressure in the lab. Wide_Update_Time_mSec = 333 Time in milliseconds for the experiment to be updated in the zoomed out mode

when gas is being added. Temp_1_K=50 The temperature, in Kelvin, where the bath liquid changes color to indicate

changes in temperature (sea green to light blue). Temp_2_K=150 The temperature where the cord changes color from light blue to dark blue. Temp_3_K=250 The temperature where the cord changes color from dark blue to forest green. Temp_4_K=350 The temperature where the cord changes color from forest green to yellow. Temp_5_K=450 The temperature where the cord changes color from yellow to goldenrod. Temp_6_K=550 The temperature where the cord changes color from goldenrod to red. Real_Approx_Error_Per=0.0001 The error limit for iterating real gas solutions in per cent. [Experiment_3] (The following apply only to the Temperature Experiment.) Volume_Init_m^3=0.004 The initial volume of experiment in units of m3.

Page 86: Instructor utilities guide

A-15

Volume_H2O_Init_m^3=0.004 The initial volume of experiment in units of m3 if the gas chosen is H2O. Volume_Unit=m^3 The initial units of volume. Vol_Max_m^3=0.004 The maximum allowed volume of the experiment in units of m3. Vol_Min_m^3=0 The minimum allowed volume of the experiment in units of m3. Pressure_Init_Pa=0 The initial pressure in units of Pascals. Pressure_H2O_Init_Pa=0 The initial pressure in units of Pascals if the gas chosen is H2O. Pressure_Max_Pa=1e9 The maximum pressure, in units of Pascals, allowed in the experiment. Pressure_Min_Pa=1 The minimum pressure of the experiment. Pressure_Unit=Pa The initial units of pressure. Temp_Init_K=298 The initial temperature in Kelvin. Temp_H2O_Init_K=400 The initial temperature, in Kelvin, if the gas chosen is H2O. Temp_Max_K=3000 The maximum temperature, in Kelvin, allowed in the experiment. Temp_Min_K=0 The minimum temperature of the experiment. Temp_Unit=K The initial unit of temperature. n_Init=0.0 The initial number of moles. n_max=50.0 The maximum number of moles allowed in the experiment. Flow_Rate_Pa_1=10000.0 The rate the pressure is increased in the experiment (Pa/sec) for the different Flow_Rate_Pa_2=20000.0 regulator settings. Flow_Rate_Pa_3=30000.0 Flow_Rate_Pa_4=40000.0 Flow_Rate_Pa_5=50000.0 Flow_Rate_Pa_6=60000.0 Flow_Rate_Pa_7=70000.0 Flow_Rate_Pa_8=80000.0 Flow_Rate_Pa_9=90000.0 Flow_Rate_Pa_10=100000.0 Regulator_Pressure_1_Pa=138000 The pressure setting for the regulator at the various needle positions. Regulator_Pressure_2_Pa=276000 Regulator_Pressure_3_Pa=414000 Regulator_Pressure_4_Pa=552000 Regulator_Pressure_5_Pa=690000 Regulator_Pressure_6_Pa=827000 Regulator_Pressure_7_Pa=965000 Regulator_Pressure_8_Pa=1103000 Regulator_Pressure_9_Pa=1241000 Regulator_Pressure_10_Pa=1517000 P_Atmosphere_Pa=101010 The pressure settings on the regulator are actually relative to atmospheric

pressure. This variable specifies what is atmospheric pressure in the lab. Wide_Update_Time_mSec = 333 Time in milliseconds for the experiment to be updated in the zoomed out mode

when gas is being added. Real_Approx_Error_Per=0.0001 [Experiment_4] (The following apply only to the Cylinder Experiment.) Volume_Unit=m^3 The initial unit of volume. Vol_Min_m^3=0 The minimum volume allowed in units of m3. Pressure_Init_Pa=100000 The initial pressure in units of Pascals. Pressure_H2O_Init_Pa=100000 The initial pressure in units of Pascals if the gas chosen is H2O.

Page 87: Instructor utilities guide

A-16

Pressure_Max_Pa=1e9 The maximum pressure, in units of Pascals, allowed in the experiment. Pressure_Min_Pa=0 The minimum pressure of the experiment. Pressure_Unit=Pa The initial units of pressure. Internal_Pressure_Max_Pa=1e9 The maximum pressure, in Pascals, allowed inside the cylinder. Internal_Pressure_Min_Pa=0 The minimum pressure inside the cylinder. Internal_Pressure_Unit=Pa The initial units of the pressure inside the cylinder. Temp_Init_K=298 The initial temperature in Kelvin. Temp_H2O_Init_K=400 The initial temperature, in Kelvin, if the gas chosen is H2O. Temp_Max_K=3000 The maximum temperature, in Kelvin, allowed in the experiment. Temp_Min_K=0 The minimum temperature of the experiment. Temp_Unit=K The initial unit of temperature. n_Init=0.0 The initial number of moles. n_max=50.0 The maximum moles allowed in the experiment. Mass_Init_g=0 The initial mass on the piston. Mass_Max_g=5000000000 The maximum mass allowed on the piston in grams. Mass_Min_g=0 The minimum mass allowed on the piston in grams. Mass_Unit=g The initial unit of mass. Mass_1_Max_g=20000 The masses at which the size of the weight on the piston is changed to a Mass_2_Max_g=50000 larger or smaller image (in grams). Mass_3_Max_g=100000 Mass_4_Max_g=500000 Mass_5_Max_g=1000000 Mass_6_Max_g=2000000 Mass_7_Max_g=5000000 Mass_8_Max_g=10000000 Mass_9_Max_g=20000000 Cylinder_Height_m=0.40 The height of the cylinder used in the calculations (in m). Cylinder_Diameter_m=0.150 The diameter of the cylinder used in the calculations (in m). Explode_Speed=10 Speed in which the piston moves during an explosion. Oscillation_Damp=6 A constant in the piston dampening equation. Oscillation_Angle_Multiplier=1 A constant in the piston dampening equation. P_Atmosphere_Pa=101010 The pressure settings on the regulator are actually relative to atmospheric

pressure. This variable specifies what is atmospheric pressure in the lab. Temp_1_K=50 The temperature, in Kelvin, where the bath liquid changes color to indicate

changes in temperature (sea green to light blue). Temp_2_K=150 The temperature where the cord changes color from light blue to dark blue. Temp_3_K=250 The temperature where the cord changes color from dark blue to forest green. Temp_4_K=350 The temperature where the cord changes color from forest green to yellow. Temp_5_K=450 The temperature where the cord changes color from yellow to goldenrod. Temp_6_K=550 The temperature where the cord changes color from goldenrod to red. Real_Approx_Error_Per=0.0001 The error limit for iterating real gas solutions in per cent. Osc_Cutoff_Per=10.0 The maximum number of oscillations in the piston dampening equation.

Page 88: Instructor utilities guide

A-17

Units.ini INI Variables Description

[Pressure] Units=Pa,atm,psi,Torr,bar The different units that can be used for pressure. Labbook_Sig_Fig=7 The number of significant figures that will be saved in the lab book for

pressure. Labbook_Header=P The header used in the lab book for pressure when saving data. Pa_Prefix=1,k,M The prefixes that are possible when pressure is in units of Pascals. Pa_Prefix_factor=1,1e-3,1e-6 The multipliers that are used when the different prefixes are used. Pa_Prefix_Switch=1e3,1e6 The point at which the different prefixes are changed. Pa_Sig_Fig_Max=4,4,4 The maximum significant figures shown in the LCD for each prefix when units

of Pascals are used. Pa_Sig_Fig_Decimal=2,3,4 The maximum number of places after the decimal point for each prefix when

units of Pascals are used. atm_Prefix=1,k,M The prefixes that are possible when pressure is in units of atmospheres. atm_Prefix_factor=1,1e-3,1e-6 The multipliers that are used when the different prefixes are used. atm_Prefix_Switch=1e3,1e6 The point at which the different prefixes are changed. atm_Sig_Fig_Max=4,4,4 The maximum significant figures for each prefix shown in the LCD when units

of atmospheres are used. atm_Sig_Fig_Decimal=3,3,4 The maximum number of places after the decimal point for each prefix when

units of atmospheres are used. psi_Prefix=1 The prefix that is possible when pressure is in units of pounds per square inch. psi_Prefix_factor=1 The multiplier that is used. psi_Prefix_Switch=1 If more than one prefix were possible, the point at which the different prefixes

would be changed. psi_Sig_Fig_Max=4 The maximum significant figures shown in the LCD when units of pounds per

square inch is used. psi_Sig_Fig_Decimal=3 The maximum number of places after the decimal point for each prefix when

units of pounds per square inch are used. torr_Prefix=m,1,k The prefixes that are possible when pressure is in units of torr. torr_Prefix_factor=1e3,1,1e-3 The multipliers that are used when the different prefixes are used. torr_Prefix_Switch=.99999,1e3 The point at which the different prefixes are changed. torr_Sig_Fig_Max=3,4,4 The maximum significant figures shown in the LCD for each prefix when units

of torr are used. torr_Sig_Fig_Decimal=2,3,3 The maximum number of places after the decimal point for each prefix when

units of torr inch are used. bar_Prefix=m,1,k,M The prefixes that are possible when pressure is in bars. bar_Prefix_factor=1e3,1,1e-3,1e-6 The multipliers that are used when the different prefixes are used. bar_Prefix_Switch=.99999,1e3,1e6 The point at which the different prefixes are changed. bar_Sig_Fig_Max=4,4,4,4 The maximum significant figures shown in the LCD for each prefix when units

of bars are used. bar_Sig_Fig_Decimal=2,3,3,4 The maximum number of places after the decimal point for each prefix when

units of bars are used. [Volume] Units=m^3,L,cm^3,in^3,ft^3 The different units that can be used for volume. Labbook_Sig_Fig=7 The number of significant figures that will be saved in the lab book for volume. Labbook_Header=V The header used in the lab book for volume when saving data. m^3_Prefix=1 The prefix that is possible when volume is in units of m3.

Page 89: Instructor utilities guide

A-18

m^3_Prefix_factor=1 The multiplier that is used. m^3_Prefix_Switch=1 If more than one prefix were possible, the point at which the different prefixes

are changed. m^3_Sig_Fig_Max=4 The maximum significant figures shown in the LCD when units of m3 are used. m^3_Sig_Fig_Decimal=4 The maximum number of places after the decimal point when units of m3 are

used. L_Prefix=m,1 The prefixes that are possible when volume is in units of Liters. L_Prefix_factor=1e3,1 The multipliers that are used when the different prefixes are used. L_Prefix_Switch=1 The point at which the different prefixes are changed. L_Sig_Fig_Max=4,4 The maximum significant figures for each prefix shown in the LCD when units

of Liters are used. L_Sig_Fig_Decimal=4,4 The maximum number of places after the decimal point when units of Liters

are used. cm^3_Prefix=1 The prefix that is possible when volume is in units of cm3. cm^3_Prefix_factor=1 The multiplier that is used. cm^3_Prefix_Switch=1 If more than one prefix were possible, the point at which the different prefixes

are changed. cm^3_Sig_Fig_Max=4 The maximum significant figures shown in the LCD when units of cm3 are

used. cm^3_Sig_Fig_Decimal=4 The maximum number of places after the decimal point when units of cm3 are

used. in^3_Prefix=1 The prefix that is possible when volume is in units of in3. in^3_Prefix_factor=1 The multiplier that is used. in^3_Prefix_Switch=1 If more than one prefix were possible, the point at which the different prefixes

are changed. in^3_Sig_Fig_Max=4 The maximum significant figures shown in the LCD when units of in3 are used. in^3_Sig_Fig_Decimal=4 The maximum number of places after the decimal point when units of in3 are

used. ft^3_Prefix=1 The prefix that is possible when volume is in units of ft3. ft^3_Prefix_factor=1 The multiplier that is used. ft^3_Prefix_Switch=1 If more than one prefix were possible, the point at which the different prefixes

are changed. ft^3_Sig_Fig_Max=4 The maximum significant figures shown in the LCD when units of ft3 are used. ft^3_Sig_Fig_Decimal=4 The maximum number of places after the decimal point when units of ft3 are

used. [Temperature] Units=K,C,F,R The different units that can be used for temperature. Labbook_Sig_Fig=7 The number of significant figures that will be saved in the lab book for

temperature. Labbook_Header=T The header used in the lab book for temperature when saving data. K_Prefix=1 The prefix that is possible when temperature is in units of Kelvin. K_Prefix_Factor=1 The multiplier that is used. K_Prefix_Switch= If more than one prefix were possible, the point at which the different prefixes

are changed. K_Sig_Fig_Max=5 The maximum significant figures shown in the LCD when Kelvin is used. K_Sig_Fig_Decimal=2 The number of significant figures after the decimal point. c_Prefix=1 The prefix that is possible when temperature is in units of Celsius. c_Prefix_Factor=1 The multiplier that is used. c_Prefix_Switch= If more than one prefix were possible, the point at which the different prefixes

Page 90: Instructor utilities guide

A-19

are used. c_Sig_Fig_Max=5 The maximum significant figures shown in the LCD when Celsius is used. c_Sig_Fig_Decimal=2 The number of significant figures after the decimal point. f_Prefix=1 The prefix that is possible when temperature is in units of Fahrenheit. f_Prefix_Factor=1 The multiplier that is used. f_Prefix_Switch= If more than one prefix were possible, the point at which the different prefixes

are changed. f_Sig_Fig_Max=5 The maximum significant figures shown in the LCD when Fahrenheit is used. f_Sig_Fig_Decimal=2 The number of significant figures after the decimal point. r_Prefix=1 The prefix that is possible when temperature is in units of Rankin. r_Prefix_Factor=1 The multiplier that is used. r_Prefix_Switch= If more than one prefix were possible, the point at which the different prefixes

are changed. r_Sig_Fig_Max=5 The maximum significant figures shown in the LCD when Rankin is used. r_Sig_Fig_Decimal=2 The number of significant figures after the decimal point. [mass] (This section applies to the Cylinder Experiment.) Units=g,lbs,Tons The different units that can be used for mass. Labbook_Sig_Fig=5 The number of significant figures that will be saved in the lab book for mass. Labbook_Header=m The header used in the lab book for mass when saving data. g_Prefix=k,M The prefixes that are possible when the mass is in units of grams. g_Prefix_Factor=1e-3,1e-6 The multipliers that are used when the different prefixes are used. g_Prefix_Switch=1e6 The point at which the different prefixes are changed. g_Sig_Fig_Max=3 The maximum significant figures shown in the LCD for each prefix when grams

are used. g_Sig_Fig_Decimal=1 The number of significant figures after the decimal point. lbs_Prefix=1,k The prefixes that are possible when mass is in units of lbs. lbs_Prefix_Factor=1,1e-3 The multipliers that are used when the different prefixes are used. lbs_Prefix_Switch=1e3 The point at which the different prefixes are changed. lbs_Sig_Fig_Max=4 The maximum significant figures shown in the LCD for each prefix when lbs

are used. lbs_Sig_Fig_Decimal=2 The number of significant figures after the decimal point. Tons_Prefix=1 The prefix that is possible when mass is in units of tons. Tons_Prefix_Factor=1 The multiplier that is used. Tons_Prefix_Switch= If more than one prefix were possible, the point at which the different prefixes

are used. Tons_Sig_Fig_Max=4 The maximum significant figures shown in the LCD when tons are used. Tons_Sig_Fig_Decimal=2 The number of significant figures after the decimal point. [moles] Units=moles The unit used for moles. Labbook_Sig_Fig=4 The number of significant figures that will be saved in the lab book for moles. Labbook_Header=n The header used in the lab book for moles when saving data. moles_Prefix=1 The prefixes that are possible for moles. moles_Prefix_Factor=1 The multipliers that are used when the different prefixes are used. moles_Prefix_Switch= The point at which the different prefixes are changed. moles_Sig_Fig_Max=4 The maximum significant figures shown in the LCD for each prefix when moles

are used. moles_Sig_Fig_Decimal=4 The number of significant figures after the decimal point.

Page 91: Instructor utilities guide

A-20

[Conversion_Factors] Pa_to_Torr=7.5006e-3 The conversion factors between different units of pressure. The numbers are Pa_to_psi=1.45038e-4 converted by multiplying the number in the first unit by the conversion factor. Pa_to_atm=9.86923e-6 Pa_to_bar=1e-5 m^3_to_L=1e3 The conversion factors between different units of volume. The numbers are m^3_to_cm^3=1e6 converted by multiplying the number in the first unit by the conversion factor. m^3_to_ft^3=35.3147 m^3_to_in^3=61023.74 g_to_lbs=0.00220462 The conversion factors between different units of mass. The numbers are g_to_Tons=0.00000110231 converted by multiplying the number in the first unit by the conversion factor.

Preset Experiments Located on the clipboard in the gases stockroom is a set of 15 preset experiments listed by title.

If allowed by the instructor, students can select one of these experiments and, upon returning to

the laboratory, the selected experiment will be automatically set up and running. A preset

experiment can also be used for assignments so a student can accept an assignment with the

experiment already set up for them. Preset experiments are intended to provide flexibility for the

instructor so the gases simulation can be adapted to the level of the class or the individual

teaching style of the instructor. Several experiments have already been defined and are installed

with the software. This section describes how these files can be modified.

Each preset experiment is defined using an INI file. For the preset experiments on the clipboard,

these files have the name Experimentn.ini, where n is a number between 1 and 15 and represents

experiments 1 through 15 on the clipboard. These files are located in the Presets directory in the

ChemLabG directory. For the preset experiments used in assignments, these files must be located

in the Assignments/Gases directory and can have any name, but must have the extension “.ini”.

Information on how to use preset experiments in assignments is given in the “Gases

Assignments” section. Note that in client installations, any modified preset experiments for the

clipboard must be modified for each client installation.

Given subsequently is a description of a preset experiment INI file and the variables that are used

to define an experiment. Before reviewing the INI file information, here are some important

points to keep in mind: (a) All of the variables described have default values, so variables may be

left blank or not used at all. An experiment can be set up or defined to any degree desired by the

instructor. (b) Some variables are mutually exclusive; that is, the use of one variable may mean

another variable cannot be used. Some error checking exists for such situations, but the error

checking is not comprehensive.

The following two tables show the INI variables used in preset experiments. The first lists all the

variables that can be used and their allowed values. Default values are given in red. The second

is an example of a preset experiment for a pressure experiment using water as a gas to show how

the variables can be used.

Page 92: Instructor utilities guide

A-21

Complete Preset Experiment INI Variable List

INI Variables Description [Title] Title=Cylinder Experiment Ideal

Sets the title of the experiment as shown on the clipboard. Not used for preset electronic assignments.

[Experiment] Experiment_Num=0,1,2,3,4 Defines which experiment will be used. Gas=N2, CO2, CH4, H2O, NH3, He, vdw, Ideal1, Ideal2, Ideal3, Ideal4, Ideal5, Ideal6, Ideal7, Ideal8

Defines which gas will be used. If an ideal gas mixture is used, use a comma to separate the gases.

VDWa= VDWb=

Sets the a and b parameters for a van der Waals gas. These only need to be present if a van der Waals gas is selected.

Temperature_K= (Default = 298) Sets the temperature of the experiment in Kelvin if temperature is not the

dependent variable. Pressure_Pa= (Default =100000 for Balloon

Experiment, 0 for Temperature and Cylinder

Experiment.)

Sets the pressure of the experiment in Pascals if pressure is not the dependent variable. For the Cylinder Experiment, this sets the external pressure.

moles= Sets the number of moles in the experiment. If an ideal gas mixture is used, separate each amount by a comma and the moles will be matched with the corresponding gas.

Volume_m^3= (Default = 0.004 for

Pressure and Temperature Experiments) Sets the volume of the experiment if volume is not the dependent variable.

mass_kg= (Default =0) Sets the mass on the piston for the Cylinder Experiment. prePiston_Temp_K= (Default = 273) Used for pre piston calculations if the piston is turned on in the Cylinder

Experiment. prePiston_Pressure_Pa= (Default =

506.625e3) Sets the internal pressure in the Cylinder Experiment.

Temperature_Unit= K,C,F,R (Default = K) Sets the starting unit for temperature. Pressure_Unit= Pa,atm,psi,Torr,bar (Default = Pa)

Sets the starting unit for pressure.

Volume_Unit= m^3,L,cm^3,in^3,ft^3 (Default = m^3)

Sets the starting unit for volume.

mass_Unit= g,lbs,Tons (Default = g) Sets the starting unit for mass in the Cylinder Experiment. Internal_Pressure_Unit= Pa,atm,psi,Torr, Sets the starting unit for the internal pressure in the Cylinder Experiment. GasAttached=1, yes, 0, no (Default = no) Defines whether the gas is already attached to the experiment. AttachedGas= Used only if a mixture is selected. It defines which gas is attached. RegulatorPosition=0-10 (Default = 6) Defines the position of the regulator needle if the gas is attached. PistonOn=1, yes, 0, no (Default = no) Sets the piston as on or off in the Cylinder Experiment. Ideal_Real=Ideal, Real (Default = Real) Sets the gas tanks to show either the real gases or the ideal gases. Zoom=yes, no (Default = no) Sets the initial view of the experiment as zoomed in (yes) or zoomed out (no).

Page 93: Instructor utilities guide

A-22

An Example Pressure Preset Experiment

INI Variables Description [Title] Title=Pressure Experiment H2O Defines the title of the experiment as shown on the clipboard. Not used for

preset assignments. [Experiment] Experiment_Num=2 Defines the experiment as the Pressure Experiment. Gas=H2O Defines the gas to be used as H2O Temperature_K=400 Sets the initial temperature to 400 Kelvin. Pressure_Pa= Pressure is the dependent variable in this experiment. moles=.1 Sets the number of moles in the experiment to 0.1. Volume_m^3=0.004 Sets the volume of the experiment to 0.004 m3. Temperature_Unit=K Sets the starting temperature unit as Kelvin. Pressure_Unit=atm Sets the starting pressure unit as atm. Volume_Unit=L Sets the starting volume unit as L. GasAttached=Yes Attaches the gas to the experiment. AttachedGas=H2O Sets the attached gas as H2O. RegulatorPosition=6 Sets the gas needle on the regulator to position 6. Ideal_Real=Real Sets the gases in the lab to be the real gases.

Titration INI Files

The titration laboratory allows students to perform precise, quantitative titrations involving acid-

base and electrochemical reactions. Much of the operation of the laboratory and the parameters

defining the experiments is controlled using INI variables located in the files Lab Variables.ini,

Acidn.ini or Basen.ini, Indicators.ini, Oxidantn.ini, Reductantn.ini, and Saltn.ini located in the

Reagents directory in the ChemLabT directory. The variables in LabVariables.ini generally

control aspects of the laboratory as a whole, and the Indicators.ini file defines the indicators that

can be used for acid-base titrations. Each acid, base, oxidant, reductant, or salt file defines a

bottle in the titration stockroom where n designates the bottle position on the shelf. There is one

additional set of INI files and these define the preset experiments located on the stockroom.

Described in each of the following sections are the INI variables contained in each of these INI

files. The purpose for providing this information is to grant instructors the ability to change or

adjust the titration simulation to suit their own needs.

Lab Variables.ini INI Variables Description [General] Base_Lab_pressure=760 Every day a new random pressure is calculated that will be the same for each

member in a class. This the initial base pressure for the lab in Torr. Plus_Minus_pressure=15 The min/max spread in pressure. %Humidity=50 The percent humidity in the lab. Labbook_Data_Line_Limit=1000 The maximum number of lines of titration data saved in one link before a new

Page 94: Instructor utilities guide

A-23

link is automatically started. Labbook_Plot_Point_Limit = 100 The maximum number of points that will be plotted on the graph. [pH Meter] pH_Slope_%dev=200 The amount of deviation in the slope of an uncalibrated pH meter. pH_Intercept_Max=4 The maximum intercept for an uncalibrated pH meter. pH_Flicker_Time=4 The amount of time between flicker calculations for the pH meter display. pH_Flicker_Max=.01 The maximum amount the pH meter can flicker above or below the true value. pH_Min=0 The minimum pH possible. pH_Max=14 The maximum pH possible. [Voltmeter] Volt_Max_Flicker=0 The maximum amount the voltmeter can flicker above or below the true value. Volt_Flicker_Time=4 The amount of time between flicker calculations for the voltmeter display. Volt_Graph_Min=-5 The minimum voltage possible on a voltage graph. Volt_Graph_Max=5 The maximum voltage possible on a voltage graph. Volt_Calc_Min=-5 The minimum voltage possible for the EMF calculation. Volt_Calc_Max=5 The maximum voltage possible for the EMF calculation. [Conductivity Meter] Conductivity_Max_Flicker=.01 The maximum amount the conductivity meter can flicker above or below the

true value. Conductivity_Flicker_Time=3 The amount of time between flicker calculations for the conductivity display. [Graph Tool] Plot_View_Coords=70,8,329,179 The coordinates for the graph in the plot window. ph_color=55,75,255 The RGB values for the color of the pH line on the graph. conductivity_color=255,55,55 The RGB values for the color of the conductivity line on the graph. tick_line_color=55,55,55 The RGB values for the color of the tick marks on the graph. Label_Text_Size=6 The font size for the graph labels. [Balance] Weights_Density=8 The density of the calibration weights. Balance_Flicker_Max=.0001 The maximum amount the balance can flicker above or below the true value. Balance_Flicker_Time=2.5 The amount of time between flicker calculations for the balance display. Weigh_paper_mass=.225 The average mass of the weigh paper. Weigh_paper_mass_%dev=5 The maximum percent deviation for each weigh paper from the average mass. Level1=0.01 The masses of solid added for each scoop size on the side of the bottle. Level2=0.05 Level3=0.1 Level4=0.2 Level5=0.5 Solid_%dev=5 The maximum percent deviation for each scoop size when solid is added onto

the balance. Weigh_paper_amount_1=.01 The mass of solid represented by the graphic for each pile of solid. Weigh_paper_amount_2=.1 Weigh_paper_amount_3=.5 Weigh_paper_amount_4=1 Weigh_paper_amount_5=2 Weigh_paper_amount_6=4 Weigh_paper_amount_7=6 Weigh_paper_amount_8=8 Weigh_paper_amount_9=11 Weigh_paper_amount_10=15 [Glassware]

Page 95: Instructor utilities guide

A-24

Beaker_mass=100 The average mass of each beaker. Beaker_mass_%dev=5 The maximum percent deviation of each beaker from the average mass. Beaker_vol=.250 The average volume of each beaker. Beaker_vol_%dev=.7 The maximum percent deviation of each beaker from the average volume. Beaker_overflow_vol=.300 The volume at which the beaker overflow animation will be played. BuretRandom_%dev=.16 The maximum percent deviation from true volume. Buret_%dev=.1 The applied error to the true buret volumes. PipetRandom_%dev=.32 The maximum percent deviation from true volume for the pipets. Pipet_%dev=.12 The maximum percent deviation from the true volume for the pipets Grad_vol1=.005 The average volume of the graduated cylinders. Grad_vol2=.010 Grad_vol3=.025 Grad_vol4=.050 Grad_%dev=.5 The maximum percent deviation from the actual volume for the graduated

cylinders. WaterBottle_vol=.001 The average volume delivered by the water bottle. WaterBottle_%dev=10 The maximum percent deviation from the average volume delivered by the

water bottle. [Stir plate] Rate_On=1 The time that it takes in seconds, with the stir plate on, for the meters to

display the newly calculated values after something is added from the buret into the beaker.

Rate_Off=5 The time that it takes in seconds, with the stir plate off, for the meters to display the newly calculated values after something is added from the buret into the beaker.

[Buret flow rate] Position2=0.5 drops/sec The rate at which the buret solution is delivered to the beaker when the

stopcock is at position 2. Specified in drops/sec or mL/sec. Position3=2.0 drops/sec The rate at position 3. Position4=0.5 mL/sec The rate at position 4. Position5=1 mL/sec The rate at position 5. Drop_vol_mL= 0.0544 The average volume of each drop. Vol_%dev=5 The maximum percent deviation from the average drop size. [Other flow rates] bottle_flow=20 mL/sec The rate at which liquids flow from the bottle in mL/sec. sink_flow=30 mL/sec The rate at which water is delivered from the sink in mL/sec. flow_delay_sec=0.5 The time in seconds after a bottle is positioned over the buret or a beaker

under the sink or a graduated cylinder over a beaker, etc. before the volume starts to be delivered.

[Iterations] Allowed_dev_charge=.0000001 The maximum percent deviation of the initial possible minimum and maximum

pH’s. Allowed%dev_VolT=.001 The maximum percent deviation of the final iteration from the preceding

iteration in acid-base titration calculations. Allowed%dev_VolR=.01 The maximum percent deviation of the final iteration from the preceding

iteration in redox titration calculations. Allowed%dev_IonicS=.000001 The maximum percent deviation of the final iteration from the preceding

iteration of the activity coefficients.

Page 96: Instructor utilities guide

A-25

Acidn.ini or Basen.ini INI Variables Description [General] Name= Long name that pops up when the bottle is moused over. Short_name= Name that appears on the bottle. Phase=solid, aqueous Phase of the substance. Color=(clear, white, yellow, pink, orange, red, green, blue, purple, darkgreen, darkred, darkblue, or darkpurple)

Color of the substance.

Unknown=yes,no Defines whether or not the reagent can be made into an unknown. [Solids] This section applies only to reagents that are solids. MW= The molecular weight of the reagent. Density= The density of the reagent. Max_Conc= The maximum concentration allowed for the reagent when mixed with water. %Weight= The weight percent (impurity) for the reagent on the stockroom shelf. %Weight_Min= The minimum weight percent allowed when making unknowns. %Weight_Max= The maximum weight percent allowed when making unknowns. %Wt_Init_Min= The initial minimum weight percent when creating an unknown. %Wt_Init_Max= The initial maximum weight percent when creating an unknown. Impurity= Defines what the impurity is in solids that are not 100% pure. The impurity is

defined by specifying the name of the INI file representing the impurity (usually NaCl).

[Aqueous Solutions] This section applies only to aqueous solutions. Conc= The concentration given in mol/L or ‘random’. If a concentration is given, then

that concentration is fixed at startup. If ‘random’ is given, then a random concentration between the minimum and maximum is used at startup.

Conc_Min= The minimum concentration allowed when making unknowns. Conc_Max= The maximum concentration allowed when making unknowns. Conc_Init_Min= The initial minimum concentration when creating unknowns. Conc_Init_Max= The initial maximum concentration when creating unknowns. [Initial species] 1=HP,1- The initial species of acid or base after it has dissociated in water and its

charge. M_1=1 The stoichiometric coefficient of initial species. Z1=-1 The charge of initial species. Inert_ion=K,1+ The charge of inert ion. M_inert_ion=1 The stoichiometric coefficient of inert ion. Z_inert_ion=1 The charge of inert ion [Reaction species] 2=P,2- The species in solution and its charge after the first species dissociates. 2-4 3= are acidic species (3-4 are for the species of polyprotic acids) and 5-7 are 4= basic species (6-7 are for the species of polybasic bases). 5=H2P 6= 7= [Equilibrium constants] Ka1=3.908E-06 The equilibrium constants for the acid and conjugate base or base and Ka2=0 conjugate acid. More than one set of equilibrium constants is defined for Ka3=0 polyprotic acids or polybasic bases. Kb1=8.995E-12

Page 97: Instructor utilities guide

A-26

Kb2=0 Kb3=0 [Activity coefficients] HR1=700 The hydrated radius of each species. HR2=700 HR3= HR4= HR5=0 HR6= HR7= HR_inert_ion=300 [Conductivity] 1ec=30 The conductance ( o) of the species.

2ec=45 3ec= 4ec= 5ec=0 6ec= 7ec= Inert_ion_ec=73.48 [Partial Molal Volume] V1=83.0 The partial molal volume of each species in cm3/mol. V2=106.3 V3= V4= V5=115 V6= V7= V_inert_ion=9.02 [Molecular Weight] MW1=165.124 The molecular weight of each dissociated species. MW2=164.115 MW3= MW4= MW5=166.132 MW6= MW7= MW_inert_ion=39.098

Indicators.ini INI Variables Description [General] Acid_Start=1.8 The following variables define the pH chart in the lab view and popup view Base_End=1.8 [Popup] Vertical_Pos=-2 Bar_Height=11 Label_Font_Size=12.5 Transistion_Range=5

Page 98: Instructor utilities guide

A-27

[TitrationLab] Vertical_Pos=0 Bar_Height=2 Label_Font_Size=3 Transistion_Range=1 [Color] Yellow=254,254,7 The RGB values to use for each color. Red=214,49,63 Purple=211,164,218 Pink=255,164,188 Blue=132,214,250 Clear=230,231,231 DarkBlue=53,51,143 DarkGreen=60,83,55 DarkPurple=73,42,79 DarkRed=99,51,65 Green=91,182,138 Orange=246,114,23 [Bottle 1] Name=Methyl violet The name of the indicator in the first bottle. Short_name=Met V The name that appears on the bottle label. Transition1_Start=0.1 The pH at which the color begins to change for the first transition. Transition1_End=1.6 The pH at which the color change is complete for the first transition. Acid_color=Yellow The color of the indicator on the acid side of the transition. Mix1_color=blue The color of the indicator in between the beginning and ending pH of the first

transition. Base1_color=purple The color of the indicator after the first transition. Transition2_Start= The pH at which the color begins to change for the second transition. Transition2_End= The pH at which the color change is complete for the second transition. Mix2_color= The color of the indicator in between the beginning and ending pH of the second

transition. Base2_color= The color of the indicator after the second transition. This is duplicated for bottles 2 through 8.

Oxidantn.ini INI Variables Description [General] Name=Permanganate - Acid Long name that pops up when the bottle is moused over. Short_name=KMnO4 Name that appears on the bottle. Solution=Acid Defines the oxidant as being in acidic, neutral, or basic solution. Phase=aqueous Phase of the substance. Color=darkpurple Color of the substance. (See Acid/Base file for list of colors.) Unknown=yes Defines whether or not the reagent can be made into an unknown. [Solids] This section applies only to reagents that are solids. MW= The molecular weight of the reagent. Density= The density of the reagent. Max_Conc= The maximum concentration allowed for the reagent when mixed with water. %Weight= The weight percent (impurity) for the reagent on the stockroom shelf. %Weight_Min= The minimum weight percent allowed when making unknowns. %Weight_Max= The maximum weight percent allowed when making unknowns. %Wt_Init_Min= The initial minimum weight percent when creating an unknown. %Wt_Init_Max= The initial maximum weight percent when creating an unknown.

Page 99: Instructor utilities guide

A-28

Impurity= Defines what the impurity is in solids that are not 100% pure. The impurity is defined by specifying the name of the INI file representing the impurity (usually NaCl).

[Aqueous Solutions] This section applies only to reagents that are aqueous. Conc=0.02 The concentration given in mol/L or ‘random’. If a concentration is given, then

that concentration is fixed at startup. If ‘random’ is given, then a random concentration between the minimum and maximum is used at startup.

Conc_Min=0.005 The minimum concentration allowed when making unknowns. Conc_Max=0.08 The maximum concentration allowed when making unknowns. Conc_Init_Min=.001 The initial concentration percent when creating an unknown. Conc_Init_Max=.01 The initial concentration percent when creating an unknown. Water_EMF=1.368 The EMF when the oxidant is in water by itself. [Acid_Base] Acid_Base_Conc=2.0 The concentration of the acid or base in the solution. Cat=H,1+ The cationic species and charge. M_Cat=1 The stoichiometric coefficient of cation. Z_Cat=1 The charge of cation. Ani=Cl,1- The anionic species and charge. M_Ani=1 The stoichiometric coefficient of anion. Z_Ani=-1 The charge of anion. [Inert ion] Inert_ion=K,1+ Identification and charge of inert species. M_inert_ion=1 The stoichiometric coefficient of inert species. Z_inert_ion=1 The charge of inert species. HR_inert_ion=300 The hydrated radius of inert species. Inert_ion_ec=73.48 The equivalent conductance ( o

) of inert ion.

V_Inert_ion=9.02 The partial molal volume of the inert ion in cm3/mol. MW_Inert_ion=39.098 The molecular weight of the inert species. [Half reaction] The half reaction for each oxidizing agent is cR2+fX+oH++nRe-�aR1+eW+mOH-.

If a part is not applicable, then it will be left blank. R1 is the oxidizing agent, R2 is the reducing agent produced, and X and W are other species involved in the half reaction.

SEP=1.507 The standard reduction potential in volts. R1=MnO4,1- The species that is reduced and its charge. M_R1=1 The stoichiometric coefficient of the species that is reduced. Z_R1=-1 The charge of the species that is reduced. R1_color=darkpurple The color of the species that is reduced. R1_phase=aqueous The phase of species that is reduced. a=1 The stoichiometric coefficient for R1 W= The species for W Z_W= The charge for W W_phase= The phase for W e= The stoichiometric coefficient for W m=8 The stoichiometric coefficient for OH nR=5 The stoichiometric coefficient for e-

R2=Mn,2+ The species after it has been reduced and its charge. Z_R2=2 The charge of the reduced species. R2_color=clear The color of the reduced species. R2_phase=aqueous The phase of the reduced species. c=1 The stoichiometric coefficient for R2 X=H2O The species for X. Z_X=0 The charge for X.

Page 100: Instructor utilities guide

A-29

X_phase=liquid The phase for X. f=4 The stoichiometric coefficient for X. o= The stoichiometric coefficient for H+

[Activity coefficients] HR_R1=350 The hydrated radius of R1. HR_W= The hydrated radius of W. HR_R2=600 The hydrated radius of R2. HR_X=0 The hydrated radius of X. HR_Cat=900 The hydrated radius of the cation of the acid or base. HR_Ani=300 The hydrated radius of the anion of the acid or base. [Conductivity] R1_ec=67 The equivalent conductance ( o

) of R1.

W_ec= The equivalent conductance ( o) of W.

R2_ec=110 The equivalent conductance ( o) of R2.

X_ec= The equivalent conductance ( o) of X.

Cat_ec=349.65 The equivalent conductance ( o) of the cation of the acid or base.

Ani_ec=76.31 The equivalent conductance ( o) of the anion of the acid or base.

[Partial Molal Volume] V_R1=42.5 The partial molal volume of R1 in cm3/mol. V_W= The partial molal volume of W in cm3/mol. V_R2=-17.7 The partial molal volume of R2 in cm3/mol. V_X= The partial molal volume of X in cm3/mol. V_Cat=0 The partial molal volume of the cation of the acid or base in cm3/mol. V_Ani=17.83 The partial molal volume of the anion of the acid or base in cm3/mol. [Molecular Weight] MW_R1=118.934 The molecular weight of R1. MW_W= The molecular weight of W. MW_R2=54.938 The molecular weight of R2. MW_X=18.015 The molecular weight of X. MW_cat=1.008 The molecular weight of the cation of the acid or base. MW_ani=35.453 The molecular weight of the anion of the acid or base.

Reductantn.ini [General] Name=Iron(II) Chloride Long name that pops up when the bottle is moused over. Short_name=FeCl2 Name that appears on the bottle. Phase=solid (or liquid or aqueous) Phase of the substance. Color=green Color of the substance in water. (See Acid/Base file for list of colors.) Unknown=yes Defines whether or not the reagent can be made into an unknown. [Solids] This section applies only to reagents that are solids. MW=151.909 The molecular weight of the reagent. Density=3.16 The density of the reagent. Max_Conc=5.1 The maximum concentration allowed for the reagent when mixed with water. %Weight=90 The weight percent (impurity) for the reagent on the stockroom shelf. %Weight_Min=50 The minimum weight percent allowed when making unknowns. %Weight_Max=100 The maximum weight percent allowed when making unknowns. %Wt_Init_Min=80 The initial minimum weight percent when creating an unknown. %Wt_Init_Min=90 The initial maximum weight percent when creating an unknown. Impurity=NaCl Defines what the impurity is in solids that are not 100% pure. The impurity is

defined by specifying the name of the INI file representing the impurity (usually

Page 101: Instructor utilities guide

A-30

NaCl). [Aqueous Solutions] This section applies only to reagents that are aqueous. Conc= The concentration given in mol/L or ‘random’. If a concentration is given, then

that concentration is fixed at startup. If ‘random’ is given, then a random concentration between the minimum and maximum is used at startup.

Conc_Min= The minimum concentration allowed when making unknowns. Conc_Max= The maximum concentration allowed when making unknowns. Conc_Init_Min= The initial concentration percent when creating an unknown. Conc_Init_Max= The initial concentration percent when creating an unknown. Water_EMF=1.368 The EMF when the reductant is in water by itself. [Neutral species] Species present in neutral solution (not an acidic or basic solution). O1=Fe,2+ The species that is reduced and its charge. M_O1=1 The stoichiometric coefficient of the species that is reduced. Z_O1=2 The charge of the species that is reduced. O1_color=clear The color of species that is reduced. O1_phase=aqueous The phase of species that is reduced. [Inert ion] Inert_ion=Cl,1- Identification and charge of inert species. M_inert_ion=2 The stoichiometric coefficient of inert species. Z_inert_ion=-1 The charge of inert species. HR_inert_ion=300 The hydrated radius of inert species. Inert_ion_ec=76.31 The equivalent conductance ( o

) of the inert ion.

V_Inert_ion=17.83 The partial molal volume of the inert ion in cm3/mol. MW_Inert_ion=35.453 The molecular weight of inert species. [Half reaction(acid)] The half reaction for each reducing agent is dO2+hZ+nH++nOe-�bO1+gY+pOH-.

If a part is not applicable, then it will be left blank. O1 is the reducing agent, O2 is the oxidizing agent produced, and Z and Y are other species involved in the half reaction. The following section applies to reactions in acidic solution.

SEP=0.732 The standard reduction potential in volts. O1=Fe,2+ The species that is reduced and its charge. M_O1=1 The stoichiometric coefficient of the species that is reduced. Z_O1=2 The charge of the species that is reduced. O1_color=clear The color of the species that is reduced. O1_phase=aqueous The phase of the species that is reduced. b=1 The stoichiometric coefficient for O1. Y= The species for Y. Z_Y= The charge for Y. Y_phase= The phase for Y. g= The stoichiometric coefficient for Y. p= The stoichiometric coefficient for OH-. nO=1 The stoichiometric coefficient for e-. O2=Fe,3+ The species after it has been reduced and its charge. Z_O2=3 The charge of reduced species. O2_color=clear The color of reduced species. O2_phase=aqueous The phase of reduced species. d=1 The stoichiometric coefficient for O2. Z= The species for Z. Z_Z= The charge for Z. Z_phase= The phase for Z� h= The stoichiometric coefficient for Z. n= The stoichiometric coefficient for H+.

Page 102: Instructor utilities guide

A-31

[Activity coefficients(acid)] HR_O1=600 The hydrated radius of O1. HR_Y= The hydrated radius of Y. HR_O2=900 The hydrated radius of O2. HR_Z= The hydrated radius of Z. [Conductivity(acid)] O1_ec=108 The equivalent conductance ( o

) of O1.

Y_ec= The equivalent conductance ( o) of Y.

O2_ec=204 The equivalent conductance ( o) of O2.

Z_ec= The equivalent conductance ( o) of Z.

[Partial Molal Volume(acid)] V_O1=-24.7 The partial molal volume of O1 in cm3/mol. V_Y= The partial molal volume of Y in cm3/mol. V_O2=-43.7 The partial molal volume of O2 in cm3/mol. V_Z= The partial molal volume of Z in cm3/mol. [Molecular Weight(acid)] MW_O1=55.847 The molecular weight of O1. MW_Y= The molecular weight of Y. MW_O2=55.847 The molecular weight of O2. MW_Z= The molecular weight of Z. [Half reaction(base)] Repeat for basic half reaction. SEP=-0.86 O1=Fe(OH)2 M_O1=1 Z_O1=0 O1_color=green O1_phase=solid b=2 Y= Z_Y= Y_phase= g= p=2 nO=1 O2=Fe2O3 Z_O2=0 O2_color=red O2_phase=solid d=1 Z=H2O Z_Z=0 Z_phase=liquid h=3 n= [Activity coefficients(base)] HR_O1= HR_Y= HR_O2= HR_Z= [Conductivity(base)]

Page 103: Instructor utilities guide

A-32

O1_ec=0 Y_ec= O2_ec=0 Z_ec=0 [Partial Molal Volume(base)] V_O1= V_Y= V_O2= V_Z= [Molecular Weight(base)] MW_O1=89.861 MW_Y= MW_O2=159.691 MW_Z=18.015

Saltn.ini [General] Name=Barium Chloride Long name that pops up when the bottle is moused over. Short_name=BaCl2 Name that appears on the bottle. Phase=solid Phase of the substance. Color=white Color of the substance in water. (See Acid/Base file for list of colors.) [Solids] These are assumed to be pure. MW=208.233 The molecular weight of substance. Density=3.856 The density of substance. Max_Conc=1.8 The maximum concentration when dissolved in water. [Aqueous Solutions] Conc= The concentration of substance. [Species] Cat=Ba,2+ The species from the compound that becomes the cation and its charge. M_Cat=1 The stoichiometric coefficient of the cation. Z_Cat=2 The charge of the cation. Ani=Cl,1- The species from the compound that becomes the anion and its charge. M_Ani=2 The stoichiometric coefficient of the anion. Z_Ani=-1 The charge of the anion. [Activity coefficients] HR_Cat=500 The hydrated radius of the cation. HR_Ani=300 The hydrated radius of the anion. [Conductivity] Cat_ec=130 The equivalent conductance ( o) of the cation.

Ani_ec=76.31 The equivalent conductance ( o) of the anion.

[Partial Molal Volume] V_Cat=-12.47 The partial molal volume of the cation in cm3/mol. V_Ani=17.83 The partial molal volume of the anion in cm3/mol. [Molecular Weight] MW_cat=137.327 The molecular weight of the cation. MW_ani=35.453 The molecular weight of the anion.

Page 104: Instructor utilities guide

A-33

Preset Experiments Located on the clipboard in the titration stockroom is a set of 15 preset experiments listed by

title. If allowed by the instructor, students can select one of these experiments and, upon

returning to the laboratory, the selected experiment will be automatically set up and running.

Preset experiments are intended to provide flexibility for the instructor so the titration simulation

can be adapted to the level of the class or the individual teaching style of the instructor. Several

experiments have already been defined and are installed with the software. This section describes

how these files can be modified.

Each preset experiment is defined using an INI file. For the preset experiments on the clipboard,

these files have the name Experimentn.ini, where n is a number between 1 and 15 and represents

experiments 1 through 15 on the clipboard. These files are located in the Presets directory in the

ChemLabT directory. Note that in client installations, any modified preset experiments for the

clipboard must be modified for each client installation.

Given subsequently is a description of a preset experiment INI file and the variables that are used

to define an experiment. Before reviewing the INI file information, here are some important

points to keep in mind: (a) All of the variables described have default values, so variables may be

left blank or not used at all. An experiment can be set up or defined to any degree desired by the

instructor. (b) Some variables are mutually exclusive; that is, the use of one variable may mean

another variable cannot be used. Some error checking exists for such situations, but the error

checking is not comprehensive.

The following two tables show the INI variables used in preset experiments. The first lists all the

variables that can be used and their allowed values. Default values are given in red. The second

is an example of a preset experiment for a strong acid vs. polyprotic acid titration to show how

the variables can be used.

Complete Titration Preset Experiment INI Variable List

[Title] Title=Polyprotic Acid Strong Base Unknown

The title of the preset experiment.

[General] ActivityCoefficient=0,1 (Default = 1) Sets whether the activity coefficients are on or off. On is 1. IndicatorUsed=0-8 (Default = 0) Sets which indicator is used based on the number of each indicator in the

indicator.ini file. Zero is none. [pH Volt Meter] Calibrated=0,1 (Default = 1) Sets whether the pH/voltmeter is already calibrated. 1 is calibrated. Window_Open=0,1 (Default = 1 if the

probe is in the beaker)

Sets whether the pH/voltmeter window is open. Zero is closed.

In_Beaker=0,1 (Default = 1) Sets whether the pH/voltmeter probe is in the beaker or in the rack. Zero is in the rack.

[Conductivity Meter] In_Beaker=0,1 (Default = 1) Sets whether the conductivity meter is in the beaker or in the rack. Zero is in the

rack. Window_Open=0,1 (Default = 1 if the

probe is in the beaker) Sets whether the conductivity meter window is open. Zero is closed.

Page 105: Instructor utilities guide

A-34

[Unknowns] Bottle=1,2,3 Defines which bottle is the unknown. 1-3 are possible. The numbers refer to the

bottle numbers below. Unknown1= s1 Sets the random concentration or percent weight seed (sn) for unknown Unknown2= s2 concentrations. The actual concentration assigned to each unknown is Unknown3= s3 determined using the first set of equations for solutions and the second for solids: Unknown4= s4 Unknown5= s5

xi = si n+15si

n / 3+ 2.5si

2+ 30.9si

4

3+ si +n

Unknown6= s6 [M] = xi 1000( ) [M]max [M]min( )+ [M]min

Unknown7= s7 Unknown8= s8

yi = n +sin / 4

+ 342.5si2

+ 0.9si3

3+ si +10n

Unknown9= s9 wt% = yi 1000( ) wt%max wt%min( )+wt%min

Unknown10= 10s Unknown11= s11 where si is the seed for unknown i and n is the unknown number. Unknown12= s12 Unknown13= s13 Unknown14= s14 Unknown15= s15 [Bottle 1] Filename= Defines which reagent will be used for bottle 1. Given by INI file name. Conc= Sets the concentration if the reagent is a solution. If it is an unknown,

concentration is calculated using seed above. If it is blank but not an unknown, it uses the default value, defined in the INI file for the reagent.

%Weight= Sets the percentage weight if the reagent is a solid. If it is an unknown, concentration is calculated using seed above. If it is blank but not an unknown, it uses the default value, defined in the INI file for the reagent.

Position=1,2,3, or 4 for a solid Defines the position of the bottle in the lab. [Bottle 2] Filename= Defines which reagent will be used for bottle 2. Given by INI file name. Conc= Sets the concentration if the reagent is a solution. If it is an unknown,

concentration is calculated using seed above. If it is blank but not an unknown, it uses the default value, defined in the INI file for the reagent.

%Weight= Sets the percentage weight if the reagent is a solid. If it is an unknown, concentration is calculated using seed above. If it is blank but not an unknown, it uses the default value, defined in the INI file for the reagent.

Position=1,2,3, or 4 for a solid Defines the position of the bottle in the lab. [Bottle 3] Filename= Defines which reagent will be used for bottle 3. Given by INI file name. Conc= Sets the concentration if the reagent is a solution. If it is an unknown,

concentration is calculated using seed above. If it is blank but not an unknown, it uses the default value, defined in the INI file for the reagent.

%Weight= Sets the percentage weight if the reagent is a solid. If it is an unknown, concentration is calculated using seed above. If it is blank but not an unknown, it uses the default value, defined in the INI file for the reagent.

Position=1,2,3, or 4 for a solid Defines the position of the bottle in the lab.

Page 106: Instructor utilities guide

A-35

[Buret] Bottle=1,2,3 Defines which reagent is in the buret. Numbers correspond to bottles 1, 2, and 3

above. No salts are allowed in buret. Only one bottle is possible. Amount= Sets the volume of above bottle to put in the buret. Use “full” to fill buret. Water_mL= (Default = 0) Sets the volume of water to put in the buret. Window_Open=0,1 (Default = 1) Sets whether the buret window will be open. Zero is closed. Graph_Window_Open=0,1 (Default = 0) Sets whether graph window will be open. Zero is closed. If buret window is

closed, graph window will also be closed. [Stir Plate] Active=0,1 (Default = 1) Sets whether beaker is on the stir plate. Zero means the beaker is not there. Bottle_1=1,2,3 Sets which reagent is in the beaker. Numbers correspond to bottles 1, 2, and 3

above. Amount_1= Sets how much of first bottle is in the beaker. Given in mL or in grams depending

on whether it is a liquid or a solid. Bottle_2= Sets which reagent is in the beaker. Numbers correspond to bottles 1, 2, and 3

above. Bottle 2 can only be a salt. Amount_2= Sets how much of second bottle is in the beaker. Given in mL or in grams

depending on whether it is a liquid or a solid. Water_mL= Sets how much water is in the beaker. On=0,1 (Default = 1) Sets whether the stir plate is on. Zero means the stir plate is off.

Example Titration Preset Experiment [Title] Title=Strong Acid Polybasic Base Unknown

The title of the preset experiment.

[General] ActivityCoefficient=1 Sets the activity coefficients as on. IndicatorUsed=3 Sets the indicator as Thymol blue. [pH Volt Meter] Calibrated=1 Sets the pH meter as calibrated. Window_Open=1 Sets the pH meter window to be open. In_Beaker=1 Sets the pH probe to be in the beaker [Conductivity Meter] In_Beaker=1 Sets the conductivity probe to be in the beaker. Window_Open=1 Sets the conductivity window as open. [Unknowns] Bottle=2 Defines bottle 2 to be the unknown. Unknown1=75 Sets the percent weight seed for unknown concentrations as 75. Unknown2=75 Unknown3=75 Unknown4=75 Unknown5=75 Unknown6=75 Unknown7=75 Unknown8=75 Unknown9=75 Unknown10=75 Unknown11=75 Unknown12=75 Unknown13=75

Page 107: Instructor utilities guide

A-36

Unknown14=75 Unknown15=75 [Bottle 1] Filename=Acid5.ini Defines bottle 1 as Acid5. Conc=.2463 Sets the concentration of the reagent. Position=1 Puts the bottle at position 1. [Bottle 2] Filename=Base6.ini Defines bottle 2 as Base6. %Weight= This is the unknown – no percentage weight is set. Conc= Position=2 Puts the bottle at position 2. [Bottle 3] There are no inert salts in this experiment. [Buret] Bottle=1 Defines bottle 1 as the reagent in the buret. Amount=Full Fills the buret. Water_mL=0 Puts 0 mL water in the buret. Window_Open=1 Sets the buret window as open. Graph_Window_Open=1 Sets the graph window as open. [Stir Plate] Active=1 Sets the beaker on the stir plate. Bottle_1=2 Sets bottle 2 as the reagent in the beaker on the stir plate. Amount_1=1.300 Sets the amount in the beaker as 1.3 g. Bottle_2= There are no salts in this experiment. Amount_2= Water_mL=25 Sets the amount of water in the beaker as 25 mL. On=1 Sets the stir plate as on.

Calorimetry INI Files

The calorimetry laboratory allows students to perform calorimetric experiments involving heats

of combustion, heats of solution, heats of reaction, the heat capacity of metals, plus many others.

Much of the operation of the laboratory and the parameters defining the experiments is

controlled using INI variables located in the files Lab Variables.ini, Metals.ini, Organicn.ini,

Reactionn.ini, and Saltn.ini located in the Reagents directory in the ChemLabC directory. The

variables in LabVariables.ini generally control aspects of the laboratory as a whole, and the

Organic, Reaction, and Salt INI files define the respective bottles in the calorimetry stockroom

where n designates the bottle position on the shelf. The Metals.ini file defines the metals

contained in the metals cabinet in the stockroom. There is one additional set of INI files and

these define the preset experiments located on the stockroom. Described in each of the following

sections are the INI variables contained in each of these INI files. The purpose for providing this

information is to grant instructors the ability to change or adjust the calorimetry simulation to

suit their own needs.

Page 108: Instructor utilities guide

A-37

Lab Variables.ini INI Variables Description

[General] Base_Lab_pressure=760 Every day a new random pressure is calculated that will be the same for each

member in a class. This the initial base pressure for the lab in Torr. Plus_Minus_pressure=15 The min/max spread in pressure. %Humidity=50 The percent humidity in the lab. Labbook_Data_Line_Limit=1000 The maximum number of lines of titration data saved in one link before a new

link is automatically started. Labbook_Plot_Point_Limit=100 The maximum number of points that will be plotted on the graph. Calculation_Update_Interval_sec=1 The time interval used in updating the calculations. Max_Heater_Concentration=4.0 The maximum solution concentration at which the heater burns out. Clock_Accel_Factor=5 The factor at which time increases when the acceleration button is pressed. [Graph Tool] Plot_View_Coords=76,8,355,178 The coordinates for the graph in the plot window. plot_color=55,75,255 The RGB values for the color of the line on the graph. tick_line_color=55,55,55 The RGB values for the color of the tick marks on the graph. Label_Text_Size=9 The font size for the graph labels. t_Range_min=5 The range of the X-axis in minutes. [Balance] Weights_Density=8 The density of the calibration weights. Balance_Flicker_Max=.0001 The maximum amount the balance can flicker above or below the true value. Balance_Flicker_Time=2.5 The amount of time between flicker calculations for the balance display. Weigh_paper_mass=.225 The average mass of the weigh paper. Weigh_paper_mass_%dev=5 The maximum percent deviation for each weigh paper from the average mass. Level1=0.05 The masses of solid added for each scoop size on the side of the bottle. Level2=0.1 Level3=0.2 Level4=0.5 Level5=1.0 Solid_%dev=5 The maximum percent deviation for each scoop size when solid is added onto

the balance. Weigh_paper_amount_1=.01 The mass of solid represented by the graphic for each pile of solid. Weigh_paper_amount_2=.1 Weigh_paper_amount_3=.5 Weigh_paper_amount_4=1 Weigh_paper_amount_5=2 Weigh_paper_amount_6=4 Weigh_paper_amount_7=6 Weigh_paper_amount_8=8 Weigh_paper_amount_9=11 Weigh_paper_amount_10=15 Pipet_Level1=0.00010 The volume of liquid represented by the graphic for each pipet fill-level (L). Pipet_Level2=0.00025 Pipet_Level3=0.00050 Pipet_Level4=0.00075 Pipet_Level5=0.001 Liquid_%dev=5 The maximum percent deviation for each pipet size when liquid is added onto

the balance. [Thermometer] Flicker_Max=.01 The maximum amount the thermometer can flicker above or below the true

Page 109: Instructor utilities guide

A-38

value. Flicker_Time=2.5 The amount of time between flicker calculations for the thermometer display [Glassware] Beaker_mass=100 The average mass of each beaker. Beaker_mass_%dev=5 The maximum percent deviation of each beaker from the average mass. Beaker_vol=.250 The average volume of each beaker. Beaker_vol_%dev=.7 The maximum percent deviation of each beaker from the average volume. Beaker_overflow_vol=.300 The volume at which the beaker overflow animation will be played. Grad_vol4=.010 The average volume of the graduated cylinders. Grad_vol3=.025 Grad_vol2=.050 Grad_vol1=.100 Grad_%dev=.5 The maximum percent deviation from the actual volume for the graduated

cylinders. GlassError=1 Sets whether glassware errors are on or off. [Metals] Metal_Mass_%dev=5 The maximum percent deviation in the mass of the metals. [Dewar] Cup_Vol=.5 The maximum volume of the dewar (L). Cup_Vol_%dev=2 The maximum percent deviation of each the volume of each dewar (set once

for each student). K1=0.095 The cooling constant used in the cooling equations. K1_LO=0.327 The cooling constant used in the cooling equations when the lid is removed. Tao2=1 The heating constant used in heating equations. C_Cal=52 The absolute heat capacity of the dewar (J/K). Resistance=2000 The maximum resistance of the heater in the dewar ( ). Min_Heater_Vol=.02 The minimum voltage allowed for the heater (V). Temp_Sig_Fig=2 The number of decimal places displayed on the thermometer display. [Coffee] Cup_Vol=.513 The maximum volume of the coffee cups (L). Cup_Vol_%dev=1 The maximum percent deviation of each the volume of each coffee cup

calorimeter (set once for each student). K1=0.17 The cooling constant used in the cooling equations. K1_LO=0.52 The cooling constant used in the cooling equations when the lid is removed. Tao2=1 The heating constant used in heating equations. C_Cal=8.5 The absolute heat capacity of the coffee cups (J/K). Resistance=2000 The maximum resistance of the heater in the coffee cups ( ). Min_Heater_Vol=.02 The minimum voltage allowed for the heater (V). Temp_Sig_Fig=2 The number of decimal places displayed on the thermometer display. [Bomb] Cup_Vol=.01 The maximum volume of the bomb sample cup (L). Cup_Vol_%dev=1 The maximum percent deviation of each the volume of each sample cup (set

once for each student). Cup_Mass=12 The mass of the sample cup (g). Cup_Mass_%dev=1 The maximum percent deviation of the sample cup mass. K1=0.1 The cooling constant used in the cooling equations. K1_LO=0.1 The cooling constant used in the cooling equations when the lid open. Tao2=0.1 The heating constant used in heating equations. C_Cal=1949.985 The absolute heat capacity of the bomb calorimeter (J/K). O2_Pressure=30 The starting pressure of Oxygen gas (atm). O2_Pressure_%dev=2 The maximum percent deviation in the starting O2 pressure.

Page 110: Instructor utilities guide

A-39

wire_length=4 The length of ignition wire (cm). Wire_length_%dev=5 The maximum percent deviation in the length of ignition wire. wire_J_cm=10.75 The energy given off by the ignition wire (J/cm). Water_Vol=2000 The volume of water in the bath in the calorimeter (mL). HC_CO2=37.11 The heat capacity of CO2 gas (J/molK). HC_O2=29.36 The heat capacity of O2 gas (J/molK). HC_N2=29.12 The heat capacity of N2 gas (J/molK). Temp_Sig_Fig=3 The number of decimal places displayed on the thermometer display. [Beaker] K1=1.0 The cooling constant of a beaker on the counter (used when ice melts and hot

metals cool). Tao2=0.1 The heating constant of a beaker on the counter. C_Cal=45 The heat capacity of a glass beaker. Ice_Melt_Delay=120 The time delay before ice in a beaker on the counter begins to melt (s). [Reaction Constants] Kr_Organic=0.02 The reaction constant of combusting organics. te_Organic=300 The time for a combustion reaction to give off its heat (s). Kr_Salt=0.08 The reaction constant for dissolving salts with stirring on. te_Salt=60 The time for a dissolving salt to give off its heat with stirring on (s). Kr_Salt_NS=0.045 The reaction constant for dissolving salts with stirring off. te_Salt_NS=120 The time for a dissolving salt to give off its heat with stirring off (s). Kr_Reaction=0.22 The reaction constant for reactions with stirring on. te_Reaction=30 The time for reactions to give off their heat with stirring on (s). Kr_Reaction_NS=0.095 The reaction constant for reactions with stirring off. te_Reaction_NS=60 The time for reactions to give off their heat with stirring off (s). Kr_Metal=0.25 The reaction constant for adding metals with stirring on. te_Metal=20 The time for metals to give off their heat with stirring on (s). Kr_Metal_NS=0.08 The reaction constant for adding metals with stirring off. te_Metal_NS=40 The time for metals to give off their heat with stirring off (s). Kr_Combo=4 The reaction constant for combining liquids with stirring on. te_Combo=10 The time for combining liquids to give off their heat with stirring on (s). Kr_Combo_NS=0.3 The reaction constant for combining liquids with stirring off. te_Combo_NS=20 The time for combining liquids to give off their heat with stirring off (s). [Ice] Mass=25.0 The mass of ice in one scoop (g). Mass_%dev=10 The maximum deviation of mass of ice in one scoop. K_Ice_Stir_On=25 The cooling constant for ice melting with stirring on. K_Ice_Stir_Off=10 The cooling constant for ice melting with stirring off. c_ice=37.466 The heat capacity of ice (J/molK). [Oven] Base_Temp_C=100 The initial temperature of the oven (°C).

Min_Temp_C=25 The minimum temperature of the oven (°C).

Max_Temp_C=200 The maximum temperature of the oven (°C).

[Control Box] Current_Max_mA=500 The maximum current in the heater (mA). [Other flow rates] bottle_flow=30 mL/sec The rate at which liquids flow from the bottle in mL/sec. sink_flow=30 mL/sec The rate at which water is delivered from the sink in mL/sec. flow_delay_sec=0.5 The time in seconds after a bottle is positioned over the buret or a beaker

under the sink or a graduated cylinder over a beaker, etc. before the volume

Page 111: Instructor utilities guide

A-40

starts to be delivered. [Conversion_Factors] atm_to_Pa=101325.0 The conversion factors between different units of pressure. atm_to_bar=1.01325 L_to_cm^3=1e3 The conversion factors between different units of volume. L_to_Gal=.264172052358 cm_to_in=.393700787402 The conversion factors between different units of length.

Metals.ini INI Variables Description [General] [1 A1] Position of the metal in the Drawers [Drawer ColumnRow] Name=Silver The long name that pops up when metal is moused over. Short_name=Ag Name that appears on the label in the drawer. Color=silver Color of the metal (silver, gold, copper, dull) Unknown=yes If the metal can be assigned as an unknown. Mass=27.96 The average mass of the metal. Melting_Point_C=961.78 The melting point of the metal. Heat_Capacity=0.235 The heat capacity of the metal (J/gK). MW=107.868 The molecular weight of the metal. Density=9.32 The density of the metal. BlowUp=No If the metal is explosively reactive with water (Yes or No). [1 A2] Name=Aluminum Short_name=Al Color=silver Unknown=yes Mass=7.125 Melting_Point_C=660.32 Heat_Capacity=0.897 MW=26.982 Density=2.375 BlowUp=No [1 A3] Name=Gold Short_name=Au Color=gold Unknown=yes Mass=51.93 Melting_Point_C=1064 Heat_Capacity=0.129 MW=196.97 Density=17.31 BlowUp=no [1 A4] Name=Beryllium

Page 112: Instructor utilities guide

A-41

Short_name=Be Color=dull Unknown=yes Mass=5.07 Melting_Point_C=1287 Heat_Capacity=1.825 MW=9.012 Density=1.69 BlowUp=no

Organicn.ini INI Variables Description [General] Name=Benzoic acid The long name that pops up when bottle is moused over. Short_name=C7H6O2 The name that appears on the bottle. Phase=solid The phase of the Organic compound (solid or liquid). Color=white The color of the compound. Unknown=yes If the compound may be assigned as an unknown (yes or no). [Physical Data] dHo=3226.9E3 The standard state heat of combustion of the compound (J/mol). MW=122.13 The molecular weight of the compound. Density=1.2659 The density of the compound. Packing_Density_Solid=2.5318 The density used to calculate how much volume the scooped solid takes up. a=7 The number of carbons in the molecule. b=6 The number of hydrogens. c=2 The number of oxygens. d=0 The number of nitrogens.

Reactionn.ini INI Variables Description [General1] 1 contains the information for bottle 1 of the pair (the left one). Name=Hydrochloric Acid The long name that pops up when bottle is moused over. Short_name=HCl The name that appears on the bottle. Phase=aqueous The phase of the compound (solid or aqueous). Color=clear The color of the compound. Unknown=yes If the compound may be assigned as an unknown (yes or no). [General2] 2 contains the information for bottle 2 of the pair (the right one). Name=Sodium Hydroxide Short_name=NaOH Phase=aqueous Color=clear Unknown=yes [Solids1] If the phase for the bottle is solid: MW= The molecular weight of the solid. Density= The density of the solid. dHs= The heat of solution of the solid. Max_Conc= The maximum concentration the solid may dissolve in solution. %Weight= This is not used for the Calorimetry lab.

Page 113: Instructor utilities guide

A-42

%Weight_Min= This is not used for the Calorimetry lab. %Weight_Max= This is not used for the Calorimetry lab. %Wt_Init_Min= This is not used for the Calorimetry lab. %Wt_Init_Max= This is not used for the Calorimetry lab. Impurity= This is not used for the Calorimetry lab. [Aqueous Solutions1] If the phase of the bottle is aqueous: Conc=1.0000 The concentration of the solution. Conc_Min=0.010 This is not used for the Calorimetry lab. Conc_Max=4.0000 This is not used for the Calorimetry lab. Conc_Init_Min=0.1000 This is not used for the Calorimetry lab. Conc_Init_Max=0.1200 This is not used for the Calorimetry lab. [Solids2] MW= Density= dHs= Max_Conc= %Weight= %Weight_Min= %Weight_Max= %Wt_Init_Min= %Wt_Init_Max= Impurity= [Aqueous Solutions2] Conc=1.0000 Conc_Min=0.010 Conc_Max=4.0000 Conc_Init_Min=0.1000 Conc_Init_Max=0.1200 [Reaction] dHr=5.58e4 The standard state heat of reaction per mole of the limiting reactant. [Reactants] R1=HCl The reactant in bottle 1 M_R1=1 The stoichiometric coefficient of this reactant in the reaction. Ph_R1=aqueous The phase of R1 in solution R1_cat=H,1+ The cation if R1 dissociates. M_R1_cat=1 The stoichiometric coefficient for the cation. Z_R1_cat=1 The charge of this cation. MW_R1_Cat=1.008 The molecular weight of this cation. R1_ani=Cl,1- The anion if R1 dissociates. M_R1_ani=1 The stoichiometric coefficient for the anion. Z_R1_ani=-1 The charge of this anion. MW_R1_Ani=35.453 The molecular weight of this anion. R2=NaOH The reactant in bottle 2 M_R2=1 The stoichiometric coefficient of this reactant in the reaction. Ph_R2=aqueous The phase of R2 in solution R2_cat=Na,1+ The cation if R2 dissociates. M_R2_cat=1 The stoichiometric coefficient for the cation. Z_R2_cat=1 The charge of this cation. MW_R2_cat=22.990 The molecular weight of this cation. R2_ani=OH,1- The anion if R2 dissociates.

Page 114: Instructor utilities guide

A-43

M_R2_ani=1 The stoichiometric coefficient for the anion. Z_R2_ani=-1 The charge of this anion. MW_R2_ani=17.007 The molecular weight of this anion. R3= Another possible reactant in bottle 1. M_R3= Ph_R3= R3_cat= M_R3_cat= Z_R3_cat= MW_R3_cat= R3_ani= M_R3_ani= Z_R3_ani= MW_R3_ani= R4= Another possible reactant in bottle 2. M_R4= Ph_R4= R4_cat= M_R4_cat= Z_R4_cat= MW_R4_cat= R4_ani= M_R4_ani= Z_R4_ani= MW_R4_ani= [Products] P1=H2O The first product of the reaction. M_P1=1 The stoichiometric coefficient of this product in the reaction. Ph_P1=liquid The phase of P1 in solution P1_cat= The cation if P1 dissociates. M_P1_cat= The stoichiometric coefficient for the cation. Z_P1_cat= The charge of this cation. MW_P1_cat= The molecular weight of this cation. P1_ani= The anion if P1 dissociates. M_P1_ani= The stoichiometric coefficient for the anion. Z_P1_ani= The charge of this anion. MW_P1_ani= The molecular weight of this anion. P2=NaCl The second product of the reaction. M_P2=1 Ph_P2=aqueous P2_cat=Na,1+ M_P2_cat=1 Z_P2_cat=1 MW_P2_cat=22.990 P2_ani=Cl,1- M_P2_ani=1 Z_P2_ani=-1 MW_P2_ani=35.453 P3= A third product of the reaction. M_P3= Ph_P3=

Page 115: Instructor utilities guide

A-44

P3_cat= M_P3_cat= Z_P3_cat= MW_P3_cat= P3_ani= M_P3_ani= Z_P3_ani= MW_P3_ani= P4= M_P4= Ph_P4= P4_cat= M_P4_cat= Z_P4_cat= MW_P4_cat= P4_ani= M_P4_ani= Z_P4_ani= MW_P4_ani= [Partial Molal Volume] R1density= The density of R1 if it does not dissolve in solution. R1_catV=0 The partial molal volume of the cation of R1 if it dissolves in solution. R1_aniV=17.83 The partial molal volume of the anion of R1 if it dissolves in solution. R2density= R2_catV=-1.21 R2_aniV=-4.04 R3density= R3_catV= R3_aniV= R4density= R4_catV= R4_aniV= P1density= P1_catV= P1_aniV= P2density= P2_catV=-1.21 P2_aniV=17.83 P3density= P3_catV= P3_aniV= P4density= P4_catV= P4_aniV= [Heat Capacity] R1_HC= The heat capacity of R1 if it does not dissolve in solution. R1_catHC=0 The partial molar heat capacity of the cation of R1 if it dissolves in solution. R1_aniHC=-124.7 The partial molar heat capacity of the anion of R1 if it dissolves in solution. R2_HC= R2_catHC=38.60 R2_aniHC=-141.5 R3_HC= R3_catHC=

Page 116: Instructor utilities guide

A-45

R3_aniHC= R4_HC= R4_catHC= R4_aniHC= P1_HC= P1_catHC= P1_aniHC= P2_HC= P2_catHC=38.60 P2_aniHC=-124.7 P3_HC= P3_catHC= P3_aniHC= P4_HC= P4_catHC= P4_aniHC= [Molecular Weight] R1_MW=36.461 The molecular weight of R1. R2_MW=39.997 R3_MW= R4_MW= P1_MW=18.015 P2_MW=58.443 P3_MW= P4_MW=

Saltn.ini INI Variables Description [General] Name=Sodium Flouride The long name that pops up when bottle is moused over. Short_name=NaF The name that appears on the bottle. Phase=solid The phase of the salt (always solid for salts). Color=white The color of the salt. Unknown=yes If the compound may be assigned as an unknown (yes or no). [Physical Data] dH=-0.91e3 The standard state heat of solution of the salt (J/molK) MW=41.988 The molecular weight of the salt. Density=2.78 The density of the salt. Max_Conc=6.1 The maximum concentration that the salt may dissolve to. [Species] Cat=Na,1+ The cation of the dissolved salt. M_Cat=1 The stoichiometric coefficient of the cation. Z_Cat=1 The charge of the cation. Ani=F,-1 The anion of the dissolved salt. M_Ani=1 The stoichiometric coefficient of the anion. Z_Ani=-1 The charge of the anion. [Molar Heat Capacity] HC=46.9 The heat capacity of the solid salt. HC_Cat=46.4 The partial molar heat capacity of the cation.

Page 117: Instructor utilities guide

A-46

HC_Ani=-106.7 The partial molar heat capacity of the anion. [Partial Molal Volume] V_Cat=-1.21 The partial molal volume of the cation. V_Ani=-1.6 The partial molal volume of the anion. [Molecular Weight] MW_cat=22.990 The molecular weight of the cation. MW_ani=18.998 The molecular weight of the anion.

Preset Experiments Located on the clipboard in the calorimetry stockroom is a set of 15 preset experiments listed by

title. If allowed by the instructor, students can select one of these experiments and, upon

returning to the laboratory, the selected experiment will be automatically set up and running.

Preset experiments are intended to provide flexibility for the instructor so the calorimetry

simulation can be adapted to the level of the class or the individual teaching style of the

instructor. Several experiments have already been defined and are installed with the software.

This section describes how these files can be modified.

Each preset experiment is defined using an INI file. For the preset experiments on the clipboard,

these files have the name Experimentn.ini, where n is a number between 1 and 15 and represents

experiments 1 through 15 on the clipboard. These files are located in the Presets directory in the

ChemLabC directory. Note that in client installations, any modified preset experiments for the

clipboard must be modified for each client installation.

Given subsequently is a description of a preset experiment INI file and the variables that are used

to define an experiment. Before reviewing the INI file information, here are some important

points to keep in mind: (a) All of the variables described have default values, so variables may be

left blank or not used at all. An experiment can be set up or defined to any degree desired by the

instructor. (b) Some variables are mutually exclusive; that is, the use of one variable may mean

another variable cannot be used. Some error checking exists for such situations, but the error

checking is not comprehensive.

The following two tables show the INI variables used in preset experiments. The first lists all the

variables that can be used and their allowed values. Default values are given in red. The second

is an example of a preset experiment for a heat of reaction experiment to show how the variables

can be used. Provided below the tables is a small graphic showing the position labels used for the

various INI position variables.

Complete Calorimetry Preset Experiment INI Variable List

INI Variables Description [Title]

Title=Freezing Point Depression The title of the preset experiment.

[General]

Timer=On,Off (Default = Off) Sets the timer (the timer window) to be open or closed.

[Calorimeter] These are variables for the calorimeters in general.

Page 118: Instructor utilities guide

A-47

Lid=On,Off (Default = Off) Specifies if the lid to the calorimeter is on or off. Calorimeter=Bomb,Coffee,Dewar,None (Default = None)

Specifies which calorimeter is selected.

Position=Counter,Table (Default = Table) Specifies the position of the calorimeter in the laboratory. Position labels are case sensitive.

Temperature_K=298.15 (Default = 298.15) Sets the initial temperature of any water that may be in the calorimeter. Position must be set to Table.

Graph_Window=On,Off (Default = Off) Sets the graph window to open or closed.

###Coffee/Dewar Variables### These variables are only for the coffee cup or dewar. Thermometer=On,Off (Default = Off) Sets the thermometer to be on or off. Bottle=Bottle,Bottle 2 (Or Blank) Specifies which solution or solid from the available bottles that will be in the

calorimeter. Bottle_Amount=Random,Volume,Mass Specifies the volume or mass from the bottle. Volume should be a number in

mL for liquids; Mass is a number in grams for solids. Bottle_Min= Specifies minimum amount (mL or g) for Random amounts. Bottle_Max= Specifies maximum amount (mL or g) for Random amounts. Metal=Yes,No (Default = No) Specifies if a metal is already in the calorimeter. If yes, then position in Metals

section below specifies position of dish. Ice=Random,Mass (Default = 0.0) Specifies the mass of ice that will be in the calorimeter. Ice_Min= Specifies the minimum mass of ice for Random amounts. Ice_Max= Specifies the maximum mass of ice for Random amounts. Water=Random,Volume (Default = 0.0) Specifies the volume of water that will be in the calorimeter. Water_Min= Specifies the minimum volume of water for Random amounts. Water_Max= Specifies the maximum volume of water for Random amounts. Current= (Default = 0) Sets the initial current setting for the electrical heater. Stirring=On,Off (Default = Off) Sets stirring on or off. Heater=On,Off (Default = Off) Sets the electrical heater on or off. If the lid is off, then the heater is set off.

###Bomb Variables### These variables are only for the bomb calorimeter. Thermometer=On,Off (Default = Off) Sets the thermometer to be on or off. This is the bomb control panel. Bomb=In,Out (Default = Out) Specifies if the bomb is in or out of the calorimeter. Screw_Cap=On,Off (Default = Off) Sets the screw cap to be on or off of the bomb. bomb_Head=On,Off (Default = Off) Puts the bomb head in or out of the bomb. Cup=In,Out (Default = In) Puts the bomb cup in or out of the bomb head. Cup_Position=TableE,TableF (Default =TableE)

If the bomb cup is out, places the cup on the indicated table position.

Bottle=Bottle (Or Blank) Specifies that the liquid or solid from the selected bottle is in the bomb cup. Bottle_Amount=Random,Volume,Mass Specifies the volume or mass from the bottle. Volume should be a number in

mL for liquids; Mass is a number in grams for solids. Bottle_Min= Specifies minimum amount (mL or g) for Random amounts. Bottle_Max= Specifies maximum amount (mL or g) for Random amounts.

[Bottle] These variables define what chemical is represented by Bottle or Bottle 2. Filename=Salt1.ini The name of the organic, salt, or reaction INI file. Position=CounterA,CounterB,CounterC,TableA,TableB,TableC,TableG (Default =TableG for organics & solids,

TableA for aqueous reactants)

Position for the bottle in the laboratory.

Bottle2_Position=CounterA,CounterB,CounterC,TableA,TableB,TableC,TableG (Default =TableG for solids, TableA for

aqueous reactants.)

Position for the second bottle for reaction experiments.

Unknown=Yes,No (Default = No) Specifies if the bottle should be labeled as an unknown.

[Metal]

Page 119: Instructor utilities guide

A-48

Metal=1 A1 Specifies the metal by specifying the metal location. [Drawer ColumnRow] Position=CounterA,CounterB,CounterC,TableD,TableE,TableF,Oven (Default = TableD)

Position of the metal and dish in the laboratory.

[Oven] Not used if bomb experiment is out. On_Off=On,Off (Default = Off) Turns oven on and off. Open_Closed=Open,Closed (Default = Closed)

Sets the oven door as open or closed.

Temperature= (Default = min temp limit) Sets the temperature of the oven in C.

[Balance]

On_Off=On,Off (Default = On) Sets the balance to be on or off. Tare_container=Yes,No (Default = No) Specifies if the weigh paper or beaker mass will be subtracted from balance

reading.

[Beaker1] Not used if bomb experiment is out. Position=TableA,TableB,TableC,TableD,TableE,TableF

Position of the beaker on the table. The default position starts with the first available position.

Bottle=Bottle,Bottle 2 Assigns what is in the beaker. This must be specified. Amount=Random,Volume,Mass Specifies the volume or mass in the beaker. Volume should be a number in

mL for liquids; Mass is a number in grams for solids. Min= Specifies minimum amount (mL or g) for Random amounts. Max= Specifies maximum amount (mL or g) for Random amounts. [Beaker2] Not used if bomb experiment is out. Used only for reaction experiments. Position=TableA,TableB,TableC,TableD,TableE,TableF

Position of the beaker on the table. The default position starts with the first available position.

Bottle=Bottle,Bottle 2 Assigns what is in the beaker. This must be specified. Amount=Random,Volume,Mass Specifies the volume or mass in the beaker. Volume should be a number in

mL for liquids; Mass is a number in grams for solids. Min= Specifies minimum amount (mL or g) for Random amounts. Max= Specifies maximum amount (mL or g) for Random amounts.

[Paper] Position=Paper,TableF,None (Default=None)

Position of the weigh paper in the laboratory.

Bottle=Bottle,Bottle 2 What is on the paper. This must be assigned to a solid. Amount=Random,Mass Specifies the mass on the paper in grams. If a metal has been selected, then

this is ignored. Min= Specifies minimum amount for Random amounts. Max= Specifies maximum amount for Random amounts.

Example Calorimetry Preset Experiment INI Variables Description [Title]

Title=Heat of Reaction: HCl (aq) + NaOH (s)

Title of experiment.

[General]

Timer=Off Stopwatch window is not open.

[Calorimeter]

Calorimeter=Dewar Selected the dewar as the calorimeter. Thermometer=On Thermometer is on and thermometer window is open. Temperature_K=298.15 Temperature of anything inside calorimeter is set to 25 C.

Page 120: Instructor utilities guide

A-49

Graph_Window=On Graph window is open. Lid=On The lid to the calorimeter is on. Stirring=On Stirring is turned on. Position=Table The calorimeter is placed on the table. Water=.100 There is 100 mL of water in the calorimeter.

[Bottle]

Filename=Reaction2.ini Reaction postion 2 is used for reactants. Position=CounterA Position of bottle 1 is on the counter. Bottle2_Position=TableG Position of bottle 2 is on the Table in position G.

[Beaker1]

Position=TableB A beaker is placed on the table in location B. Bottle=Bottle The beaker is filled with bottle 1. Amount=0.100 The amount is 100 mL.

[Balance]

On_Off=On The balance is turned on. Tare_container=Yes The weigh paper is tared.

[Paper]

Position=TableF The weigh paper is on the balance. Bottle=Bottle 2 The solid from bottle 2 is on the weigh paper. Amount=Random A random amount is selected. Amount_Min=3.999 The minimum value. Amount_Max=4.000 The maximum value.

Figure A1. Position labels for calorimetry INI variables.

Page 121: Instructor utilities guide

A-50

Mechanics INI File

The mechanics laboratory allows students the ability to perform realistic mechanical experiments

in a controlled environment of their pleasing. Much of the experiments are controlled using the

laboratory INI file however, there are presets that will be determined by their own preset INI

files. These presets INI are described below. The variables contained in the laboratory INI file

are explained below. Note that each variable has its own default and max/min values. The

purpose for providing this information is to grant instructors the ability to change or adjust the

mechanics simulation to suit their own needs.

Mechanics.ini INI Variables Description

[General] DisplaySigFig=3 The significant digits that will be displayed in the work area display boxes. AccelerationValues=0.01, 0.05, 0.1, 0.5, 1, 5, 10, 50, 100, 500

The acceleration factor which time will be multiplied by to increase the speed of the experiment. The time acceleration display will rotate through in this order.

AccelerationDefault=1 The starting value for lab time acceleration. Must correspond with one of the defined acceleration values.

LabbookSigFig=4 The number of significant digits to be stored in the labbook. PlanetAccelerationValues=pa1d, pa10d, pa30d, pa100d, pa1y, pa10y, pa100y

The time acceleration values used in planetary simulations. d = day, y = year.

pa1d_Label=1 Day The label that will be displayed for 1 Day increments. pa1d_sec=84600 The number of seconds per chosen acceleration value. pa10d_Label=10 Days The label that will be displayed for 10 Day increments. pa10d_sec=846000 The number of seconds per chosen acceleration value. pa30d_Label=30 Days The label that will be displayed for 30 Day increments. pa30d_sec=2592000 The number of seconds per chosen acceleration value. pa100d_Label=100 Days The label that will be displayed for 100 Day increments. pa100d_sec=8460000 The number of seconds per chosen acceleration value. pa1y_Label=1 Year The label that will be displayed for 1 Year increments. pa1y_sec=31557600 The number of seconds per chosen acceleration value. pa10y_Label=10 Years The label that will be displayed for 10 Year increments. pa10y_sec=315576000 The number of seconds per chosen acceleration value. pa100y_Label=100 Years The label that will be displayed for 100 Year increments. pa100y_sec=3155760000 The number of seconds per chosen acceleration value. Planet_Auto_Increment_Time=5 The number of seconds that pass between auto time increment. [Grid] Red=100 Color of grid lines. Green=100 Color of grid lines. Blue=100 Color of grid lines. Transparency=50 The transparency of the grid lines on the screen. Label_Red=25 Grid label colors. Label_Green=25 Grid label colors.

Page 122: Instructor utilities guide

A-51

Label_Blue=25 Grid label colors. Label_Transparency=50 Transparency label colors. P_Red=200 Planet grid line color. P_Green=100 Planet grid line color. P_Blue=100 Planet grid line color. P_Transparency=15 Planet grid lines transparency. P_Label_Red=200 Label for planet grid line colors. P_Label_Green=100 Label for planet grid line colors. P_Label_Blue=100 Label for planet grid line colors. P_Label_Transparency=100 Planet transparency grid label color. Startx1=-10 The initial coordinates for the grid (Y-axis calculated from the x-axis). Startx2=10 The initial coordinates for the grid (Y-axis calculated from the x-axis). AutoScaleFactor=4 The multiplication factor for auto scaling the grid size. [Materials] materials=wood,plastic,metal,cement,rubber The materials available in the lab. wood_label=Wood The label shown for this material. plastic_label=Plastic The label shown for this material. metal_label=Metal The label shown for this material. rubber_label=Rubber The label shown for this material. [Ball] m=10 The mass of the ball. m_min=0.0001 The minimum mass of the ball. m_max=1000000 The maximum mass of the ball. r=0.5 The radius of the ball. r_min=0.001 The minimum radius of the ball. r_max=100 The maximum radius of the ball. v0=0.0 The initial velocity of the ball. Beta=0.0 The initial angle of velocity. A 0 radian angle is with respect to the positive x-

axis, moving counterclockwise through the quadrants from 0-2Pi radians. material=metal The default material for the ball. sphere=solid The type of sphere the ball is. It can either be a solid sphere or a shell, with all

the mass distribution on the shell. The options are either solid or thin. min_pixel_r=8 The minimum pixel radius the ball can be when at the minimum radius. AllowsideAV=1 The angular velocity graphic is on or off. This shows the ball rotating when the

ball is moving on the ramp, but not in the point of perfect rolling without slipping yet. 1=on, 2=off.

[MultipleBalls] mn=10 The mass of each ball in the multiple ball simulation. mn_min=0.001 The minimum mass of each ball. mn_max=1000000 The maximum mass of each ball. rn=0.5 The radius of each ball. rn_min=0.001 The minimum radius of each ball. rn_mx=1000 The maximum radius of each ball. [Forces] Fi=1000000 The default force if not specified in the individual experiment sections. Fi_min=0 The minimum magnitude of force (newtons). Fi_max=1000000 The maximum magnitude of force (newtons). Fi_rocket=100 The magnitude of the rocket force. Fi_plunger=3000 The magnitude of the plunger force. phi=0 The angle of applied force. A 0 radian angle is with respect to the positive x-

axis, moving counterclockwise through the quadrants from 0-2Pi radians.

Page 123: Instructor utilities guide

A-52

phi_min=0 The minimum angle of applied force. phi_max=6.28318531 The maximum angle of applied force. rocketTime=1 The number of seconds the rocket force is applied per click, or fire. plungerTime=0.05 The number of seconds the plunger force is applied. [Frictions] wood_wood=0.55 The coefficient of friction between the two materials. wood_plastic=0.33 The coefficient of friction between the two materials. wood_cement=0.62 The coefficient of friction between the two materials. wood_rubber=0.96 The coefficient of friction between the two materials. plastic_wood=0.33 The coefficient of friction between the two materials. plastic_plastic=0.15 The coefficient of friction between the two materials. plastic_metal=0.45 The coefficient of friction between the two materials. plastic_cement=0.25 The coefficient of friction between the two materials. plastic_rubber=0.85 The coefficient of friction between the two materials. metal_wood=0.38 The coefficient of friction between the two materials. metal_plastic=0.45 The coefficient of friction between the two materials. metal_metal=0.52 The coefficient of friction between the two materials. metal_cement=0.30 The coefficient of friction between the two materials. metal_rubber=0.90 The coefficient of friction between the two materials. cement_wood=0.62 The coefficient of friction between the two materials. cement_plastic=0.25 The coefficient of friction between the two materials. cement_metal=0.30 The coefficient of friction between the two materials. cement_cement=0.55 The coefficient of friction between the two materials. cement_rubber=0.89 The coefficient of friction between the two materials. rubber_wood=0.96 The coefficient of friction between the two materials. rubber_plastic=0.85 The coefficient of friction between the two materials. rubber_metal=0.90 The coefficient of friction between the two materials. rubber_cement=0.89 The coefficient of friction between the two materials. rubber_rubber=1.00 The coefficient of friction between the two materials. P=101325 The default pressure (Pa) at sea level. P_min=0 The minimum pressure allowed (Pa). This pressure would correspond to an

altitude of below sea level, but we just leave the altitude at 0 for all low pressures.

P_max=10132500 The maximum pressure allowed. Z=0 The altitude of the experiment (m) above sea level. Z_min=0 The minimum altitude of the experiments (m). Z_mx=44642 The maximum altitude of the experiments. [Gravity] gx=9.80665 The magnitude of gravity in the direction of the (+) x-axis (m/s^2). gx_min=-300 The minimum magnitude of x axis gravity. gx_max=300 The maximum magnitude of x axis gravity. gy=9.80665 The magnitude of gravity in the direction of the (-) y-axis. gy_min=-300 The minimum magnitude of y axis gravity. gy_max=300 The maximum magnitude of y axis gravity. gr=9.80665 The magnitude of gravity in the radial direction. gr_min=-300 The minimum magnitude of radial gravity. gr_max=300 The maximum magnitude of radial gravity. g_multiplier=0.101971621298 The multiplier to set the number of g’s per chosen gravity value. planetList=Sun,Mercury,Venus,Earth,Mars, The list of names to show in the parameters palette for gravities.

Page 124: Instructor utilities guide

A-53

Jupiter,Saturn,Uranus,Neptune,Pluto gravityList= 274.13,3.59,8.87,9.80665,1.62, 3.77,25.95,11.08,10.67,14.07,0.42

The list of corresponding gravities to the planetList. Must be in same order as the planetList.

[Ramp] theta=0.78539816339745 The default angle of the ramp (radians). theta_min=0 The minimum angle of the ramp. theta_mx=1.57079633 The maximum angle of the ramp. L=50 The length of the ramp (m). L_min=1 The minimum length of the ramp. L_max=10000 The maximum length of the ramp. Material=wood The material of the ramp. Choices in material section above. YAxisPlacement=1.3 The angle (radians) above which the object placement is controlled by the y

location of the mouse. [Rod] theta=0.005 The starting angle of the rod from the positive y axis (radians). theta_min=0 The minimum angle of the rod. theta_mx=1.57079633 The maximum angle of the rod. r=1.5 The radius of the rod (m). r_min=0.1 The minimum radius of the rod. r_max=1000 The maximum radius of the rod. l=20 The length of the rod. l_min=1 The minimum length of the rod. l_max=100000 The maximum length of the rod. material=brickmortar The initial material of the rod. Options below. materials=wood, cement, glass, titanium, aluminum, castiron, brickmortar

The options for material of the rod.

wood_label=Wood The label for the wood material. wood_tensile=35200000 The tensile strength for wood material (Pa). wood_density=518 The density of the wood material (kg/m^3). cement_label= Cement The label for the material. cement _tensile=3500000 The tensile strength for material. cement _density=2320 The density of the material. glass_label= Glass The label for the material. glass _tensile=3600000000 The tensile strength for material. glass _density=2530 The density of the material. titanium_label= Titanium The label for the material. titanium _tensile=830000000 The tensile strength for material. titanium_density=4510 The density of the material. aluminum_label= Aluminum The label for the material. aluminum _tensile=180000000 The tensile strength for material. aluminum _density=2700 The density of the material. castiron_label= Cast Iron The label for the material. castrion _tensile=200000000 The tensile strength for material. castiron _density=6800 The density of the material. Brickmortar_label= Brick and Mortar The label for the material. Brickmortar _tensile=689000 The tensile strength for material. Brickmortar _density=1840 The density of the material.

Page 125: Instructor utilities guide

A-54

[Sled] m=10 The mass of the sled (kg). m_min=0.001 The minimum mass of the sled. m_max=1000000 The maximum mass of the sled. Ls=2 The length of the sled (m). Ls_min=0.1 The minimum length of the sled. Ls_max=100 The maximum length of the sled. h=1 The height of the sled (m). h_min=0.1 The minimum height of the sled. h_max=100 The maximum height of the sled. w=0.5 The width of the sled (m). w_min=0.1 The minimum width of the sled. w_max=100 The maximum width of the sled. v0=0.0 The initial velocity of the sled (m/s). Beta=0.0 The initial angle of velocity (rad). material=metal The material of the sled. min_pixel_h=8 The minimum pixel height the sled can be. [UnitTime] s=1 The base unit is in seconds. min=60 The number of seconds in a minute. hr=3600 The number of seconds in an hour. day=86400 The number of seconds in a day. yr=31557600 The number of seconds in a year. [UnitTimeLabel] s=s The label shown for seconds is “s”. min=min The label shown for minute is “min”. hr=hr The label for hour. day=day The label for day. yr=yr The label for year. [UnitPosition] m=1 The base unit is in meters. cm=100 The number of centimeters in a meter. km=0.001 The number of kilometers in a meter. in=39.37007 The number of inches in a meter. ft=3.28083 The number of feet in a meter. yd=1.09361 The number of yards in a meter. mi=0.0006213711 The number of miles in a meter. AU=0.0000000000066845871226706 The number of astronomical units in a meter. Lyr=0.00000000000000010570008340 The number of light-years in a meter. [UnitPositionLabel] m=m The label for meters. cm=cm The label for centimeters. km=km The label for kilometers. in=in The label for inches. ft=ft The label for feet. yd=yd The label for yards. mi=mi The label for miles. AU=AU The label for astronomical units. Lyr=Lyr The label for light-years. [UnitMass] kg=1 The base unit is in kilograms

Page 126: Instructor utilities guide

A-55

g=1000 The number of grams in a kilogram. Mg=.001 The number of megagrams in a kilogram. oz=35.274 The number of ounces in a kilogram. lbs=2.20462262 The number of pounds in a kilogram. T=.001102 The number of tons in a kilogram. slg=.068522 The number of slugs in a kilogram. [UnitMassLabel] kg=kg The label for kilogram. g=g The label for grams. Mg=Mg The label for megagrams. oz=oz The label for ounces. lbs=lbs The label for pounds. T=Tons The label for tons. slg=slugs The label for slugs. [UnitForce] N=1 The base unit is in newtons. dyn=100000 The number of dynes in a newton. PF=.22480 The number of pounds-force in a newton. TF=.0001124 The number of tons-force in a newton. [UnitForceLabel] N=N The label for newtons. dyn=dyn The label for dynes. PF=lbs-F The label for pounds-force. TF=Tons-F The label for tons-force. [UnitVelocity] m_s=1 The base unit is meters per second. Km_s=.001 The number of kilometers per second in a meter per second. Km_hr=3.60 The number of kilometers per hour in a meter per second. ft_s=3.28083 The number of feet per second in a meter per second. mi_s=.0006214 The number of miles per second in a meter per second. mi_hr=2.2369363 The number of miles per hour in a meter per second. AU_yr=4743.739 The number of astronomical units per year in a meter per second. [UnitVelocityLabel] m_s=m/s The label for meter per second. Km_s=km/s The label for kilometer per second. Km_hr=km/hr The label for kilometer per hour. ft_s=ft/s The label for feet per second. mi_s=mi/s The label for miles per second. mi_hr=mi/hr The label for miles per hour. AU_yr=AU/yr The label for astronomical units per year. [UnitAirPressure] atm=0.00000986923169314269 The number of atmosphere per pascal. Pa=1 The base unit is pascals. [UnitAirPressureLabel] atm=atm The label for atmospheres. Pa=Pa The label for pascals. [UnitTemperatureLabel] C=C The label for Celsius.

Page 127: Instructor utilities guide

A-56

F=F The label for Fahrenheit. K=K The label for Kelvin. [UnitAngles] R=1 The base unit is radians. D=57.297 The number of degrees in a radian. [UnitAnglesLabel] R=rad The label for radians. D=Degrees The label for degrees. [ProjectileMotionBallExperiment] X0=0 The initial x coordinate of the object. X0_min=-1000000 The minimum x coordinate allowed. X0_max=1000000 The maximum x coordinate allowed. Y0=0 The initial y coordinate of the object. Y0_min=-1000000 The minimum y coordinate allowed. Y0_max=1000000 The maximum y coordinate allowed. V0=0.0 The initial velocity of the object (m/s). V0_min=0 The minimum velocity of the object. V0_max=300000000 The maximum velocity of the object. Beta=0.78539816 The initial angle of velocity of the object (rad). Counter-clockwise from + x axis. Beta_min=0 The minimum angle for velocity. Beta_max=6.28318531 The maximum angle for velocity. Fi=0 The initial force applied to object. Fi_min=0 The minimum force allowed. Fi_max=1000 The maximum force allowed. phi=0.0 The angle of applied force (rad). Counter-clockwise from + x axis. phi_min=0 The minimum angle of applied force. phi_max=6.28318531 The maximum angle of applied force. P=101325 The initial pressure of air (Pa). P_min=0 The minimum pressure of air. P_max=10132500 The maximum pressure of air. Z=0 The initial altitude of experiment (m). Z_min=0 The minimum altitude. Z_max=44642 The maximum altitude. gx=9.80665 The gravitational acceleration along the x axis (m/s^2). gx_min=0 The minimum gravitational acceleration. gx_max=300 The maximum gravitational acceleration. gy=9.80665 The gravitational acceleration along the y axis (m/s^2). gy_min=0 The minimum gravitational acceleration. gy_max=300 The maximum gravitational acceleration. gr=9.80665 The gravitational acceleration radially towards the center of the screen, the

origin (m/s^2). gr_min=0 The minimum gravitational acceleration. gr_max=300 The maximum gravitational acceleration.

Page 128: Instructor utilities guide

A-57

[RampMotionExperiment] X0=0 The initial x coordinate of the object. X0_min=-1000000 The minimum x coordinate allowed. X0_max=1000000 The maximum x coordinate allowed. Y0=0 The initial y coordinate of the object. Y0_min=-1000000 The minimum y coordinate allowed. Y0_max=1000000 The maximum y coordinate allowed. V0=0 The initial velocity of the object along the ramp (m/s^2). V0_min=-300000000 The minimum velocity of the object. V0_max=300000000 The maximum velocity of the object. theta=0.0 The default angle of the ramp (rad). theta_min=0 The minimum angle of the ramp. theta_max=6.28318531 The maximum angle of the ramp. Fi=0 The force applied to the object (N). Fi_min=0 The minimum force allowed. Fi_max=1000 The maximum force allowed. P=101325 The default pressure of air (Pa). P_min=0 The minimum pressure allowed. P_max=10132500 The maximum pressure allowed. Z=0 The default altitude-sea level (m). Z_min=0 The minimum altitude allowed. Z_max=44642 The maximum altitude allowed. gx=9.80665 The gravitational acceleration along the x axis (m/s^2). gx_min=0 The minimum gravitational acceleration. gx_max=300 The maximum gravitational acceleration. gy=9.80665 The gravitational acceleration along the y axis (m/s^2). gy_min=0 The minimum gravitational acceleration. gy_max=300 The maximum gravitational acceleration. gr=9.80665 The gravitational acceleration radially towards the center (m/s^2). gr_min=0 The minimum gravitational acceleration. gr_max=300 The maximum gravitational acceleration. d=1 The distance below the surface of the ramp the radial sink is located-projected

perpendicular to the ramp surface (m) d_min=0 The minimum distance radial sink is located. d_max=10 The maximum distance the radial sink is located. uk=0.38 The default coefficient of friction. uk_min=0 The minimum coefficient of friction. uk_max=1 The maximum coefficient of friction. phi=0 The angle the ball is rotated with respect to zero point-since the ball is

symmetrical this is not evident (rad). phi_min=0 The minimum angle allowed. phi_max=6.28318531 The maximum angle allowed. AVO = 0.0 The initial angular velocity of ball (rad/s). dAV0 = 0.0 The initial angular acceleration of the ball (rad/s^2).

Page 129: Instructor utilities guide

A-58

ball_radial_factor=1.0 Coefficients in the equations of motion. Do not change. sled_radial_factor=1.0 Coefficients in the equations of motion. Do not change. [BucketBallsExperiment] MaxBalls=15 The Maximum number of balls allowed. X0=0 The initial x position of a ball (m). X0_min=-1000000 The minimum x coordinate allowed. Must be inside the walls. X0_max=1000000 The maximum x corrdinate allowe. Must be inside the walls. Y0=0 The initial y coordinate of the ball (m). Y0_min=-1000000 The minimum y coordinate allowed. Must be inside the walls. Y0_max=1000000 The maximum y coordinate allowed. Must be inside the walls. V0=0 The initial velocity of ball (m/s). V0_min=-300000000 The minimum velocity of ball. V0_max=300000000 The maximum velocity of ball. vmin=0.000001 The minimum velocity allowed for the ball. Beta=0 The initial angle of velocity. A 0 radian angle is with respect to the positive x-

axis, moving counterclockwise through the quadrants from 0-2Pi radians. Beta_min=0 The minimum angle of velocity. Beta_max=6.28318531 The maximum angle of velocity. Width=20 The width of the table area bordered by the walls (m). Must be greater than

zero. Width_min=1 The minimum width of the work area. Width_max=10000 The maximum width of the work area. Height=20 The height of the table area bordered by the walls (m). Must be greater than

zero. Height_min=1 The minimum height of the work area. Height_max=10000 The maximum height of the work area. Fi=0 The initial force applied to ball (N). Fi_min=0 The minimum force allowed. Fi_max=50 The maximum force allowed. phi=0.0 The initial angle of applied force. A 0 radian angle is with respect to the

positive x-axis, moving counterclockwise through the quadrants from 0-2Pi radians.

phi_min=0 The minimum angle of applied force. phi_max=6.28318531 The maximum angle of applied force. surface_material=wood The material of the surface. Must be one listed in materials section. ball_material=metal The material of the balls. Must be one listed in the materials section. MaxBall1D=3 The maximum number of balls allowed for 1-d motion. Otherwise default 2-d. gx=9.80665 The gravitational acceleration along the x axis (m/s^2). gx_min=0 The minimum gravitational acceleration. gx_max=300 The maximum gravitational acceleration. gy=9.80665 The gravitational acceleration along the y axis (m/s^2). gy_min=0 The minimum gravitational acceleration. gy_max=300 The maximum gravitational acceleration.

Page 130: Instructor utilities guide

A-59

g=9.80665 The gravitational acceleration into the screen (m/s^2). This is what is holding the ball on the surface. Graphic is not shown.

g_min=0 The minimum value for gravitational acceleration into the screen. g_max=300 The maximum value for gravitational acceleration into the screen. uk=0.38 Default coefficient of friction. uk_min=0 The minimum value for coefficient of friction. uk_max=5 The maximum value for coefficient of friction. k=1 The default coefficient of elasticity. k_min=0 The minimum coefficient of elasticity. Totally inelastic. k_max=1 The maximum coefficient of elasticity. Totally elastic. b1_m=10 The mass for ball 1 (kg). b1_r=0.5 The radius for ball 1 (m). b1_x=0 The x coordinate for ball 1 (m). b1_y=0 The y coordinate for ball 1. b1_vx=0 The x velocity for ball 1 (m/s^2). b1_vy=0 The y velocity for ball 1. b1_F=0 Indicates if force is attached to ball 1. 1=yes. 0=no. Only one force can be

applied to one of the balls at a time. b2_m=10 The mass for ball 2. b2_r=0.5 The radius for ball 2. b2_x=0 The x coordinate for ball 2. b2_y=0 The y coordinate for ball 2. b2_vx=0 The x velocity for ball 2. b2_vy=0 The y velocity for ball 2. b2_F=0 Indicates if force is attached to ball 2. 1=yes. 0=no. Only one force to one ball

at time. b3_m=10 The mass for ball 3. b3_r=0.5 The radius for ball 3. b3_x=0 The x coordinate for ball 3. b3_y=0 The y coordinate for ball 3. b3_vx=0 The x velocity for ball 3. b3_vy=0 The y velocity for ball 3. b3_F=0 Indicates if force is attached to ball 3. 1=yes. 0=no. Only one force to one ball

at time. b4_m=10 The mass for ball 4. b4_r=0.5 The radius for ball 4. b4_x=0 The x coordinate for ball 4. b4_y=0 The y coordinate for ball 4. b4_vx=0 The x velocity for ball 4. b4_vy=0 The y velocity for ball 4. b4_F=0 Indicates if force is attached to ball 4. 1=yes. 0=no. Only one force to one ball

at time. b5_m=10 The mass for ball 5. b5_r=0.5 The radius for ball 5. b5_x=0 The x coordinate for ball 5. b5_y=0 The y coordinate for ball 5. b5_vx=0 The x velocity for ball 5. b5_vy=0 The y velocity for ball 5. b5_F=0 Indicates if force is attached to ball 5. 1=yes. 0=no. Only one force to one ball

Page 131: Instructor utilities guide

A-60

at time. b6_m=10 The mass for ball 6. b6_r=0.5 The radius for ball 6. b6_x=0 The x coordinate for ball 6. b6_y=0 The y coordinate for ball 6. b6_vx=0 The x velocity for ball 6. b6_vy=0 The y velocity for ball 6. b6_F=0 Indicates if force is attached to ball 6. 1=yes. 0=no. Only one force to one ball

at time. b7_m=10 The mass for ball 7. b7_r=0.5 The radius for ball 7. b7_x=0 The x coordinate for ball 7. b7_y=0 The y coordinate for ball 7. b7_vx=0 The x velocity for ball 7. b7_vy=0 The y velocity for ball 7. b7_F=0 Indicates if force is attached to ball 7. 1=yes. 0=no. Only one force to one ball

at time. b8_m=10 The mass for ball 8. b8_r=0.5 The radius for ball 8. b8_x=0 The x coordinate for ball 8. b8_y=0 The y coordinate for ball 8. b8_vx=0 The x velocity for ball 8. b8_vy=0 The y velocity for ball 8. b8_F=0 Indicates if force is attached to ball 8. 1=yes. 0=no. Only one force to one ball

at time. b9_m=10 The mass for ball 9. b9_r=0.5 The radius for ball 9. b9_x=0 The x coordinate for ball 9. b9_y=0 The y coordinate for ball 9. b9_vx=0 The x velocity for ball 9. b9_vy=0 The y velocity for ball 9. b9_F=0 Indicates if force is attached to ball 9. 1=yes. 0=no. Only one force to one ball

at time. b10_m=10 The mass for ball 10. b10_r=0.5 The radius for ball 10. b10_x=0 The x coordinate for ball 10. b10_y=0 The y coordinate for ball 10. b10_vx=0 The x velocity for ball 10. b10_vy=0 The y velocity for ball 10. b10_F=0 Indicates if force is attached to ball 10. 1=yes. 0=no. Only one force to one ball

at time. b11_m=10 The mass for ball 11. b11_r=0.5 The radius for ball 11. b11_x=0 The x coordinate for ball 11. b11_y=0 The y coordinate for ball 11. b11_vx=0 The x velocity for ball 11. b11_vy=0 The y velocity for ball 11. b11_F=0 Indicates if force is attached to ball 11. 1=yes. 0=no. Only one force to one ball

at time.

Page 132: Instructor utilities guide

A-61

b12_m=10 The mass for ball 12. b12_r=0.5 The radius for ball 12. b12_x=0 The x coordinate for ball 12. b12_y=0 The y coordinate for ball 12. b12_vx=0 The x velocity for ball 12. b12_vy=0 The y velocity for ball 12. b12_F=0 Indicates if force is attached to ball 12. 1=yes. 0=no. Only one force to one ball

at time. b13_m=10 The mass for ball 13. b13_r=0.5 The radius for ball 13. b13_x=0 The x coordinate for ball 13. b13_y=0 The y coordinate for ball 13. b13_vx=0 The x velocity for ball 13. b13_vy=0 The y velocity for ball 13. b13_F=0 Indicates if force is attached to ball 13. 1=yes. 0=no. Only one force to one ball

at time. b14_m=10 The mass for ball 14. b14_r=0.5 The radius for ball 14. b14_x=0 The x coordinate for ball 14. b14_y=0 The y coordinate for ball 14. b14_vx=0 The x velocity for ball 14. b14_vy=0 The y velocity for ball 14. b14_F=0 Indicates if force is attached to ball 14. 1=yes. 0=no. Only one force to one ball

at time. b15_m=10 The mass for ball 15. b15_r=0.5 The radius for ball 15. b15_x=0 The x coordinate for ball 15. b15_y=0 The y coordinate for ball 15. b15_vx=0 The x velocity for ball 15. b15_vy=0 The y velocity for ball 15. b15_F=0 Indicates if force is attached to ball 15. 1=yes. 0=no. Only one force to one ball

at time. [RodExperiment] DividePoints=20 The number of sections to divide the rod into for calculations. TestPoints = 10 The number of sections to test on the rod out of the total number of divided

sections. g=9.80665 The value of the gravitational constant for rod experiment (m/s^2). g_min=0 The minimum value for the gravitational constant. g_max=300 The maximum value for the gravitational constant. [PlanetExperiment] sun_mass=1.98892e30 The mass of the sun (kg). sun_mass_min=1e25 The minimum mass of sun. sun_mass_max=1e45 The maximum mass of sun. sun_spin=0.04 The amount of spin for the sun graphic. time_min=0 The minimum date allowed in the planetary simulation. Year=0. time_max=4000 The maximum date allowed in the planetary simulation. Year=4000. CalculateAll=1 Calculate all of the data for each planet. 1=yes.0=no. Use 0 for slower

computers to speed up computations.

Page 133: Instructor utilities guide

A-62

a=1e10 The semi-major axis default (m). a_min=1e9 The minimum semi-major axis. a_max=1e14 The maximum semi-major axis. E=.1 The default eccentricity. E_min=0 The minimum eccentricity. E_max=1.0 The maximum eccentricity. mass=1e6 The default mass of planet (kg). mass_min=1e6 The minimum mass of planet. mass_max=1e45 The maximum mass of planet. inclination=0 The inclination of the orbit with respect to the Earth-Sun plane (degrees). inclination_min=0 The minimum inclination. inclination_max=180 The maximum inclination. X0=0 The initial starting position x coordinate (m). X0_min=-1e15 The minimum x coordinate. X0_max=1e15 The maximum x coordinate. Y0=0 The initial starting position y coordinate (m). Y0_min=-1e15 The minimum y coordinate. Y0_max=1e15 The maximum y coordinate. [PlanetMercury] mass=3.3022e23 The mass of Mercury (kg). a=5.791e10 The semi-major axis of Mercury (m). E=.20563 The eccentricity of the orbit of Mercury. Inclination=7 The inclination of the orbit of Mercury. X0=-0.27856 The initial x coordinate of Mercury-this is from the starting day of Jan 1, 2006

(AU). Y0=-0.36032 The initial y coordinate of Mercury-this is from the starting day of Jan 1, 2006

(AU). Y0_Hemi=- The check for initial position since a circle can have positive y values and

negative y values for the same x. The program only places the planet initially according to the x value. = Above x axis. - = Below x axis.

spin=0.01705140316 The rotational period based off of 1 being the spin of the Earth. moons= The moons associated with Mercury. None allowed. [PlanetVenus] The mass of Venus (kg). mass=4.869e24 The semi-major axis of Venus (m). a=10.821e10 The eccentricity of the orbit of Venus. E=.0067 The inclination of the orbit of Venus. Inclination=3.39 The initial x coordinate of Venus- this is from the starting day of Jan 1, 2006

(AU). X0=-0.03285 The initial y coordinate of Venus - this is from the starting day of Jan 1, 2006

(AU). Y0=0.71867 The check for initial position since a circle can have positive y values and

negative y values. The program only places the planet initially according to the x value. = Above x axis. - = Below x axis.

spin=0.004114913062 The rotational period based off of 1 being the spin of the Earth. moons= The moons associated with Venus. None allowed. [PlanetEarth] mass=5.9742e24 The mass of Earth (kg).

Page 134: Instructor utilities guide

A-63

a=14.96e10 The semi-major axis of Earth (m). E=.0167 The eccentricity of the orbit of Earth. Inclination=0 The inclination of the orbit of Earth. X0=-0.17789 The x coordinate of Earth (AU). Y0=0.96713 The y coordinate of Earth. spin=1 The rotational period based off of 1 being the spin of the Earth. moons=Moon The moons associated with Earth. Options: Moon [PlanetMars] mass=6.4191e23 The mass of Mars. a=22.792e10 The semi-major axis of Mars. E=.0935 The eccentricity of the orbit of Mars. Inclination=1.85 The inclination of the orbit of Mars. X0=0.40626 The initial x coordinate of Mars. Y0=1.47623 The initial y coordinate of Mars. spin=1.00273948427 The rotational period based off of 1 being the spin of the Earth. moons=Deimos,Phobos The moons associated with Mars. Options: Deimos,Phobos [PlanetJupiter] mass=1.8988e27 The mass of Jupiter. a=77.857e10 The semi-major axis of Jupiter. E=.0489 The eccentricity of the orbit of Jupiter. Inclination=1.3 The inclination of the orbit of Jupiter. X0=-4.47847 The initial x coordinate of Jupiter. Y0=-3.08624 The initial y coordinate of Jupiter. Y0_Hemi=- The check for initial position since a circle can have positive y values and

negative y values. The program only places the planet initially according to the x value. = Above x axis. - = Below x axis.

spin=2.41815733794 The rotational period based off of 1 being the spin of the Earth. moons=Callisto,Europa,Ganymede,Io The moons associated with Jupiter. Options: Callisto,Europa,Ganymede,Io [PlanetSaturn] The mass of Saturn. mass=5.685e26 The semi-major axis of Saturn. a=143.353e10 The eccentricity of the orbit of Saturn. E=.0565 The inclination of the orbit of Saturn. Inclination=2.49 The initial x coordinate of Saturn. X0=-5.46407 The initial y coordinate of Saturn. Y0=7.2853 The check for initial position since a circle can have positive y values and

negative y values. The program only places the planet initially according to the x value. = Above x axis. - = Below x axis.

spin=2.25220528566 The rotational period based off of 1 being the spin of the Earth. moons=Enceladus,Iapetus,Mimas,Titan The moons associated with Saturn. Options:Enceladus,Iapetus,Mimas,Titan [PlanetUranus] mass=8.6625e25 The mass of Uranus. a=287.246e10 The semi-major axis of Uranus. E=.0457 The eccentricity of the orbit of Uranus. Inclination=.77 The inclination of the orbit of Uranus. X0=18.8727 The initial x coordinate of Uranus. Y0=-6.83659 The initial y coordinate of Uranus. Y0_Hemi=- The check for initial position since a circle can have positive y values and

negative y values. The program only places the planet initially according to the x value. = Above x axis. - = Below x axis.

spin=1.39211136956 The rotational period based off of 1 being the spin of the Earth. moons=Titania,Miranda,Oberon The moons associated with Uranus. Options:Titania,Miranda,Oberon

Page 135: Instructor utilities guide

A-64

[PlanetNeptune] mass=1.0278e26 The mass of Neptune. a=449.506e10 The semi-major axis of Neptune. E=.0113 The eccentricity of the orbit of Neptune. Inclination=1.77 The inclination of the orbit of Neptune. X0=22.0093 The initial x coordinate of Neptune. Y0=-20.4713 The initial y coordinate of Neptune. Y0_Hemi=- The check for initial position since a circle can have positive y values and

negative y values. The program only places the planet initially according to the x value. = Above x axis. - = Below x axis.

spin=1.48975791434 The rotational period based off of 1 being the spin of the Earth. moons=Triton The moons associated with Neptune. Option: Triton [PlanetPluto] mass=1.314e22 The mass of Pluto. a=590.638e10 The semi-major axis of Pluto. E=.2488 The eccentricity of the orbit of Pluto. Inclination=17.15 The inclination of the orbit of Pluto. X0=-3.00077 The initial x coordinate of Pluto. Y0=-30.6266 The initial y coordinate of Pluto. Y0_Hemi=- The check for initial position since a circle can have positive y values and

negative y values. The program only places the planet initially according to the x value. = Above x axis. - = Below x axis.

spin=0.156568028809 The rotational period based off of 1 being the spin of the Earth. moons=Charon The moons associated with Pluto. Option: Charon [Planet] mass=6e24 The mass of the Planet. a=2 The semi-major axis of the Planet. E=.15 The eccentricity of the Planet. Inclination= The inclination of the orbit of the Planet. X0=-3.00077 The x coordinate of the Planet . moons= The moons associated the Planet. Option: none. [PlanetHalleysComet] mass=1.7e15 The mass of Halley’s Comet. a=268.379E+10 The semi-major axis Halley’s Comet. E=.9673 The eccentricity of the orbit of Halley’s Comet. Inclination=162.24 The inclination of the orbit of Halley’s Comet. X0=28.04863505 The x coordinate of Halley’s Comet. moons= The moons associated with Halley’s Comet. None allowed. [MoonMoon] Mass=7.3349e22 The mass of the Moon (kg). E=.0549 The eccentricity of the orbit of the Moon. Inclination=5.145 The inclination of the orbit of the Moon. R=1.74e6 The radius of the Moon (m) a=3.844e8 The semi-major axis of the orbit of the Moon. X0=-.17697 The initial x coordinate of the Moon (AU). Y0=.96490 The initial y coordinate of the Moon (AU). [MoonDeimos] Mass=5e11 The mass of Deimos (kg). E=0.0 The eccentricity of the orbit of Deimos. Inclination=1.8 The inclination of the orbit of Deimos. R=4e3 The radius of Deimos (m).

Page 136: Instructor utilities guide

A-65

a=2.3495e7 The semi-major axis of the orbit of Deimos. X0=.40626 The initial x coordinate of Deimos (AU). Y0=1.47607 The initial y coordinate of the Deimos (AU). OrbitReset=.05 The number of years to elapse before the orbit resets to the original initial

position due to the multi-body interactions. [MoonPhobos] Mass=1.05e16 The mass of Phobos (kg). E=.01 The eccentricity of Phobos. Inclination=1 The inclination of the orbit of Phobos. R=6e3 The radius of Phobos (m) a=9.378e6 The semi-major axis of the orbit of Phobos. X0=.40620 The initial x coordinate of Phobos (AU). Y0=1.47622 The initial y coordinate of Phobos (AU). OrbitReset=.05 The number of years to elapse before the orbit resets to the original initial

position due to the multi-body interactions. [MoonCallisto] Mass=1.076e23 The mass of Callisto (kg). E=.007 The eccentricity of Callisto. Inclination=.51 The inclination of the orbit of Callisto. R=2.4e6 The radius of Callisto (m) a=1.883e9 The semi-major axis of the orbit of Callisto. X0=-4.49089 The initial x coordinate of Callisto (AU). Y0=-3.08874 The initial y coordinate of Callisto (AU). Y0_Hemi=- The check for initial position since a circle can have positive y values and

negative y values. + = Above x axis. - = Below x axis. OrbitReset=10 The number of years to elapse before the orbit resets to the original initial

position due to the multi-body interactions. [MoonEuropa] Mass=4.8e22 The mass of Europa (kg). E=.009 The eccentricity of Europa. Inclination=.47 The inclination of the orbit of Europa. R=1.569e6 The radius of Europa (m) a=6.709e8 The semi-major axis of the orbit of Europa. X0=-4.47986 The initial x coordinate of Europa (AU). Y0=-3.09054 The initial y coordinate of Europa (AU). Y0_Hemi=- The check for initial position since a circle can have positive y values and

negative y values. + = Above x axis. - = Below x axis. OrbitReset=10 The number of years to elapse before the orbit resets to the original initial

position due to the multi-body interactions. [MoonGanymede] Mass=1.482e23 The mass of Ganymede (kg). E=.0015 The eccentricity of Ganymede. Inclination=.21 The inclination of the orbit of Ganymede. R=2.631e6 The radius of Ganymede (m) a=1.07e9 The semi-major axis of the orbit of Ganymede. X0=-4.47229 The initial x coordinate of Ganymede (AU). Y0=-3.08984 The initial y coordinate of Ganymede (AU). Y0_Hemi=- The check for initial position since a circle can have positive y values and

negative y values. + = Above x axis. - = Below x axis. OrbitReset=10 The number of years to elapse before the orbit resets to the original initial

position due to the multi-body interactions.

Page 137: Instructor utilities guide

A-66

[MoonIo] Mass=8.93e22 The mass of Io (kg). E=.004 The eccentricity of Io. Inclination=.04 The inclination of the orbit of Io. R=1.818e6 The radius of Io (m) a=4.216e8 The semi-major axis of the orbit of Io. X0=-4.47805 The initial x coordinate of Io (AU). Y0=-3.08902 The initial y coordinate of Io (AU). Y0_Hemi=- The check for initial position since a circle can have positive y values and

negative y values. + = Above x axis. - = Below x axis. OrbitReset=10 The number of years to elapse before the orbit resets to the original initial

position due to the multi-body interactions. [MoonEnceladus] Mass=8.4e19 The mass of Enceladus (kg). E=.00452 The eccentricity of Enceladus. Inclination=0 The inclination of the orbit of Enceladus. R=2.5e5 The radius of Enceladus (m) a=2.3804e8 The semi-major axis of the orbit of Enceladus. X0=-5.46372 The initial x coordinate of Enceladus (AU). Y0=7.28666 The initial y coordinate of Enceladus (AU). OrbitReset=10 The number of years to elapse before the orbit resets to the original initial

position due to the multi-body interactions. [MoonIapetus] Mass=1.88e21 The mass of Iapetus (kg). E=.028 The eccentricity of Iapetus. Inclination=7.52 The inclination of the orbit of Iapetus. R=7.30e5 The radius of Iapetus (m) a=3.5608e9 The semi-major axis of the orbit of Iapetus. X0=-5.46279 The initial x coordinate of Iapetus (AU). Y0=7.30821 The initial y coordinate of Iapetus (AU). OrbitReset=10 The number of years to elapse before the orbit resets to the original initial

position due to the multi-body interactions. [MoonMimas] Mass=3.8e19 The mass of Mimas (kg). E=.0202 The eccentricity of Mimas. Inclination=1.53 The inclination of the orbit of Mimas. R=1.96e5 The radius of Mimas (m) a=1.8554e8 The semi-major axis of the orbit of Mimas. X0=-5.46410 The initial x coordinate of Mimas (AU). Y0=7.28642 The initial y coordinate of Mimas (AU). OrbitReset=10 The number of years to elapse before the orbit resets to the original initial

position due to the multi-body interactions. [MoonTitan] Mass=1.35e23 The mass of Titan (kg). E=.0292 The eccentricity of Titan. Inclination=.33 The inclination of the orbit of Titan. R=2.575e6 The radius of Titan (m) a=1.22186e9 The semi-major axis of the orbit of Titan. X0=-5.46105 The initial x coordinate of Titan (AU). Y0=7.27859 The initial y coordinate of Titan (AU). OrbitReset=10 The number of years to elapse before the orbit resets to the original initial

position due to the multi-body interactions.

Page 138: Instructor utilities guide

A-67

[MoonTitania] Mass=3.52e21 The mass of Titania (kg). E=.0022 The eccentricity of Titania. Inclination=.14 The inclination of the orbit of Titania. R=7.9e5 The radius of Titania (m) a=4.38e8 The semi-major axis of the orbit of Titania. X0=18.8755 The initial x coordinate of Titania (AU). Y0=-6.83724 The initial y coordinate of Titania (AU). Y0_Hemi=- The check for initial position since a circle can have positive y values and

negative y values. + = Above x axis. - = Below x axis. OrbitReset=10 The number of years to elapse before the orbit resets to the original initial

position due to the multi-body interactions. [MoonMiranda] Mass=6.33e19 The mass of Miranda (kg). E=.003 The eccentricity of Miranda. Inclination=4.22 The inclination of the orbit of Miranda. R=2.36e5 The radius of Miranda (m) a=1.3e8 The semi-major axis of the orbit of Miranda. X0=18.8729 The initial x coordinate of Miranda (AU). Y0=-6.83648 The initial y coordinate of Miranda (AU). Y0_Hemi=- The check for initial position since a circle can have positive y values and

negative y values. + = Above x axis. - = Below x axis. OrbitReset=10 The number of years to elapse before the orbit resets to the original initial

position due to the multi-body interactions. [MoonOberon] Mass=3.01e21 The mass of Oberon (kg). E=.0008 The eccentricity of Oberon. Inclination=.1 The inclination of the orbit of Oberon. R=7.63e5 The radius of Oberon (m) a=5.834e8 The semi-major axis of the orbit of Oberon. X0=18.8721 The initial x coordinate of Oberon (AU). Y0=-6.83700 The initial y coordinate of Oberon (AU). Y0_Hemi=- The check for initial position since a circle can have positive y values and

negative y values. + = Above x axis. - = Below x axis. OrbitReset=10 The number of years to elapse before the orbit resets to the original initial

position due to the multi-body interactions. [MoonTriton] Mass=2.14e22 The mass of Triton (kg). E=.000016 The eccentricity of Triton. Inclination=157.345 The inclination of the orbit of Triton. R=1.352e6 The radius of Triton (m) a=3.55e8 The semi-major axis of the orbit of Triton. X0=22.0071 The initial x coordinate of Triton (AU). Y0=-20.4712 The initial y coordinate of Triton (AU). Y0_Hemi=- The check for initial position since a circle can have positive y values and

negative y values. + = Above x axis. - = Below x axis. OrbitReset=10 The number of years to elapse before the orbit resets to the original initial

position due to the multi-body interactions. [MoonCharon] Mass=1.62e21 The mass of Charon (kg). E=.0003 The eccentricity of Charon.

Page 139: Instructor utilities guide

A-68

Inclination=96.16 The inclination of the orbit of Charon. R=5.93e5 The radius of Charon (m) a=1.9571e8 The semi-major axis of the orbit of Charon. X0=-3.00089 The initial x coordinate of Charon (AU). Y0=-30.6267 The initial y coordinate of Charon (AU). Y0_Hemi=- The check for initial position since a circle can have positive y values and

negative y values. + = Above x axis. - = Below x axis. OrbitReset=10 The number of years to elapse before the orbit resets to the original initial

position due to the multi-body interactions. [FreeMotionUniformGravityBall] h=.01 The Runge Kutta step size for free motion uniform gravity experiments with

ball. hmin=.00001 The minimum step size allowed. equationTimer_mSec=100 . TOL=.00001 The accuracy of the values being approximated in Runge Kutta. [FreeMotionUniformGravitySled] h=.01 The Runge Kutta step size for free motion uniform gravity experiments with

sled. hmin=.00001 The minimum step size allowed. equationTimer_mSec=100 TOL=.00001 The accuracy of the values being approximated in Runge Kutta. [FreeMotionRadialGravityBall] h=.01 The Runge Kutta step size for free motion radial gravity experiments with ball. hmin=.00001 The minimum step size allowed. equationTimer_mSec=100 TOL=.00001 The accuracy of the values being approximated in Runge Kutta. [FreeMotionRadialGravitySled] h=.01 The Runge Kutta step size for free motion radial gravity experiments with sled. hmin=.00001 The minimum step size allowed. equationTimer_mSec=100 TOl=.00001 The accuracy of the values being approximated in Runge Kutta. [RampUniformGravityBall] h=.01 The Runge Kutta step size for ramp motion uniform gravity experiments with

ball. hmin=.00001 The minimum step size allowed. equationTimer_mSec=100 TOL=.00001 The accuracy of the values being approximated in Runge Kutta. TOLMax=1 The maximum allowed TOL value before it just accepts the value. [RampUniformGravitySled] h=.01 The Runge Kutta step size for ramp motion uniform gravity experiments with

sled. hmin=.00001 The minimum step size allowed. equationTimer_mSec=100 TOL=.00001 The accuracy of the values being approximated in Runge Kutta. TOLMax=.75 The maximum allowed TOL value before it just accepts the value. [RampRadialGravityBall] h=.01 The Runge Kutta step size for ramp motion radial gravity experiments with

ball. hmin=.00001 The minimum step size allowed.

Page 140: Instructor utilities guide

A-69

equationTimer_mSec=100 TOL=.00001 The accuracy of the values being approximated in Runge Kutta. TOLMax=1 The maximum allowed TOL value before it just accepts the value. [RampRadialGravitySled] h=.01 The Runge Kutta step size for ramp motion radial gravity experiments with

sled. hmin=.00001 The minimum step size allowed. equationTimer_mSec=100 TOL=.007 The accuracy of the values being approximated in Runge Kutta. TOLMax=.1 The maximum allowed TOL value before it just accepts the value. [BucketBalls] h=.001 The step size for the Bucket of Balls experiment. hmin=.0000001 The minimum step size allowed. equationTimer_mSec=100 TOL=.00001 Not used. [FallingRod] h=.01 The Runge Kutta step size for the falling rod experiment. hmin=.00001 The minimum step size allowed. equationTimer_mSec=100 TOL=.00001 The accuracy of the values being approximated in Runge Kutta. [Planets] h=86400 The maximum step size for Runge Kutta to use in planetary motion. hmin=.000001 The minimum step sized allowed in Runge Kutta. equationTimer_mSec=75 TOL=1.0 The accuracy of the values being approximated in Runge Kutta. X0_Diff=.01 The accuracy of finding the initial position. [Administrator] Phi0=0 The initial angular velocity of the ball in ramp experiment. Phi0_min=0 The minimum initial angular velocity. Phi0_max=10 The maximum initial angular velocity. [Misc] Cp_ball=.5 The drag coefficient for a generic ball. Cp_sled=1 The drag coefficient for a generic block. alpha=.000155 The linear air resistance constant. row=1.2250 The default air density.

Preset Experiments Located on the clipboard in the mechanics stockroom is a set of 15 preset experiments listed by

title. If allowed by the instructor, students can select one of these experiments and, upon

returning to the laboratory, the selected experiment will be automatically set up and running. A

preset experiment can also be used for assignments so a student can accept an assignment with

the experiment already set up for them. Preset experiments are intended to provide flexibility for

the instructor so the mechanics simulation can be adapted to the level of the class or the

individual teaching style of the instructor. Several experiments have already been defined and are

installed with the software. This section describes how these files can be modified.

Page 141: Instructor utilities guide

A-70

Each preset experiment is defined using an INI file. For the preset experiments on the clipboard,

these files have the name Experimentn.ini, where n is a number between 1 and 15 and represents

experiments 1 through 15 on the clipboard. These files are located in the Presets directory in the

PhysicsM directory. For the preset experiments used in assignments, these files must be located

in the Assignments/Mechanics directory and can have any name but must have the extension

“.ini”. Information on how to use preset experiments in assignments is given in the “Mechanics

Assignments” section. Note that in client installations, any modified preset experiments for the

clipboard must be modified for each client installation.

Given subsequently is a description of a preset experiment INI file and the variables that are used

to define an experiment. Before reviewing the INI file information, here are some important

points to keep in mind: (a) All of the variables described have default values, so variables may be

left blank or not used at all. An experiment can be set up or defined to any degree desired by the

instructor. (b) Some variables are mutually exclusive; that is, the use of one variable may mean

another variable cannot be used. Some error checking exists for such situations, but the error

checking is not comprehensive.

The following two tables show the INI variables used in preset experiments. The first lists all the

variables that can be used and their allowed values. Default values are given in red. The second

is an example of a preset experiment for a balanced force experiment to show how the variables

can be used.

Complete Mechanics Preset Experiment INI Variable List

[Title] title=Free Motion Radial Gravity – Ball The title for the lab. [General] tray= bucketballs,ramp,air,sliding, rolling, gUp, gDown, gRight, gLeft, gRadial, rocket, plunger, mercury, venus, earth, mars, juptier, saturn, uranus, neptune, pluto, comet

Sets which items are in the tray. (Case sensitive). Remember some are mutually exclusive. They must be placed in this order.

motion= ramp,air,sliding, rolling, gUp, gDown, gRight, gLeft, gRadial, rocket, plunger, mercury, venus, earth, mars, juptier, saturn, uranus, neptune, pluto, comet

Sets which items are in the motion experiment area. (Case sensitive). Items must be placed in order as they appear in the options.

startLoc=motion (or stock, lab) Starting location for the preset. gridx1=-12 The initial coordinates for the grid. X1 is for the negative x values. gridx2=12 x2 on the positive x values. gridy1=-7 Grid y coordinates will be ignored unless we are in free motion (they will

always be scaled to match the x coordinates). y1 is the negative y values. gridy2=7 y2 is the positive y values. coordinate=polar (or Cartesian, cartesianTotal, polarTotal)

The current coordinate system displayed.

labbook=1 The labbook is open or closed. 1=open, 0=closed acceleration=1 (or 0.01, 0.05, 0.1, 0.5, 1, 5, 10, 50, 100, 500)

The time acceleration factor to use. Must equal one of the options in the INI file above.

Page 142: Instructor utilities guide

A-71

recordData=a1, b1, a2, b2, a3, b3, a4, b4, a5, b5

The list of cells from the data output table to record in the labbook. The rows are labeled a and b from top to bottom and the columns are numbered 1-5 from left to right.

[Units] time=s (or min,hr, day, yr) The time units used. position=m (or cm, km, in, ft, yrd, mi, AU, lya)

The position units used.

mass=kg (or g, Mg, oz, lbs, T, slg) The mass units used. force=N (or dyn, PF, TF) The force units used. [planet] view=0 (or 1, 2, 3) The view to go to. Options 0 (solar system top), 1 (solar system parallel view),

2 (planet top), 3 (planet inside) size=0 (or 1) Sets the size of the planets. 1=big (enlarged), 0=small (to scale) planet=earth (or any planet) Selected Planet. trackMoon=moon Moon to track. Used ONLY if view = 2 or 3 AND it's planet is specified angle=0 ( between 0 – 360) Angle of view for inside view. date=0 Tells how many days from day 0 year 2006. It can be positive or negative. sun_mass=1.9819e30 Mass of the sun. [ball] m=100 The mass of the ball. r=1.16 The radius of the ball. vx=-5 The velocity in x-direction (ignored for ramp). vy=.2 The velocity in y-direction (ignored for ramp). v=-2 The total velocity - used only for when ball is placed DIRECTLY in motion area

on ramp (ie not on tray) x=-1 The initial x coordinate. y=2 The initial y coordinate. s=10 The position from the bottom of the ramp (x and y coordinates are ignored). material=rubber The material of ball. Must match materials list in INI file. sphere=thin The type of sphere to use. Options: solid or thin. This only makes a difference

for ramp motion for the rotational inertia. [sled] m=100 The mass of the sled. l=10 The length of the sled. h=25 The height of the sled. w=30 The width of the sled. vx=-5 The velocity of the sled in the x direction. vy=.2 The velocity of the sled in the y direction. v=-2 The velocity of the sled along the ramp. x=1 The initial x coordinante of the sled. y=2 The initial y coordinante of the sled. s=10 The initial position along the ramp from the bottom. material=rubber The material of the sled. Must be one of the options in INI file. [rod] theta=.00314 The initial angle of the rod. Angle from 0-1.57079633 r=10 The radius of the rod. l=20 The length of the rod. tensile=689000 The tensile strength of the rod. Units in pascals. density=1000 The density of the material of the rod. material=aluminum This will set tensile and density, if tensile and density variables are missing

from the preset. Must match material in INI file.

Page 143: Instructor utilities guide

A-72

[bucketballs] surface_material=metal The surface material of the table. Must match a material in the INI file. ball_material=plastic The material of the ball. Must match material in the INI file. k=1 The elasticity coefficient. Between 0-1. type=1D The type of experiment being performed. Options: 1D or 2D. # is a number between 1-15. Each ball will have the following information if you want to specify it in a preset. b#_m=10 The mass of ball #. b#_r=0.5 The radius of ball #. b#_x=0 The initial x coordinante of ball #. Ignored if not in motion area. b#_y=0 The initial y coordinante of ball #. Ignored if not in motion area. b#_vx=0 The initial velcosity in the x direction of ball #. b#_vy=0 The initial velocity in the y direction of ball #. b#_motion=1 This indicates if ball is in the motion area. 0=no 1=yes b#_F=1 This indicates if the force is attached to this ball. Can only be attached to one

ball at a time. Ball must be in motion area. 0=no 1=attached b#_Selected=0 Sets if this ball is currently being tracked for display. 0=No. 1=Tracked. [ramp] theta = .33 The angle of the ramp from the x-axis. Options between 0 – 1.570796 rad. L=100 The length of the ramp. material=wood The material of the ramp. [air] P=101325 The pressure of the location of experiment (Pa). This sets the air resistance. Z=5 The altitude of location of experiment (m). [sliding] uk=.23 The coefficient of friction for sliding and rolling with slipping. [rolling] uk=.23 The coefficient of friction for pure rolling without slipping. [gUp] g=9.8 The gravitational acceleration in the up direction (m/s^2). [gDown] g=9.8 The gravitational acceleration in the down direction. [gLeft] g=9.8 The gravitational acceleration in the left direction. [gRight] g=9.8 The gravitational acceleration in the right direction. [gRadial] g=9.8 The gravitational acceleration in the radial direction. d=.5 The distance below the surface of the ramp the radial sink is located-projected

perpendicular to the ramp surface (m) [rocket] Fi=1000 The magnitude of force. time=-1 The time of applied force. -1=continuous. Positive values set the number of

seconds the rocket is applied. angle=.78 The angle of applied force. Overwrittien if there is a ramp chosen at a defined

Page 144: Instructor utilities guide

A-73

angle. The force will be applied at that angle. The sled can only be hit at angles of 0, pi/2, pi, 3*pi/2.

[plunger] Fi=10000 The magnitude of force. angle=.78 The angle of the applied force. Overwritten with sled or ramp. [mercury] hideMoon= Sets which moons to NOT display. Options: none. [venus] hideMoon= Sets which moons to NOT display. Options: none. [earth] hideMoon= Sets which moons to NOT display. Options: moon. [mars] hideMoon= Sets which moons to NOT display. Options: Deimos, Phobos. [jupiter] hideMoon=io,europa Sets which moons to NOT display. Options: Callisto, Europa, Ganymede, Io. [saturn] hideMoon= Sets which moons to NOT display. Options: Enceladus, Iapetus, Mimas, Titan. [uranus] hideMoon= Sets which moons to NOT display. Options: Titania, Miranda, Oberon. [neptune] hideMoon= Sets which moons to NOT display. Options: Triton. [pluto] hideMoon= Sets which moons to NOT display. Options: Charon. [comet]

Example Mechanics Preset Experiment

[Title] title=Balanced Forces The title for the experiment. [General] tray=rolling The items in the tray. motion=ramp, ball, gDown, rocket The items in the motion area. startLoc=motion The current viewing location. gridx1=10 The setup for the grid axis. gridx2=0 gridy1=-7 gridy2=7 coordinate=Polar The current coordinates. labbook=1 The labbook is opened. acceleration=1 The time acceleration value. recordData=a1, b1, a2, b2, a3 The data to record in the labbook. [Units] The current units. time=sec position=m mass=kg force=N [ball] m=100 The mass of the ball. r=1.5 The radius of the ball. vx=0 The initial x velocity of the ball.

Page 145: Instructor utilities guide

A-74

vy=0 The initial y velocity of the ball. v=0 The initial total velocity of the ball. x=0 The initial x coordinate. y=0 The initial y coordinate. s=50 The initial position on the ramp from the bottom. material=wood The material of the ball. sphere=solid The type of ball. [ramp] theta = 1.570796 The angle of the ramp. l=100 The length of the ramp. material=cement The material of the ramp. [rolling] �k=.38 The coefficient of friction. [gDown] g=9.80665 The gravitational acceleration down. [rocket] Fi=849.3 The magnitude of force. time=-1 The time of applied force. angle=3.141592654 The angle of applied force.

Density INI File

The density laboratory allows students the ability to perform realistic density and buoyancy

experiments in a controlled environment of their pleasing. Much of the experiments are

controlled using the laboratory INI file however, there are presets that will be determined by

their own preset INI files. The presets INI are described bleow. The variables contained in the

laboratory INI file are explained below. Note that each variable has its own default max/min

values. The purpose of providing this information is to grant instructors the ability to change or

adjust the density simulation to suit their own needs.

Density.ini INI Variables Description [Balance] Required header line.

BalDigits=3 The number of decimal places available on the balance.

MaxBalance=4.0 The maximum mass that can be weighed on the balance in kg.

Balance_Flicker_Max=.000001 The maximum amount that the balance flickers between readings.

Balance_Flicker_Time=2.5 The time between each flicker in seconds.

[Beaker] Required header line.

Beaker_mass_%dev=5 The percent deviation in weight from the set beaker mass.

MaxBeakerVol=250 The maximum amount of volume a beaker can hold in mL.

Beaker_mass=.100 The set mass for each beaker in g.

[Solids] Required header line.

Object_mass_%dev=0.1 The percent deviation in weight from the set object mass.

radius_min=.015 The minimum radius of the object in meters.

Page 146: Instructor utilities guide

A-75

radius_max=.0172 The maximum radius of the object in meters.

VSolidmindensity=0.1 The minimum density of a random virtual solid (g/mL).

VSolidmaxdensity=25 The maximum density of a random virtual solid (g/mL).

[Fluids] Required header line.

VFluidmindensity=0.1 The minimum density of a random virtual fluid (g/mL).

VFluidmaxdensity=25 The maximum density of a random virtual fluid (g/mL).

VFluidminviscosity=0.000001 The minimum viscosity of a random virtual fluid.

VFluidmaxviscosity=25 The maximum viscosity of a random virtual fluid.

[Cylinder] Required header line.

MaxCylVol=230 The maximum volume fill for the cylinder in mL.

radius=.017841 The radius of the graduated cylinder in meters.

FillVariationMax=4.0 The maximum variation in volume of the filled cylinder in mL.

GlassError_%Dev=0.25 The percent deviation in glassware error.

[Timer] Required header line.

TimeDigits=2 Number of decimil places shown on the timer.

Solids.ini INI Variables Description

[Aluminum] Required header line.

Solid=Aluminum The name of the solid.

Density=2.643 The density of the solid (g/mL).

Color=Aluminum The color of the solid.

Explodes= What liquids the solid explodes in.

[Brass] Required header line.

Solid=Brass The name of the solid.

Density=8.553 The density of the solid (g/mL).

Color=Brass The color of the solid.

Explodes= What liquids the solid explodes in.

[Brick] Required header line.

Solid=Brick The name of the solid.

Density=1.922 The density of the solid (g/mL).

Color=Brick The color of the solid.

Explodes= What liquids the solid explodes in.

[Bronze] Required header line.

Solid=Bronze The name of the solid.

Density=8.8 The density of the solid (g/mL).

Color=Bronze The color of the solid.

Explodes= What liquids the solid explodes in.

[Carbon] Required header line.

Page 147: Instructor utilities guide

A-76

Solid=Carbon The name of the solid.

Density=2.163 The density of the solid (g/mL).

Color=Carbon The color of the solid.

Explodes= What liquids the solid explodes in.

[Cement] Required header line.

Solid=Cement The name of the solid.

Density=1.509 The density of the solid (g/mL).

Color=Cement The color of the solid.

Explodes= What liquids the solid explodes in.

[Cesium] Required header line.

Solid=Cesium The name of the solid.

Density=1.879 The density of the solid (g/mL).

Color=Cesium The color of the solid.

Explodes= Acetone, Alcohol, Ammonia, Bromine, Ethanol, Glycerol, Maple Syrup, Milk, Phenolphthalein, Salt Water, Soda, Water

What liquids the solid explodes in.

[Cherry Wood] Required header line.

Solid=Cherry Wood The name of the solid.

Density=.433 The density of the solid (g/mL).

Color=Cherry Wood The color of the solid.

Explodes= What liquids the solid explodes in.

[Chocolate] Required header line.

Solid=Chocolate The name of the solid.

Density=1.3 The density of the solid (g/mL).

Color=Chocolate The color of the solid.

Explodes= What liquids the solid explodes in.

[Copper] Required header line.

Solid=Copper The name of the solid.

Density=8.92 The density of the solid (g/mL).

Color=Copper The color of the solid.

Explodes= What liquids the solid explodes in.

[Cork] Required header line.

Solid=Cork The name of the solid.

Density=.24 The density of the solid (g/mL).

Color=Cork The color of the solid.

Explodes= What liquids the solid explodes in.

[Glass] Required header line.

Solid=Glass The name of the solid.

Density=2.579 The density of the solid.

Color=Glass The color of the solid.

Explodes= What liquids the solid explodes in.

Page 148: Instructor utilities guide

A-77

[Gold] Required header line.

Solid=Gold The name of the solid.

Density=19.32 The density of the solid (g/mL).

Color=gold The color of the solid.

Explodes= What liquids the solid explodes in.

[Granite] Required header line.

Solid=Granite The name of the solid.

Density=2.691 The density of the solid (g/mL).

Color=Granite The color of the solid.

Explodes= What liquids the solid explodes in.

[Ice] Required header line.

Solid=Ice The name of the solid.

Density=.897 The density of the solid (g/mL).

Color=Ice The color of the solid.

Explodes= What liquids the solid explodes in.

[Iron] Required header line.

Solid=Iron The name of the solid.

Density=7.207 The density of the solid (g/mL).

Color=Iron The color of the solid.

Explodes= What liquids the solid explodes in.

[Ivory] Required header line.

Solid=Ivory The name of the solid.

Density=1.842 The density of the solid (g/mL).

Color=Ivory The color of the solid.

Explodes= What liquids the solid explodes in.

[Lead] Required header line.

Solid=Lead The name of the solid.

Density=11.37 The density of the solid (g/mL).

Color=Lead The color of the solid.

Explodes= What liquids the solid explodes in.

[Limestone] Required header line.

Solid=Limestone The name of the solid.

Density=2.467 The density of the solid (g/mL).

Color=Limestone The color of the solid.

Explodes= What liquids the solid explodes in.

[Mahogany] Required header line.

Solid=Mahogany The name of the solid.

Density=.705 The density of the solid (g/mL).

Color=Mahogany The color of the solid.

Explodes= What liquids the solid explodes in.

Page 149: Instructor utilities guide

A-78

[Nickel] Required header line.

Solid=Nickel The name of the solid.

Density=8.602 The density of the solid (g/mL).

Color=Nickel The color of the solid.

Explodes= What liquids the solid explodes in.

[Pine Wood] Required header line.

Solid=Pine Wood The name of the solid.

Density=.65 The density of the solid (g/mL).

Color=Pine Wood The color of the solid.

Explodes= What liquids the solid explodes in.

[Plastic] Required header line.

Solid=Plastic The name of the solid.

Density=1.00 The density of the solid (g/mL).

Color=Plastic The color of the solid.

Explodes= What liquids the solid explodes in.

[Platinum] Required header line.

Solid=Platinum The name of the solid.

Density=21.090 The density of the solid (g/mL).

Color=Platinum The color of the solid.

Explodes= What liquids the solid explodes in.

[Red Oak Wood] Required header line.

Solid=Red Oak Wood The name of the solid.

Density=.673 The density of the solid (g/mL).

Color=Red Oak Wood The color of the solid.

Explodes= What liquids the solid explodes in.

[Rubber] Required header line.

Solid=Rubber The name of the solid.

Density=1.506 The density of the solid (g/mL).

Color=Rubber The color of the solid.

Explodes= What liquids the solid explodes in.

[Sodium] Required header line.

Solid=Sodium The name of the solid.

Density=0.968 The density of the solid (g/mL).

Color=Silicon The color of the solid.

Explodes= Acetone, Alcohol, Ammonia, Bromine, Ethanol, Glycerol, Maple Syrup, Milk, Phenolphthalein, Salt Water, Soda, Water

What liquids the solid explodes in.

[Silver] Required header line.

Solid=Silver The name of the solid.

Density=10.490 The density of the solid (g/mL).

Page 150: Instructor utilities guide

A-79

Color=silver The color of the solid.

Explodes= What liquids the solid explodes in.

[Steel] Required header line.

Solid=Steel The name of the solid.

Density=7.715 The density of the solid (g/mL).

Color=Steel The color of the solid.

Explodes= What liquids the solid explodes in.

[Sulfur] Required header line.

Solid=Sulfur The name of the solid.

Density=2.002 The density of the solid (g/mL).

Color=Sulfur The color of the solid.

Explodes= What liquids the solid explodes in.

[Tin] Required header line.

Solid=Tin The name of the solid.

Density=7.352 The density of the solid (g/mL).

Color=Tin The color of the solid.

Explodes= What liquids the solid explodes in.

[Titanium] Required header line.

Solid=Titanium The name of the solid.

Density=4.507 The density of the solid (g/mL).

Color=Titanium The color of the solid.

Explodes= What liquids the solid explodes in.

[Tungsten] Required header line.

Solid=Tungsten The name of the solid.

Density=19.250 The density of the solid (g/mL).

Color=Tungsten The color of the solid.

Explodes= What liquids the solid explodes in.

[Walnut Wood] Required header line.

Solid=Walnut Wood The name of the solid.

Density=0.593 The density of the solid (g/mL).

Color=Walnut Wood The color of the solid.

Explodes= What liquids the solid explodes in.

[Zinc] Required header line.

Solid=Zinc The name of the solid.

Density=7.140 The density of the solid (g/mL).

Color=Zinc The color of the solid.

Explodes= What liquids the solid explodes in.

[Virtual Solid A] Required header line.

Solid=Virtual Solid A The name of the solid.

Density=.312 The density of the solid (g/mL).

Page 151: Instructor utilities guide

A-80

Color=Virtual Yellow The color of the solid.

Explodes= What liquids the solid explodes in.

[Virtual Solid B] Required header line.

Solid=Virtual Solid B The name of the solid.

Density=5.362 The density of the solid (g/mL).

Color=Virtual Red The color of the solid.

Explodes= What liquids the solid explodes in.

[Virtual Solid C] Required header line.

Solid= Virtual Solid C The name of the solid.

Density=14.895 The density of the solid (g/mL).

Color=Virtual Blue The color of the solid.

Explodes= What liquids the solid explodes in.

[Virtual Solid D] Required header line.

Solid=Virtual Solid D The name of the solid.

Density=10 The density of the solid (g/mL).

Color=Virtual Black The color of the solid.

Explodes= What liquids the solid explodes in.

Colors.ini INI Variables Description [Red] Required header line.

color=Bromine The name for red in this program is Bromine.

[Clear] Required header line

color=clear The name for clear in this program is clear

[Dark Yellow] Required header line

color=CornSyrup The name for dark yellow in this program is CornSyrup.

[Purple] Required header line

color=GrapeSoda The name for purple in this program is GrapeSoda

[Brown] Required header line

Color=MapleSyrup The name for brown in this program is MapleSyrup.

[Honey] Required header line

Color=Honey The name for honey in this program is Honey.

[Silver] Required header line

Color=Mercury The name for silver in this program is Mercury.

[White] Required header line

Color=Milk The name for white in this program is Milk.

Page 152: Instructor utilities guide

A-81

[Dark Brown] Required header line

Color=MotorOil The name for dark brown in this program is MotorOil.

[Yellow] Required header line

Color=OliveOil The name for yellow in this program is OliveOil.

[Black] Required header line

Color=Tar The name for black in this program is tar.

[ClearRed] Required header line

Mix=yes This color is a mix of 2 already listed colors.

Color=Bromine Color one from above in the mix.

Color2=Clear Color two from above in the mix

Color2Blend=20 Percent of the second color that makes up the mix.

[DarkBrownRed] Required header line

Mix=yes This color is a mix of 2 already listed colors.

Color=Bromine Color one from above in the mix.

Color2=MotorOil Color two from above in the mix

Color2Blend=50 Percent of the second color that makes up the mix.

[BrownRed] Required header line

Mix=yes This color is a mix of 2 already listed colors.

Color=Bromine Color one from above in the mix.

Color2=MapleSyrup Color two from above in the mix

Color2Blend=50 Percent of the second color that makes up the mix.

[RedWhite] Required header line

Mix=yes This color is a mix of 2 already listed colors.

Color=Bromine Color one from above in the mix.

Color2=Milk Color two from above in the mix

Color2Blend=30 Percent of the second color that makes up the mix.

[RedPurple] Required header line

Mix=yes This color is a mix of 2 already listed colors.

Color=Bromine Color one from above in the mix.

Color2=GrapeSoda Color two from above in the mix

Color2Blend=50 Percent of the second color that makes up the mix.

[ClearDarkBrown] Required header line

Mix=yes This color is a mix of 2 already listed colors.

Color=MotorOil Color one from above in the mix.

Color2=Clear Color two from above in the mix

Color2Blend=20 Percent of the second color that makes up the mix.

[YellowDarkBrown] Required header line

Mix=yes This color is a mix of 2 already listed colors.

Color=MotorOil Color one from above in the mix.

Page 153: Instructor utilities guide

A-82

Color2=OliveOil Color two from above in the mix

Color2Blend=30 Percent of the second color that makes up the mix.

[ClearBrown] Required header line

Mix=yes This color is a mix of 2 already listed colors.

Color=MapleSyrup Color one from above in the mix.

Color2=Clear Color two from above in the mix

Color2Blend=20 Percent of the second color that makes up the mix.

[ClearWhite] Required header line

Mix=yes This color is a mix of 2 already listed colors.

Color=Milk Color one from above in the mix.

Color2=Clear Color two from above in the mix

Color2Blend=20 Percent of the second color that makes up the mix.

[ClearYellow] Required header line

Mix=yes This color is a mix of 2 already listed colors.

Color=OliveOil Color one from above in the mix.

Color2=Clear Color two from above in the mix

Color2Blend=20 Percent of the second color that makes up the mix.

[ClearPurple] Required header line

Mix=yes This color is a mix of 2 already listed colors.

Color=GrapeSoda Color one from above in the mix.

Color2=Clear Color two from above in the mix

Color2Blend=20 Percent of the second color that makes up the mix.

[PurpleWhite] Required header line

Mix=yes This color is a mix of 2 already listed colors.

Color=GrapeSoda Color one from above in the mix.

Color2=Milk Color two from above in the mix

Color2Blend=40 Percent of the second color that makes up the mix.

[BrownPurple] Required header line

Mix=yes This color is a mix of 2 already listed colors.

Color=MapleSyrup Color one from above in the mix.

Color2=GrapeSoda Color two from above in the mix

Color2Blend=30 Percent of the second color that makes up the mix.

[RedYellow] Required header line

Mix=yes This color is a mix of 2 already listed colors.

Color=Bromine Color one from above in the mix.

Color2=OliveOil Color two from above in the mix

Color2Blend=30 Percent of the second color that makes up the mix.

[BrownWhite] Required header line

Mix=Yes This color is a mix of 2 already listed colors.

Color=MapleSyrup Color one from above in the mix.

Page 154: Instructor utilities guide

A-83

color2=Milk Color two from above in the mix

Color2Blend=35 Percent of the second color that makes up the mix.

[YellowBrown] Required header line

Mix=yes This color is a mix of 2 already listed colors.

Color=CornSyrup Color one from above in the mix.

Color2=MotorOil Color two from above in the mix

Color2Blend=50 Percent of the second color that makes up the mix.

Fluids.ini INI Variables Description

[Acetone] Required header line.

Solid=Acetone The name of the fluid.

Density=0.78458 The density of the fluid (g/mL).

Viscosity=.000306 The viscosity of the fluid.

Miscible=Alcohol, Ammonia, Bromine, Car Oil, Ethanol, Gasoline, Glycerol, Jet Fuel, Maple Syrup, Milk, Olive Oil, Phenolphthalein, Sea Water, Soda, Turpentine, Water

The fluids that the fluid in question is miscible with.

Color=clear The color of the fluid.

MixColor= clear, clear, clearred, cleardarkbrown, clear, clear, clear, clear, clearbrown, clearwhite, clearyellow, clear, clear, clearpurple, clear, clear

The color of the mixed fluid in the same order as miscibility.

[Alcohol] Required header line.

Fluid= Alcohol The name of the fluid.

Density=.78651 The density of the fluid (g/mL).

Viscosity=.000544 The viscosity of the fluid.

Miscible= Acetone, Ammonia, Bromine, Car Oil, Ethanol, Gasoline, Glycerol, Jet Fuel, Maple Syrup, Milk, Olive Oil, Phenolphthalein, Sea Water, Soda, Turpentine, Water

The fluids that the fluid in question is miscible with.

Color=clear The color of the fluid.

MixColor= clear, clear, clearred, cleardarkbrown, clear, clear, clear, clear, clearbrown, clearwhite, clearyellow, clear, clear, clearpurple, clear, clear

The color of the mixed fluid in the same order as miscibility.

[Ammonia] Required header line.

Fluid= Ammonia The name of the fluid.

Density=.82335 The density of the fluid (g/mL).

Viscosity=.00000982 The viscosity of the fluid.

Bromine, Car Oil, Ethanol, Gasoline, Glycerol, Jet Fuel, Maple Syrup, Milk, Olive Oil, Phenolphthalein, Sea Water, Soda, Turpentine, Water

The fluids that the fluid in question is miscible with.

Color=clear The color of the fluid.

MixColor= clear, clear, clearred, cleardarkbrown, clear,clear, clear, clear,

The color of the mixed fluid in the same order as miscibility.

Page 155: Instructor utilities guide

A-84

clearbrown, clearwhite, clearyellow, clear, clear, clearbrown, clear, clear

[Bromine] Required header line.

Fluid= Bromine The name of the fluid.

Density=3.1028 The density of the fluid (g/mL).

Viscosity=.00095 The viscosity of the fluid.

Miscible= Acetone, Alcohol, Ammonia, Car Oil, Ethanol, Gasoline, Glycerol, Jet Fuel, Maple Syrup, Milk, Olive Oil, Phenolphthalein, Sea Water, Soda, Turpentine, Water

The fluids that the fluid in question is miscible with.

Color=Red The color of the fluid.

MixColor=clearred, clearred, clearred, darkbrownred, clearred, clearred, clearred, clearred, brownred, redwhite, redyellow, clearred, clearred, redpurple, clearred, clearred

The color of the mixed fluid in the same order as miscibility.

[Car Oil] Required header line.

Fluid= Car Oil The name of the fluid.

Density=.8913 The density of the fluid (g/mL).

Viscosity=.0318 The viscosity of the fluid.

Miscible= Acetone, Alcohol, Ammonia, Bromine, Ethanol, Gasoline, Glycerol, Jet Fuel, Olive Oil, Phenolphthalein, Turpentine

The fluids that the fluid in question is miscible with.

Color=Dark Brown The color of the fluid.

MixColor=cleardarkbrown, cleardarkbrown, cleardarkbrown, darkbrownred, cleardarkbrown, cleardarkbrown, cleardarkbrown, cleardarkbrown, yellowdarkbrown, cleardarkbrown, cleardarkbrown

The color of the mixed fluid in the same order as miscibility.

[Corn Syrup] Required header line.

Fluid= Corn Syrup The name of the fluid.

Density=1.38 The density of the fluid (g/mL).

Viscosity=7 The viscosity of the fluid.

Miscible= The fluids that the fluid in question is miscible with.

Color=Dark Yellow The color of the fluid.

MixColor= The color of the mixed fluid in the same order as miscibility.

[Ethanol] Required header line.

Fluid= Ethanol The name of the fluid.

Density=.57026 The density of the fluid (g/mL).

Viscosity=.00107 The viscosity of the fluid.

Miscible= Acetone, Alcohol, Ammonia, Bromine, Car Oil, Gasoline, Glycerol, Jet Fuel, Maple Syrup, Milk, Olive Oil, Phenolphthalein, Sea Water, Soda, Turpentine, Water

The fluids that the fluid in question is miscible with.

Color= clear The color of the fluid.

MixColor= clear, clear, clear, clearred, The color of the mixed fluid in the same order as miscibility.

Page 156: Instructor utilities guide

A-85

cleardarkbrown, clear, clear, clear, clearbrown, clearwhite, clearyellow, clear, clear, clearpurple, clear, clear

[Gasoline] Required header line.

Fluid= Gasoline The name of the fluid.

Density=.73722 The density of the fluid (g/mL).

Viscosity=.000748 The viscosity of the fluid.

Miscible= Acetone, Alcohol, Ammonia, Bromine, Car Oil, Ethanol, Glycerol, Jet Fuel, Olive Oil, Phenolphthalein, Turpentine

The fluids that the fluid in question is miscible with.

Color= clear The color of the fluid.

MixColor= clear, clear, clear, clearred, cleardarkbrown, clear, clear, clear, clearyellow, clear, clear

The color of the mixed fluid in the same order as miscibility.

[Glycerol] Required header line.

Fluid= Glycerol The name of the fluid.

Density=1.25937 The density of the fluid (g/mL).

Viscosity=.934 The viscosity of the fluid.

Miscible= Acetone, Alcohol, Ammonia, Bromine, Car Oil, Ethanol, Gasoline, Jet Fuel, Maple Syrup, Milk, Olive Oil, Phenolphthalein, Sea Water, Soda, Turpentine, Water

The fluids that the fluid in question is miscible with.

Color=clear The color of the fluid.

MixColor= clear, clear, clear, clearred, cleardarkbrown, clear, clear, clear, clearbrown, clearwhite, clearyellow, clear, clear, clearpurple, clear, clear

The color of the mixed fluid in the same order as miscibility.

[Honey] Required header line.

Fluid= Honey The name of the fluid.

Density=1.45 The density of the fluid (g/mL).

Viscosity=14 The viscosity of the fluid.

Miscible= The fluids that the fluid in question is miscible with.

Color=Honey The color of the fluid.

MixColor= The color of the mixed fluid in the same order as miscibility.

[Jet Fuel] Required header line.

Fluid= Jet Fuel The name of the fluid.

Density=.81715 The density of the fluid (g/mL).

Viscosity=.002214 The viscosity of the fluid.

Miscible= Acetone, Alcohol, Ammonia, Bromine, Car Oil, Ethanol, Gasoline, Glycerol, Olive Oil, Phenolphthalein, Turpentine

The fluids that the fluid in question is miscible with.

Color= clear The color of the fluid.

MixColor= clear, clear, clear, clearred, cleardarkbrown, clear, clear, clear, clearyellow, clear, clear

The color of the mixed fluid in the same order as miscibility.

[Maple Syrup] Required header line.

Page 157: Instructor utilities guide

A-86

Fluid= Maple Syrup The name of the fluid.

Density=.982 The density of the fluid (g/mL).

Viscosity=3.2 The viscosity of the fluid.

Miscible= Acetone, Alcohol, Ammonia, Bromine, Ethanol, Glycerol, Milk, Phenolphthalein, Sea Water, Soda, Water

The fluids that the fluid in question is miscible with.

Color=brown The color of the fluid.

MixColor= clearbrown, clearbrown, clearbrown, brownred, clearbrown, clearbrown, brownwhite, clearbrown, clearbrown, brownpurple, clearbrown

The color of the mixed fluid in the same order as miscibility.

[Mercury] Required header line.

Fluid= Mercury The name of the fluid.

Density=13.57 The density of the fluid (g/mL).

Viscosity=.00153 The viscosity of the fluid.

Miscible= The fluids that the fluid in question is miscible with.

Color=silver The color of the fluid.

MixColor= The color of the mixed fluid in the same order as miscibility.

[Milk] Required header line.

Fluid= Milk The name of the fluid.

Density=1.02 The density of the fluid (g/mL).

Viscosity=.00256 The viscosity of the fluid.

Miscible= Acetone, Alcohol, Ammonia, Bromine, Ethanol, Glycerol, Maple Syrup, Phenolphthalein, Sea Water, Soda, Water

The fluids that the fluid in question is miscible with.

Color=white The color of the fluid.

MixColor= clearwhite, clearwhite, clearwhite, redwhite, clearwhite, clearwhite, brownwhite, clearwhite, clearwhite, purplewhite, clearwhite

The color of the mixed fluid in the same order as miscibility.

[Olive Oil] Required header line.

Fluid= Olive Oil The name of the fluid.

Density=.895 The density of the fluid (g/mL).

Viscosity=.081 The viscosity of the fluid.

Miscible= Acetone, Alcohol, Ammonia, Bromine, Car Oil, Ethanol, Gasoline, Glycerol, Jet Fuel, Phenolphthalein, Turpentine

The fluids that the fluid in question is miscible with.

Color=yellow The color of the fluid.

MixColor= clearyellow, clearyellow, clearyellow, redyellow, yellowdarkbrown, clearyellow, clearyellow, clearyellow, clearyellow, clearyellow, clearyellow

The color of the mixed fluid in the same order as miscibility.

[Phenolphthalein] Required header line.

Fluid= Phenolphthalein The name of the fluid.

Density=.81215 The density of the fluid (g/mL).

Viscosity=.000475 The viscosity of the fluid.

Ammonia, Bromine, Car Oil, Ethanol, Gasoline, Glycerol, Jet Fuel, Maple Syrup,

The fluids that the fluid in question is miscible with.

Page 158: Instructor utilities guide

A-87

Milk, Olive Oil, Sea Water, Soda, Turpentine, Water

Color= clear The color of the fluid.

MixColor= clear, clear, clear, clearred, cleardarkbrown, clear, clear, clear, clear, clearbrown, clearwhite, clearyellow, clear, clearpurple, clear, clear

The color of the mixed fluid in the same order as miscibility.

[Sea Water] Required header line.

Fluid=Sea Water The name of the fluid.

Density=1.025 The density of the fluid (g/mL).

Viscosity=.00165 The viscosity of the fluid.

Miscible= Acetone, Alcohol, Ammonia, Bromine, Ethanol, Glycerol, Maple Syrup, Milk, Phenolphthalein, Soda, Water

The fluids that the fluid in question is miscible with.

Color= clear The color of the fluid.

MixColor= clear,clear, clear, clearred, clear, clear, clearbrown, clearwhite, clear, clearpurple, clear

The color of the mixed fluid in the same order as miscibility.

[Soda] Required header line.

Fluid= Soda The name of the fluid.

Density=.94 The density of the fluid (g/mL).

Viscosity=.00102 The viscosity of the fluid.

Miscible= Acetone, Alcohol, Ammonia, Bromine, Ethanol, Glycerol, Maple Syrup, Milk, Phenolphthalein, Sea Water, Water

The fluids that the fluid in question is miscible with.

Color=Purple The color of the fluid.

MixColor= clearpurple, clearpurple, clearpurple, redpurple, clearpurple, clearpurple, brownpurple, purplewhite, clearpurple, clearpurple, clearpurple

The color of the mixed fluid in the same order as miscibility.

[Tar] Required header line.

Fluid= Tar The name of the fluid.

Density=1.153 The density of the fluid (g/mL).

Viscosity=100 The viscosity of the fluid.

Miscible= The fluids that the fluid in question is miscible with.

Color=black The color of the fluid.

MixColor= The color of the mixed fluid in the same order as miscibility.

[Turpentine] Required header line.

Fluid= Turpentine The name of the fluid.

Density=.86807 The density of the fluid (g/mL).

Viscosity=0.001 The viscosity of the fluid.

Miscible= Acetone, Alcohol, Ammonia, Bromine, Car Oil, Ethanol, Gasoline, Glycerol, Jet Fuel, Olive Oil, Phenolphthalein

The fluids that the fluid in question is miscible with.

Color= clear The color of the fluid.

MixColor= clear, clear, clear, clearred, cleardarkbrown, clear, clear, clear, clear,

The color of the mixed fluid in the same order as miscibility.

Page 159: Instructor utilities guide

A-88

clearyellow, clear

[Water] Required header line.

Fluid= Water The name of the fluid.

Density=.99997 The density of the fluid (g/mL).

Viscosity=.001 The viscosity of the fluid.

Miscible= Acetone, Alcohol, Ammonia, Bromine, Ethanol, Glycerol, Maple Syrup, Milk, Phenolphthalein, Sea Water, Soda

The fluids that the fluid in question is miscible with.

Color= clear The color of the fluid.

MixColor= clear, clear, clear, clearred, clear, clear, clearbrown, clearwhite, clear, clear, clearpurple

The color of the mixed fluid in the same order as miscibility.

[Virtual Fluid A] Required header line.

Fluid= Virtual Fluid A The name of the fluid.

Density=0.1354 The density of the fluid (g/mL).

Viscosity=2.54 The viscosity of the fluid.

Miscible= The fluids that the fluid in question is miscible with.

Color=Red The color of the fluid.

MixColor= The color of the mixed fluid in the same order as miscibility.

[Virtual Fluid B] Required header line.

Fluid= Virtual Fluid B The name of the fluid.

Density=0.2356 The density of the fluid (g/mL).

Viscosity=5 The viscosity of the fluid.

Miscible= The fluids that the fluid in question is miscible with.

Color=purple The color of the fluid.

MixColor= The color of the mixed fluid in the same order as miscibility.

[Virtual Fluid C] Required header line.

Fluid= Virtual Fluid C The name of the fluid.

Density=2.23 The density of the fluid (g/mL).

Viscosity=10 The viscosity of the fluid.

Miscible= The fluids that the fluid in question is miscible with.

Color=Dark Yellow The color of the fluid.

MixColor= The color of the mixed fluid in the same order as miscibility.

[Virtual Fluid D] Required header line.

Fluid= Virtual Fluid D The name of the fluid.

Density=8.456 The density of the fluid (g/mL).

Viscosity=50 The viscosity of the fluid.

Miscible= The fluids that the fluid in question is miscible with.

Color=Black The color of the fluid.

MixColor= The color of the mixed fluid in the same order as miscibility.

Page 160: Instructor utilities guide

A-89

Preset Experiments Located on the clipboard in the density laboratory is a set of 15 preset experiments listed by title.

If allowed by the instructor, students can select one of these experiments and, upon returning to

the laboratory, the selected experiment will be automatically set up and running. Preset

experiments are intended to provide flexibility for the instructor so the density simulation can be

adapted to the level of the class or the individual teaching style of the instructor. Several

experiments have already been defined and are installed with the software. This section describes

how these files can be modified.

Each preset experiment is defined using an INI file. For the preset experiments on the clipboard,

these files have the name Experimentn.ini, where n is a number between 1 and 15 and represents

experiments 1 through 15 on the clipboard. These files are located in the Presets directory in the

PhysicsD directory. Note that in client installations, any modified preset experiments for the

clipboard must be modified for each client installation.

Given subsequently is a description of a preset experiment INI file and the variables that are used

to define an experiment. Before reviewing the INI file information, here are some important

points to keep in mind: (a) All of the variables described have default values, so variables may be

left blank or not used at all. An experiment can be set up or defined to any degree desired by the

instructor. (b) Some variables are mutually exclusive; that is, the use of one variable may mean

another variable cannot be used. Some error checking exists for such situations, but the error

checking is not comprehensive.

The following two tables show the INI variables used in preset experiments. The first lists all the

variables that can be used and their allowed values. Default values are given in red. The second

is an example of a preset experiment for a simple density experiment to show how the variables

can be used.

Complete Preset Experiment INI Variable List

INI Variables Description [Title] Title=Test Preset Sets the title of the experiment as shown on the clipboard. Not used for preset

electronic assignments. [Cylinder1] BallType=Real, virtual (Default = no ball) Defines whether the ball in cylinder 1 will be Real or Virtual - this is a required

item for the ball to be used. BallKnown=no, yes (Default = yes) Sets whether the student will know what the ball is. BallRadius=.01 (Default=random size will be created)

Defines the radius of the ball in cylinder 1. It must be within the set max/min values for ball radius.

BallName=Aluminum Defines the name of the ball and will be shown if the ball is known, but even if the ball is unknown this is a required item. If the ball is Real, the name must match an already exiting ball in the solids.ini file. If the ball is Virtual, the name can be whatever you want

BallDensity=.5 If the ball is virtual the ball density is required. This defines the density of the virtual ball in g/mL.

BallColor=clear This defines the ball color of virtual balls. This value must match a color value in the solids.ini.

Fluid1Type=Virtual, Real (Default = no This is a required field and defines whether or not the fluid is real or virtual.

Page 161: Instructor utilities guide

A-90

fluid) Fluid1Known=yes, no (Default = yes)

Sets whether the student will know what the fluid is.

Fluid1Amount=half, full Defines the amount of fluid 1 in cylinder 1. A random value around full or half will be used.

Fluid1Name=Corn Syrup Defies the name of the fluid that will be shown if the fluid is known. If the fluid is real it must be from the pre-existing fluids.ini file, but if it is virtual it can be whatever you want.

Fliud1Density=1.1 Defines the density for virtual fluids in g/ml. Fluid1Viscosity=.003 (Default = a random value between the min/max will be selected)

Defines the viscosity for virtual fluids.

Fluid1Color=red Defines the color for virtual fluids, and the color must match a value color in the colors.ini file.

Fluid2Type=Virtual, real (Default = no fluid) If fluid 1 if full, or there is no fluid 1 then fluid 2 is ignored. This defines whether fluid 2 will be real or virtual.

Fluid2Known=yes, no Sets whether the student will know what the fluid is. Fluid2Name=Corn Syrup Defines the name of fluid 2 if it is real, real the name must match one from the

fluids.ini file. Fluid2VName=Virtual Fluid If the fluid is virtual this defines the name of the virtual fluid. Fliud2Density=1.1 This defines the density of the virtual fluid in g/ml. Fluid2Viscosity=.003 (Default = a random value between the min/max will be selected)

Defines the viscosity for virtual fluids.

Fluid2Color=clear Defines the color for virtual fluids, and the color must match a value color in the colors.ini file.

[Cylinder2] Uses all the same variables as outlined under [Cylinder1]. [Cylinder3] Uses all the same variables as outlined under [Cylinder1]. [Cylinder4] Uses all the same variables as outlined under [Cylinder1]. . [Cylinder5] Uses all the same variables as outlined under [Cylinder1]. [Balance] OnOff=on, off (Default=on) Sets whether or not the balance is on or not. tare=0.0 (default = 0.0) Defines value to set the tare value to. Object=ball, beaker (Default = no object) Defines what object is on the balance BallType=Real Defines whether the ball in cylinder 1 will be Real or Virtual - this is a required

item for the ball to be used. BallKnown=no, yes (Default = yes) Sets whether the student will know what the ball is. BallRadius=.01 (Default=random size will be created)

Defines the radius of the ball in cylinder 1. It must be within the set max/min values for ball radius.

BallName=Aluminum Defines the name of the ball and will be shown if the ball is known, but even if the ball is unknown this is a required item. If the ball is Real, the name must match an already exiting ball in the solids.ini file. If the ball is Virtual, the name can be whatever you want

BallDensity=.5 If the ball is virtual the ball density is required. This defines the density of the virtual ball in g/mL.

BallColor=clear This defines the ball color of virtual balls. This value must match a color value in the solids.ini.

[Beaker] The position of the beaker is set in the Balance section. If it is not put on the

balance it is put on the table.

Page 162: Instructor utilities guide

A-91

Fluid1Type=Virtual, Real (Default = no fluid)

This is a required field and defines whether or not the fluid is real or virtual.

Fluid1Known=yes, no (Default = yes)

Sets whether the student will know what the fluid is.

Fluid1Amount=half, full Defines the amount of fluid 1 in the beaker. A random value around full or half will be used.

Fluid1Name=Corn Syrup Defies the name of the fluid that will be shown if the fluid is known. If the fluid is real it must be from the pre-existing fluids.ini file, but if it is virtual it can be whatever you want.

Fliud1Density=1.1 Defines the density for virtual fluids in g/ml. Fluid1Viscosity=.003 (Default = a random value between the min/max will be selected)

Defines the viscosity for virtual fluids.

Fluid1Color=red Defines the color for virtual fluids, and the color must match a value color in the colors.ini file.

Fluid2Type=Virtual, real (Default = no fluid) If fluid 1 if full, or there is no fluid 1 then fluid 2 is ignored. This defines whether fluid 2 will be real or virtual.

Fluid2Known=yes, no Sets whether the student will know what the fluid is. Fluid2Name=Corn Syrup Defines the name of fluid 2 if it is real, real the name must match one from the

fluids.ini file. Fluid2VName=Virtual Fluid If the fluid is virtual this defines the name of the virtual fluid. Fliud2Density=1.1 This defines the density of the virtual fluid in g/ml. Fluid2Viscosity=.003 (Default = a random value between the min/max will be selected)

Defines the viscosity for virtual fluids.

Fluid2Color=clear Defines the color for virtual fluids, and the color must match a value color in the colors.ini file.

An Example Density Preset Experiment

INI Variables Description [Title] Title=Ice in Alcohol or Water Defines the title of the experiment as shown on the clipboard. Not used for

preset assignments. [Cylinder1] BallType=Real Defines the ball type as a real ball. BallKnown=yes Allows the student to see the type of ball. BallName=Ice Defines which real ball from the solid.ini file is used. Fluid1Type=Real Defines the fluid as a real fluid. Fluid1Known=yes Allows the student to see the type of fluid. Fluid1Amount=full The cylinder will be full to a random value near full. Fluid1Name=Alcohol Defines which real fluid from the fluid.ini file is used. [Cylinder2] BallType=Real Defines the ball type as a real ball. BallKnown=yes Allows the student to see the type of ball. BallName=Ice Defines which real ball from the solid.ini file is used. Fluid1Type=Real Defines the fluid as a real fluid. Fluid1Known=yes Allows the student to see the type of fluid. Fluid1Amount=full The cylinder will be full to a random value near full. Fluid1Name=Water Defines which real fluid from the fluid.ini file is used.

Page 163: Instructor utilities guide

A-92

Circuits INI File

The circuits laboratory gives students the ability to build simple or complex circuits using

resistors, capacitors, inductors, and light bulbs and analyze these circuits using a Digital

Multimeter (DMM) or oscilloscope. A significant fraction of the simulation is controlled by the

Circuits.ini file where initial values for components are specified, variables affecting the Laplace

transformation are defined, as well as many other variables. There is also an additional set of INI

files and these define the preset experiments located on the clipboard and used in the circuits

assignments. Described in each of the following sections are the INI variables contained in each

of these INI files. The purpose for providing this information is to grant instructors the ability to

change or adjust the circuits simulation to suit their own needs.

Circuits.ini INI Variables Description [General] AccelerationValues=0.001, 0.005, 0.01, 0.05, 0.1, 0.5, 1, 5, 10

These are the allowed acceleration values for displaying data on the oscilloscope.

AccelerationDefault=1 The default acceleration value the program will use. MaxComponents=20 The maximum number of components that can be used in a circuit. ShowErrors=no Solving a circuit using Laplace transforms is complex and occasionally

the algorithm fails. This variable specifies whether these errors should be shown.

[Meters] OscilloscopeRefresh_mSec=50 How often to update data on the oscilloscope. MultiMeterRefresh_RMS_mSec=250 How often to update RMS measurements on the DMM. MultiMeterRefresh_mSec=100 How often to update DC measurements on the DMM. MultiMeterOhmMax=2000000 The maximum resistance before an overload is displayed on the DMM. [RMS] MultiMeter_RMS_SamplesPerPeriod=30 How many data points to use per period to calculate the RMS values. MultiMeter_RMS_MaxPeriods=20 How many periods to use to calculate the RMS values. Power_RMS_SamplesPerPeriod=30 Same for power measurements here and below. Power_RMS_MaxPeriods=20 RMS_Threshold_Hz=3 The lowest frequency before RMS values are no longer calculated. [PowerSources] VoltagePeak=1.0 The initial default voltage amplitude for the function generator. VoltagePeakMax=1000.0 The maximum amplitude that can be selected. VoltagePeakMin=0.1 The minimum amplitude that can be selected. Frequency=60 The initial default frequency. FrequencyMax=1000000 The maximum frequency. FrequencyMin=.001 The minimum frequency. DC_Frequency=10000 DC experiments are really AC calculations. This is a dummy frequency

to use. SquareWaveTerms=10 The powerseries terms to use for a square wave. SawWaveTerms=10 The powerseries terms to use for a saw tooth wave form. [Resistors] Resistance=100 The initial resistance to use for a resistor.

Page 164: Instructor utilities guide

A-93

ResistanceLarge=1000 The initial resistance to use for a large resistor on the breadboard. ResistanceMin=1 The smallest resistance available. ResistanceMax=1000000 The largest resistance available. Tolerance=.0025 The initial tolerance or uncertainty in the assigned value for the

resistance. 0.0025 means 0.25%. BurnOutCheck_mSec=500 How often to check to see if the power has exceeded the power rating. P_BurnOut_Watts=5.0 The default resistor power rating. p_BurnOut_Watts_Min=0.25 The minimum power rating. P_BurnOut_Watts_Max=100 The maximum power rating. BurnOutTime_Sec=5 The time in seconds the power rating must be exceeded before burning

out. [Capacitors] Capacitance=1e-6 The initial capacitance to use for a capacitor. CapacitanceLarge=5e-2 The initial capacitance to use for a large capacitor on the breadboard. CapacitanceMin=1e-10 The smallest capacitance available. CapacitanceMax=10 The largest capacitance available. Tolerance=.0025 The initial tolerance or uncertainty in the assigned value for the

capacitance. 0.0025 means 0.25%. [Inductors] Inductance=1e-3 The initial inductance to use for an inductor. InductanceLarge=1.0 The initial inductance to use for a large inductor on the breadboard. InductanceMin=1e-8 The smallest inductance available. InductanceMax=10 The largest inductance available. Tolerance=.0025 The initial tolerance or uncertainty in the assigned value for the

inductance. 0.0025 means 0.25%. [Wires] ResistanceMin=.000001 The minimum randomly assigned resistance for a wire. ResistanceMax=.0001 The maximum randomly assigned resistance for a wire. [Bulbs] Watts=60 The initial wattage to use for a light bulb. WattsMin=10 The smallest wattage light bulb available. WattsMax=100 The largest wattage light bulb available. IlluminationCheck_mSec=100 How often to check for a change in illumination of the light bulb. BurnOutPowerPercentage=1.1 How far to exceed the specified wattage before the light bulb burns. MaxBrightnessWatts=110 The wattage for the brightest light bulb graphic. Voltage=84.78 The RMS voltage to convert the selected wattage into resistance. BurnOutTime_Sec=5 The time in seconds the power rating must be exceeded before burning

out. Brightness_Exponential=.75 The brightness exponential to make the illumination curve non-linear. [Misc] MultiplicityTolerance=.001 When the percent difference between two roots is smaller than this

value, then the roots are considered to have the same multiplicity.

Preset Experiments Located on the clipboard in the circuits laboratory is a set of 15 preset experiments listed by title.

If allowed by the instructor, students can select one of these experiments and, upon returning to

the laboratory, the selected experiment will be automatically set up and running. Preset

experiments are intended to provide flexibility for the instructor so the circuits simulation can be

adapted to the level of the class or the individual teaching style of the instructor. Several

Page 165: Instructor utilities guide

A-94

experiments have already been defined and are installed with the software. This section describes

how these preset files can be created.

Each preset experiment is defined using an INI file. For the preset experiments on the clipboard,

these files have the name Experimentn.ini, where n is a number between 1 and 15 and represents

experiments 1 through 15 on the clipboard. These files are located in the Presets directory in the

PhysicsC directory. Note that in client installations, any modified preset experiments for the

clipboard must be modified for each client installation.

Unlike the other simulations, creating preset experiments is relatively easy in the circuits

simulation. Instead of creating the preset files by hand, all that is needed is to create or setup the

experiment in the circuit laboratory and then save the experiment as a preset. A preset is saved

by right-clicking with the mouse on a hidden button located in the extreme upper left-hand

corner of the laboratory. These preset files can be modified by hand if needed and component

values can be changed to unknown as well. Once a preset file has been saved, the preset

language is largely self-explanatory.

Optics INI File

The optics laboratory gives students the ability explore and understand the concepts of lenses,

mirrors, prisms, and color inside an easy to use virtual laboratory. A significant fraction of the

simulation is controlled by the Optics.ini file where initial values for components are specified,

variables affecting the simulation are defined, as well as other variables. There is also an

additional set of INI files and these define the preset experiments located on the clipboard and

used in the optics assignments. Described in each of the following sections are the INI variables

contained in each of these INI files. The purpose for providing this information is to grant

instructors the ability to change or adjust the optics simulation to suit their own needs.

Optics.ini INI Variables Description [General] MirrorLensHeight_cm=7.62 The lens height. HoleSpacing_cm=5.08 The spacing between holes on the optics table (set at 2 inches). MaxTheta = 1.0 The maximum angle in radians a lens or mirror can “see” the light x2. MaxMirrorLensCount=15 The maximum number of mirrors or lenses that can be on the table. MaxBounceCount=50 The maximum number of bounces off the mirrors. ImageLines=on This turns the sight lines for the eye and objects on or off. [Laser] Wavelength=632 This sets the initial wavelength for the laser. (in nm) WaveLengthMin=400 This sets the minimum wavelength for the laser. WaveLengthMax=700 This sets the maximum wavelength for the laser. [Light] Light_Red=250 This sets the initial RGB values for the light bulb. A setting of 255 for

each color will make the line transparent. Light_Green=250 Light_Bue=250

Page 166: Instructor utilities guide

A-95

[Mirror] Radius=71 Sets the initial radius of curvature for the mirror. Anything over the

maximum assumes a flat mirror. (in cm) RadiusMin=4 Sets the minimum radius for the mirror. RadiusMax=70 This sets the maximum radius for the mirror. [Lens] Radius1=20 Sets the initial radius of curvature for the lens for side 1. Anything over

the maximum assumes a flat lens. (in cm). Radius1Min=4 Sets the minimum radius for the lens. Radius1Max=70 Sets the maximum radius for the lens. Radius2=-20 Sets the radius of curvature for side 2 of the lens. The negative sign

makes it convex compared to side 1. IndexRefraction=1.5 Sets the index of refraction for the lens material. IndexRefractionMin=0.1 Sets the minimum index of refraction. IndexRefractionmax=10 Sets the maximum index of refraction. DoubleThickness=0 Sets the initial thickness of the lens at the outside edge between face 1

and face2. DoubleThicknessMin=0.0 Sets the minimum thickness of the lens (in cm). DoublethicknessMax=1.0 Sets the maximum thickness of the lens (in cm). [Eye] AngleIncrement=5 The angle increment when rotating the eye in degrees. LaserBeamRadius=20 The radius of the laser beam when hitting the eye in pixels. LaserBeamTransparency=100 The transparency of the laser beam on the eye. Height=7.62 The size of the eye aperture in cm. BlurFudge=0.25 The degree of blurring for a maximally blurred image (0 to 1). BallNormalFactor=.5 The size of the nominal ball graphic relative to its base size (0 to 1). CandleNormalFactor=.5 The size of the nominal candle graphic relative to its base size (0 to 1). GnomeNormalFactor=.5 The size of the nominal gnome graphic relative to its base size (0 to 1). LaserNormalFactor=.5 The size of the nominal laser graphic relative to its base size (0 to 1). LightNormalFactor=.5 The size of the nominal light graphic relative to its base size (0 to 1). MaxTheta=0.5236 The widest angle (in radians) before an image will not enter the eye. [Filter] Red=0 Sets the red filter to be on or off (1=on, 0=off). Green=0 Sets the green filter to be on or off (1=on, 0=off). Blue=0 Sets the blue filter to be on or off (1=on, 0=off). [Beach Ball] Height=17.0 Sets the height of the beach ball in cm. [Gnome] Height = 7.62 Sets the height of the gnome in cm. [Candle] Height = 5.08 Sets the height of the candle in cm. [Slits] Increment_cm=.1 Sets the distance the slit curtain will move for each click of an arrow.

Page 167: Instructor utilities guide

A-96

Preset Experiments Located on the clipboard in the optics laboratory is a set of 15 preset experiments listed by title.

If allowed by the instructor, students can select one of these experiments and, upon returning to

the laboratory, the selected experiment will be automatically set up and running. Preset

experiments are intended to provide flexibility for the instructor so the optics simulation can be

adapted to the level of the class or the individual teaching style of the instructor. Several

experiments have already been defined and are installed with the software. This section describes

how these files can be modified.

Each preset experiment is defined using an INI file. For the preset experiments on the clipboard,

these files have the name Experimentn.ini, where n is a number between 1 and 15 and represents

experiments 1 through 15 on the clipboard. These files are located in the Presets directory in the

PhysicsO directory. Note that in client installations, any modified preset experiments for the

clipboard must be modified for each client installation.

Unlike the other simulations, creating preset experiments is relatively easy in the optics

simulation. Instead of creating the preset files by hand, all that is needed is to create or setup the

experiment in the optics laboratory and then save the experiment as a preset. A preset is saved by

right-clicking with the mouse on a hidden button located in the extreme upper left-hand corner of

the laboratory. These preset files can be modified by hand if needed, and once a preset file has

been saved, the preset language is largely self-explanatory.

Page 168: Instructor utilities guide

B-1

Appendix B

List of Organic Synthesis Assignments

A list of products that can be assigned for organic synthesis experiments for each named reaction.

Esterification

1.

Methyl acetate

2.

Ethyl acetate

3.

3-Methylbutyl acetate

4.

Methyl butanoate

5.

Ethyl butanoate

6.

3-Methylbutyl butanoate

7.

Methyl phenylacetate

8.

Ethyl-2-phenyl acetate

9.

3-Methylbutyl

phenylacetate

10.

Butanol

11.

2-Phenyl ethanol

12.

4-Nitrobenzeneacetic acid

13.

2-Nitrobenzeneacetic acid

14.

2,4-Dinitrophenylacetic

acid

15.

Formic acid

16.

3-Methyl butanoic acid

17.

Ethanal

18.

3-Methyl butanal

19.

1-Chloro-3-methylbutane

20.

2-Chloro-3-methylbutane

21.

Diisopentyl ether

22.

Benzoic acid

23.

Bromo-phenyl-acetic acid

Alcohol Halogenation

1.

Chlorocyclohexane

Page 169: Instructor utilities guide

B-2

2.

Chlorophenylmethane

3.

2-Chloro-2-methyl

propane

4.

1-Chloro-3-methylbutane

5.

2-Chloro-3-methylbutane

6.

3-Methyl butanoic acid

7.

3-Methyl butanal

8.

Benzoic acid

9.

Benzaldehyde

10.

Cyclohexanone

11.

Cyclohexene

12.

Diisopentyl ether

13.

Dibenzyl Ether

14.

1,1-Oxybis-cyclohexane

15.

Di-tert-butyl ether

16.

Benzyl ethyl ether

Alkyl Halide Solvolysis

1.

Benzyl alcohol

2.

2-Methyl-2-propanol

3.

exo-Bicyclo[2.2.1]

heptane-2-ol

4.

Tetrahydrofuran

5.

1,4-Butanediol

6.

1-Chloromethyl-4-nitro-

benzene

7.

1-Chloromethyl-2-nitro-

benzene

8.

1-Chloromethyl-2,4-

dinitro-benzene

9.

4-Nitro-benzyl alcohol

10.

2-Nitro-benzyl alcohol

11.

Benzyl ethyl ether

12.

Benzyl methyl ether

13.

2-methyl-2-ethoxy-

propane

Page 170: Instructor utilities guide

B-3

14.

1-Methoxy butane

15.

5-Ethoxybicyclo[2.2.1]

heptane

16.

Bicyclo[2.2.1]hept-2-ene

17.

Benzoic acid

18.

Bicyclo[2.2.1]

heptan-2-one

19.

4-Chloro-butanoic acid

20.

4-Chloro-butyraldehyde

21.

1,4-Dichlorobutane

22.

Butanol

23.

2-Benzyl-benzyl chloride

24.

4-Benzyl-benzyl chloride

25.

Benzyldiisopropylamine

26.

Butyldiisopropylamine

Alkene Hydration

1.

2-Hexanol

2.

1-Phenylethanol

3.

1-Methyl-cyclohexanol

4.

2,3-Dimethyl-2-butanol

5.

1-Hexanol

6.

3,3-Dimethyl-1-butanol

7.

2-Phenyl ethanol

8.

trans-2-methyl-

cyclohexanol

9.

Hexane-1,2-diol

10.

3,3-Dimethyl-1,2-butane

diol

11.

1-Phenyl-ethane-1,2-diol

12.

cis-1-Methyl-

cyclohexane-1,2-diol

13.

Ethyl 2-hexyl ether

14.

2-Ethoxy-2,3-dimethyl-

butane

15.

Ethyl-(1-phenyl-ethyl)-

ether

Page 171: Instructor utilities guide

B-4

16.

1-Ethoxy-1-methyl-

cyclohexane

17.

2-Chloro-hexane

18.

2-chloro-2,3-dimethyl

butane

19.

1-Chloro-1-phenylethane

20.

1-Chloro-1-methyl-

cyclohexane

21.

1,2-Dibromo-hexane

22.

1,2-Dibromo-3,3-

dimethyl-butane

23.

(1,2-Dibromoethyl)-

benzene

24.

1,2-Dibromo-1-methyl-

cyclohexane

25.

1-Bromo-2-hexanol

26.

1-Bromo-3,3-dimethyl-2-

butanol

27.

2-Bromo-1-phenyl-

ethanol

28.

2-Bromo-2-methyl-

cyclohexanol

29.

1-Bromo-2-ethoxy-

hexane

30.

Ethyl-(2-bromo-1-phenyl-

ethyl)-ether

31.

Pentanoic acid

32.

2,2-Dimethylpropanoic

acid

33.

Benzoic acid

34.

6-Oxo-heptanoic acid

35.

Formic acid

36.

1,2-Epoxyhexane

37.

3,3-Dimethyl-1,2-epoxy

butane

38.

1,2-Epoxyethylbenzene

39.

1-Methyl-1,2-

epoxycyclohexane

40.

4-Nitro-styrene

41.

2-Nitro-styrene

42.

1,3-Diphenyl-1-butene

Hydroboration

1.

2-Methyl-1-butanol

Page 172: Instructor utilities guide

B-5

2.

2-Methyl-3-pentanol

3.

4-Methyl-2-pentanol

4.

1-Hexanol

5.

trans-2-methyl-

cyclohexanol

6.

2-Methyl-2-butanol

7.

2-Methyl-2-pentanol

8.

2-Hexanol

9.

1-Methyl-cyclohexanol

10.

2-Ethoxy-2-methylbutane

11.

3-Ethoxy-2-methyl-

pentane

12.

Ethyl 2-hexyl ether

13.

1-Ethoxy-1-methyl-

cyclohexane

14.

2-Methyl-2-chlorobutane

15.

2-Chloro-2-

methylpentane

16.

2-Chloro-hexane

17.

1-Chloro-1-methyl-

cyclohexane

18.

1,2-Dibromo-2-methyl-

butane

19.

2,3-Dibromo-4-methyl-

pentane

20.

1,2-Dibromo-hexane

21.

trans-1,2-Dibromo-1-

methyl-cyclohexane

22.

1-Bromo-2-methyl-

butan-2-ol

23.

1-Bromo-2-hexanol

24.

trans-2-Bromo-2-methyl-

cyclohexanol

25.

1-Bromo-2-ethoxy-2-

methyl-butane

26.

1-Bromo-2-ethoxy-

hexane

27.

2-Methyl-butane-1,2-diol

28.

syn-4-Methyl-pentane-

2,3-diol

29.

Hexane-1,2-diol

Page 173: Instructor utilities guide

B-6

30.

cis-1-Methyl-

cyclohexane-1,2-diol

31.

1,2-Epoxy-2-methyl-

butane

32.

2,3-Epoxy-4-methyl-

pentane

33.

1,2-Epoxyhexane

34.

1-Methyl-1,2-

epoxycyclohexane

35.

2-Butanone

36.

2-Methyl-propionic acid

37.

Acetic acid

38.

Pentanoic acid

39.

6-Oxo-heptanoic acid

40.

Formic acid

41.

2-Methyl-2-pentene

Alkene Bromination

1.

1,2-Dibromo-hexane

2.

3,4-Dibromo-1-butene

3.

1,4-Dibromo-2-butene

4.

trans-2,3-Dibromo-butane

5.

(1R)-trans-1,2-Dibromo-

cyclohexane

6.

2-Hexanol

7.

3-Buten-1-ol

8.

2-Butanol

9.

1-Cyclohexanol

10.

1-Hexanol

11.

Ethyl 2-hexyl ether

12.

3-Ethoxy-1-butene

13.

1-Ethoxy-2-butene

14.

2-Ethoxy-butane

15.

Ethoxy-cyclohexane

16.

2-Chloro-hexane

Page 174: Instructor utilities guide

B-7

17.

3-Chloro-1-butene

18.

1-Chloro-2-butene

19.

2-Chloro-butane

20.

Chlorocyclohexane

21.

1-Bromo-2-hexanol

22.

anti-3-Bromo-butan-2-ol

23.

trans-2-Bromo-

cyclohexanol

24.

1-Bromo-2-ethoxy-

hexane

25.

4-Bromo-3-ethoxy-but-1-

ene

26.

anti-2-Bromo-3-ethoxy-

butane

27.

trans-1-Bromo-2-ethoxy-

cyclohexane

28.

Hexane-1,2-diol

29.

But-3-ene-1,2-diol

30.

syn-Butane-2,3-diol

31.

cis-Cyclohexane-1,2-diol

32.

1,2-Epoxyhexane

33.

3,4-Epoxy-but-1-ene

34.

2,3-Epoxy-butane

35.

1,2-Epoxy-cyclohexane

36.

Pentanoic acid

37.

2-Propenoic acid

38.

Acetic acid

39.

Hexanedioic acid

40.

Formic acid

Alkene Dihydroxylation

1.

2-Methyl-butane-1,2-diol

2.

Hexane-1,2-diol

3.

cis-Octahydro-

naphthalene-4a,8a-diol

4.

cis-Cyclohexane-1,2-diol

Page 175: Instructor utilities guide

B-8

5.

2-Methyl-2-butanol

6.

2-Hexanol

7.

Bicyclo[4.4.0]decane-1-ol

8.

1-Cyclohexanol

9.

2-Methyl-1-butanol

10.

1-Hexanol

11.

2-Ethoxy-2-methylbutane

12.

Ethyl 2-hexyl ether

13.

trans-9-Ethoxydecalin

14.

Ethoxy-cyclohexane

15.

2-Methyl-2-chlorobutane

16.

2-Chloro-hexane

17.

4a-Chloro-decahydro-

naphthalene

18.

Chlorocyclohexane

19.

1,2-Dibromo-2-methyl-

butane

20.

1,2-Dibromo-hexane

21.

4a,8a-Dibromo-

decahydro-naphthalene

22.

(1R)-trans-1,2-Dibromo-

cyclohexane

23.

1-Bromo-2-methyl-

butan-2-ol

24.

1-Bromo-2-hexanol

25.

9-Bromo-10-hydroxy-

trans-decalin

26.

trans-2-Bromo-

cyclohexanol

27.

1-Bromo-2-ethoxy-2-

methyl-butane

28.

1-Bromo-2-ethoxy-

hexane

29.

trans-1-Bromo-2-ethoxy-

cyclohexane

30.

1,2-Epoxy-2-methyl-

butane

31.

1,2-Epoxyhexane

32.

4a,8a-Epoxy-decahydro-

napthalene

Page 176: Instructor utilities guide

B-9

33.

1,2-Epoxy-cyclohexane

34.

2-Butanone

35.

Pentanoic acid

36.

Hexanedioic acid

37.

Cyclodecane-1,6-dione

38.

Formic acid

Epoxidation

1.

2,3-Epoxy-butane

2.

1,2-Epoxy-cyclohexane

3.

1,2-Dimethyl-1,2-epoxy-

cyclohex-4-ene

4.

2,3-Epoxy-cyclohexanol

5.

2-Butanol

6.

1-Cyclohexanol

7.

3,4-Dimethyl-cyclohex-3-

enol

8.

2-Ethoxy-butane

9.

Ethoxy-cyclohexane

10.

3-Ethoxy-cyclohexene

11.

2-Chloro-butane

12.

Chlorocyclohexane

13.

4-Chloro-1,2-dimethyl-

cyclohexene

14.

3-Chloro-cyclohexene

15.

trans-2,3-Dibromo-butane

16.

(1R)-trans-1,2-Dibromo-

cyclohexane

17.

4,5-Dibromo-4,5-

dimethyl-cyclohexene

18.

2,3-Dibromo-

cyclohexanol

19.

anti-3-Bromo-butan-2-ol

20.

trans-2-Bromo-

cyclohexanol

21.

2-Bromo-cyclohexane-

1,3-diol

22.

3-Bromo-cyclohexane-

1,2-diol

Page 177: Instructor utilities guide

B-10

23.

anti-2-Bromo-3-ethoxy-

butane

24.

trans-1-Bromo-2-ethoxy-

cyclohexane

25.

syn-Butane-2,3-diol

26.

cis-Cyclohexane-1,2-diol

27.

cis-4,5-Dimethyl-

cyclohex-4-ene-1,2-diol

28.

Cyclohexane-1,2,3-triol

29.

Acetic acid

30.

Hexanedioic acid

31.

Oct-4-ene-2,7-dione

32.

2-Cyclohexen-1-one

33.

Cyclohexa-1,3-diene

Diels Alder

1.

Cyclohex-3-enecarboxylic

acid methyl ester

2.

Cyclohexa-1,4-diene-1,2-

dicarboxylic acid

dimethyl ester

3.

4a,5,8,8a-Tetrahydro-

[1,4]naphthoquinone

4.

Bicyclo[2.2.1]hept-5-ene-

2-carboxylic acid methyl

ester

5.

Bicyclo[2.2.1]hepta-2,5-

diene-2,3-dicarboxylic

acid dimethyl ester

6.

1,4,4a,8a-Tetrahydro-1,4-

methano-naphthalene-5,8-

dione

7.

4-Oxo-cyclohex-2-ene

carboxylic acid methyl

ester

8.

4-Hydroxy-phthalic acid

dimethyl ester

9.

Naphthalene-1,4,6-triol

10.

3a,4,7,7a-Tetrahydro-4,7-

methano-indene

11.

5-Vinylbicyclo[2.2.1]

hept-2-ene

12.

Bicyclo[4.3.0]nona-3,7-

diene

13.

Cyclohex-3-enecarboxylic

acid ethyl ester

14.

Cyclohexa-1,4-diene-1,2-

dicarboxylic acid diethyl

ester

15.

Cyclohex-1,4-diene-1,2-

dicarboxylic acid

16.

Cyclohex-3-enecarboxylic

acid

17.

2,3-Epoxy-2,3,4a,5,8,8a-

hexahydro-[1,4]

naphthoquinone

Page 178: Instructor utilities guide

B-11

18.

5,6-Epoxy-3a,4,5,6,7,7a-

hexahydro-4,7-methano-

indene

19.

1,2-Epoxy-1,2,3a,4,7,7a-

hexahydro-4,7-methano-

indene

20.

2-Bicyclo[2.2.1]hept-5-

en-2-yl-oxirane

21.

6-vinyl-3-oxa-tricyclo

[3.2.1.02,4]octane

22.

2,2a,3,5a,6,6a-hexahydro-

1aH-1-oxa-cyclopropa

[f]indene

23.

7-Oxa-bicyclo[4.1.0]hept-

3-ene-3,4-dicarboxylic

acid dimethyl ester

24.

3,4-Epoxy-cyclohexane

carboxylic acid methyl

ester

25.

1,2,3,4,4a,8a-hexahydro-

1,4-methano-2,3-epoxy-

naphthalene-5,8-dione

26.

3-Oxa-tricyclo[3.2.1.02,4]

oct-6-ene-6,7-dicarboxylic

acid dimethyl ester

27.

3-Oxa-tricyclo[3.2.1.02,4]

octane-6-carboxylic acid

methyl ester

28.

3-Buten-1-ol

29.

2-Cyclopenten-1-ol

30.

3-Ethoxy-1-butene

31.

1-Ethoxy-2-butene

32.

Cyclopent-2-enyl ethyl

ether

33.

3-Chloro-1-butene

34.

1-Chloro-2-butene

35.

3-Chloro-cyclopentene

36.

3,4-Dibromo-1-butene

37.

1,4-Dibromo-2-butene

38.

trans-3,4-Dibrom-

cyclopentene

39.

3,5-Dibromo-

cyclopentene

40.

2,3-Dibromo-propanoic

acid methyl ester

41.

trans-5-Bromo-cyclopent-

2-enol

42.

3-Bromo-2-hydroxy-

propionic acid methyl

ester

43.

4-Bromo-3-ethoxy-

but-1-ene

44.

Buta-3-ene-1,2-diol

45.

cis-Cyclopent-3-ene-

1,2-diol

Page 179: Instructor utilities guide

B-12

46.

2,3-Dihydroxy-propionic

acid methyl ester

47.

3,4-Epoxy-but-1-ene

48.

3,4-Epoxy-cyclopentene

49.

Oxirane-2-carboxylic acid

methyl ester

50.

2-Propenoic acid

51.

Pent-2-ene-1,5-dioic acid

52.

Formic acid

53.

4-Methoxy-but-3-en-2-

one

54.

Methoxy-trimethyl-silane

55.

Trimethylsilanol

56.

Ethoxy-trimethyl-silane

57.

4-Hydroxy-but-3-en-2-one

58.

4-Ethoxy-but-3-en-2-one

59.

1-Hydroxy-4-methoxy-

but-3-en-2-one

60.

Hydroquinone

61.

But-2-ynedioic acid

62.

But-2-ynedioic acid

diethyl ester

63.

2-Propenoic acid, ethyl

ester

Aldol

1.

3-Hydroxybutanal

2.

2-Ethyl-3-hydroxy-

hexanal

3.

3-Hydroxy-3-phenyl-

propanal

4.

2-Ethyl-hex-2-enal

5.

5-Hydroxy-2,2,4-

trimethyl-hexan-3-one

6.

3-Hydroxy-2-methyl-3-

phenyl-propionic acid

2,6-dimethyl-phenyl ester

7.

1-hydroxy-2,4,4-

trimethyl-1-phenyl-

pentan-3-one

8.

5-Hydroxy-2,2,4-

trimethyl-octan-3-one

9.

anti-3-Hydroxy-2-methyl-

3-phenyl-propionic acid

ethyl ester

Page 180: Instructor utilities guide

B-13

10.

3-Hydroxy-2-methyl-3-

phenyl-propionic acid

methyl ester

11.

anti-3-Hydroxy-2-methyl-

3-phenyl-propionic acid

12.

anti-3-hydroxy-2-methyl-

hexanoic acid-2,6-

dimethyl-phenyl ester

13.

But-2-enal

14.

3-Phenyl-propenal

15.

2,2,4-Trimethyl-hex-4-en-

3-one

16.

2,4,4-Trimethyl-1-phenyl-

pent-1-en-3-one

17.

2-Methyl-3-phenyl-

acrylic acid ethyl ester

18.

2-Methyl-3-phenyl-

acrylic acid methyl ester

19.

2-Methyl-3-oxo-pentanoic

acid methyl ester

20.

2-Methyl-3-phenyl-

acrylic acid

21.

Formic acid methyl ester

22.

Formic acid propyl ester

23.

Formic acid phenyl ester

24.

Propanoic acid, 1,1-

dimethylethyl ester

25.

1,1-Diethoxy-ethane

26.

1,1-Diethoxy-butane

27.

Benzaldehyde

diethylacetal

28.

Ethanol

29.

Butanol

30.

Benzyl alcohol

31.

2,2-Dimethyl-pentan-3-ol

32.

Acetic acid

33.

Butanoic acid

34.

Benzoic acid

35.

Bromo-acetaldehyde

36.

2-Bromo-butanal

37.

4-Bromo-2,2-dimethyl-

pentan-3-one

Page 181: Instructor utilities guide

B-14

38.

Propionic acid-2,6-

dimethyl-4-bromo-phenyl

ester

39.

2-Bromo-propionic acid

2,6-dimethyl-phenyl ester

40.

3-Nitro-benzaldehyde

41.

Propionic acid-2,6-

dimethyl-4-nitro-phenyl

ester

42.

3-Hydroxy-3-(4-nitro-

phenyl)-propanal

43.

3-(4-Nitro-phenyl)-

propenal

44.

Propionic acid

45.

2,6-Dimethyl-phenol

46.

Propionic acid ethyl ester

Grignard Addition

1.

2-Methyl-2-butanol

2.

2-cyclohexyl-propan-2-ol

3.

2-Phenyl-2-propanol

4.

1-Phenyl-1-propanol

5.

Diphenyl-methanol

6.

Cyclohexyl-phenyl-

methanol

7.

Propionic acid

8.

Benzoic acid

9.

Cyclohexane

carboxylic acid

10.

Ethanol

11.

Propan-2-ol

12.

Benzyl alcohol

13.

1-Cyclohexanol

14.

Phenol

15.

2,2-Diethoxy-propane

16.

Benzaldehyde

diethylacetal

17.

Ethyl bromide

18.

Bromobenzene

19.

Bromocyclohexane

Page 182: Instructor utilities guide

B-15

20.

1-Bromo-propan-2-one

21.

nitro-Benzene

22.

1,3-Dinitrobenzene

23.

3-Nitro-benzaldehyde

24.

Formic acid phenyl ester

25.

4-Methyl-pent-3-en-2-one

26.

4-Hydroxy-4-phenyl-

butan-2-one

27.

4-Phenyl-but-3-en-2-one

28.

Methyl acetate

Benzene Nitration

1.

1-Methyl-4-nitro-benzene

2.

1-Methyl-2-nitro-benzene

3.

1-Methyl-2,4-dinitro-

benzene

4.

3-Nitro-benzaldehyde

5.

Bromomethyl-benzene

6.

Benzoic acid

7.

Benzaldehyde

diethylacetal

8.

Benzyl alcohol

9.

Formic acid phenyl ester

Friedel-Crafts

1.

3-Isopropyl-benzaldehyde

2.

3-Benzoyl-benzaldehyde

3.

3-Acetyl-benzaldehyde

4.

1-isopropyl-2-methyl-

benzene

5.

1-Isopropyl-4-methyl-

benzene

6.

4-Acetyltoluene

7.

2-Acetyltoluene

8.

2-Methyl-benzophenone

9.

4-Methyl-benzophenone

10.

Ethyl acetate

Page 183: Instructor utilities guide

B-16

11.

Methyl acetate

12.

Benzoic acid ethyl ester

13.

Benzoic acid methyl ester

14.

Bromoacetic acid ethyl

ester

15.

Acetic acid

16.

Benzoic acid

17.

Bromoacetic acid

18.

2,2-Diethoxy-propane

19.

Benzaldehyde

diethylacetal

20.

Propan-2-ol

21.

Benzyl alcohol

22.

N,N-Diisopropyl-

acetamide

23.

N,N-Diisopropyl-

benzamide

24.

1-Methyl-4-nitro-benzene

25.

1-Methyl-2-nitro-benzene

26.

1-Methyl-2,4-dinitro-

benzene

27.

3-Nitro-benzaldehyde

28.

3-Nitro-benzoic acid

29.

Bromomethyl-benzene

30.

Formic acid phenyl ester

31.

2-Ethoxy-propane

32.

2-Propanone

Acid Chloride

1.

Acetyl chloride

2.

Benzoyl chloride

3.

Heptanoyl chloride

4.

Ethyl acetate

5.

Benzoic acid ethyl ester

6.

Ethyl heptanoate

Page 184: Instructor utilities guide

B-17

7.

Ethanol

8.

Benzyl alcohol

9.

1-Heptanol

10.

3-Nitro-benzoic acid

Carbonyl Reduction

1.

Benzyl alcohol

2.

1-Cyclohexanol

3.

3-Hydroxy-butyric acid

methyl ester

4.

Benzaldehyde

diethylacetal

5.

1,1-Diethoxy-

cyclohexane

6.

2-Bromo-cyclohexanone

7.

2-Bromo-3-oxo-butyric

acid methyl ester

8.

Benzoic acid

9.

Formic acid phenyl ester

10.

Oxepan-2-one

11.

3-Oxo-butyric acid

12.

3-Oxo-butyric acid ethyl

ester

13.

3-Nitro-benzaldehyde

14.

Bicyclohexyliden-2-one

15.

2-(Hydroxy-phenyl-

methyl)-cyclohexanone

16.

2-Benzylidene-

cyclohexanone

17.

2-Acetyl-3-phenyl-acrylic

acid

18.

4-Phenyl-but-3-en-2-one

19.

2-Acetyl-3-phenyl-acrylic

acid methyl ester

20.

2-Acetyl-3-phenyl-acrylic

acid ethyl ester

21.

2-Cyclohexylidene-

acetoacetic acid

22.

1-Cyclohexylidene-

propan-2-one

23.

2-Cyclohexylidene-3-oxo-

butyric acid methyl ester

24.

2-Cyclohexylidene-3-oxo-

butyric acid ethyl ester

Page 185: Instructor utilities guide

B-18

Claisen Condensation

1.

2-Oxo-cyclohexane

carboxylic acid methyl

ester

2.

3-Oxo-butyric acid

methyl ester

3.

3-Oxo-pentanoic acid

methyl ester

4.

2-Methyl-3-oxo-butyric

acid methyl ester

5.

2-Methyl-3-oxo-pentanoic

acid methyl ester

6.

3-Oxo-butyric acid ethyl

ester

7.

2-Methyl-3-oxo-pentanoic

acid ethyl ester

8.

2-Oxo-cyclohexane

carboxylic acid ethyl ester

9.

3-Oxo-pentanoic acid

ethyl ester

10.

2-Methyl-3-oxo-butyric

acid ethyl ester

11.

Ethyl acetate

12.

Ethyl propionate

13.

Heptanedioic acid diethyl

ester

14.

Acetic acid

15.

Propionic acid

16.

Heptanedioic acid

17.

Bromo-acetic acid methyl

ester

18.

2-Bromo-propanoic acid

methyl ester

19.

2-Bromo-heptanedioic

acid dimethyl ester

Alcohol Oxidation

1.

Benzoic acid

2.

Benzaldehyde

3.

Acetophenone

4.

3-Methyl-cyclohex-2-

enone

5.

Chlorophenylmethane

6.

1-Chloro-1-phenylethane

7.

3-Chloro-1-methyl-

cyclohexene

8.

Dibenzyl Ether

9.

Benzyl ethyl ether

Page 186: Instructor utilities guide

B-19

10.

bis-(1-Phenyl-ethyl)-ether

11.

Ethyl-(1-phenyl-ethyl)-

ether

12.

Benzyl-(1-phenyl-ethyl)-

ether

13.

1-Methyl-cyclohexane-

1,2,3-triol

14.

2-Hydroxy-2-methyl-

hexanedioic acid

15.

1-Methyl-2,3-

epoxycyclohexanol

Page 187: Instructor utilities guide

C-1

Appendix C

List of Organic Qualitative Analysis Unknowns

A list of organic qualitative analysis unknowns that can be assigned arranged by unknown class.

Alkenes

1.

1-Hexene

2.

1-Methyl-cyclohexene

3.

4-Methyl-2-pentene

4.

2-Methyl-1-butene

5.

Styrene

6.

2-Methyl-2-pentene

7.

1,3-Diphenyl-1-butene

8.

Benzene

9.

1-isopropyl-2-methyl-

benzene

10.

1-Isopropyl-4-methyl-

benzene

11.

Indene

12.

Cyclohexene

13.

1,2,3,4,5,6,7,8-Octahydro-

naphthalene

14.

4,5-Dimethyl-cyclohexene

15.

Cyclohexa-1,3-diene

16.

Cyclopenta-1,3-diene

17.

4-Vinyl-cyclohexene

18.

1,2-Dimethyl-cyclohexa-

1,4-diene

19.

Bicylo[2.2.1]hept-2-ene

20.

4-Nitro-styrene

21.

2-Nitro-styrene

22.

nitro-Benzene

23.

Cyclohex-2-enol

24.

2-Buten-1-ol

25.

cis-Cyclopent-3-ene-1,2-

diol

Page 188: Instructor utilities guide

C-2

26.

cis-4,5-Dimethyl-

cyclohex-4-ene-1,2-diol

27.

But-2-enal

28.

3-Phenyl-propenal

29.

2-Ethyl-hex-2-enal

30.

4-Methyl-pent-3-en-2-one

31.

2,5-Cyclohexadiene-1,4-

dione

32.

3-Methyl-cyclohex-2-

enone

33.

2-Propenoic acid, methyl

ester

34.

2-Propenoic acid, ethyl

ester

35.

Cyclohex-3-enecarboxylic

acid methyl ester

36.

2-Propenoic acid

37.

3-Chloro-cyclohexene

38.

3-Chloro-1-butene

39.

1,4-Dibromo-2-butene

40.

1,2-Dimethyl-1,2-epoxy-

cyclohex-4-ene

41.

1-Ethoxy-2-butene

42.

N-Allylaniline

43.

Acrylamide

44.

Cinnamamide

45.

1-Bromo-but-3-en-2-ol

46.

4-Bromo-3-ethoxy-but-1-

ene

Alcohols

1.

Benzyl alcohol

2.

3-Methyl-1-butanol

3.

2-Methyl-2-propanol

4.

2-Methyl-butane-1,2-diol

5.

Methanol

6.

Ethanol

7.

Butanol

Page 189: Instructor utilities guide

C-3

8.

1-Hexanol

9.

1-Heptanol

10.

2-Methyl-1-butanol

11.

2-Phenyl ethanol

12.

4-tert-Butylbenzyl alcohol

13.

2-Butanol

14.

2-Hexanol

15.

1-Phenylethanol

16.

Diphenyl-methanol

17.

1-Phenyl-1-propanol

18.

Propan-2-ol

19.

2,2-Dimethyl-pentan-3-ol

20.

2-Methyl-3-pentanol

21.

4-Methyl-2-pentanol

22.

1-Cyclohexanol

23.

trans-2-methyl-

cyclohexanol

24.

2,3-Dimethyl-2-butanol

25.

2-Phenyl-2-propanol

26.

2-Methyl-2-pentanol

27.

2-Methyl-2-butanol

28.

1,4-Butanediol

29.

Hexane-1,2-diol

30.

syn-Butane-2,3-diol

31.

syn-4-Methyl-pentane-2,3-

diol

32.

cis-Cyclohexane-1,2-diol

33.

cis-1-Methyl-cyclohexane-

1,2-diol

34.

Phenol

35.

Benzene-1,3-diol

Page 190: Instructor utilities guide

C-4

36.

Cyclohexane-1,2,3-triol

37.

2-Nitro-benzyl alcohol

38.

4-Nitro-benzyl alcohol

39.

2,6-Dimethyl-4-nitro-

phenol

40.

Cyclohex-2-enol

41.

2-Buten-1-ol

42.

cis-Cyclopent-3-ene-1,2-

diol

43.

cis-4,5-Dimethyl-

cyclohex-4-ene-1,2-diol

44.

3-Hydroxybutanal

45.

4-Hydroxy-4-phenyl-

butan-2-one

46.

2-Ethyl-3-hydroxy-

butyraldehyde

47.

4-Hydroxy-4-methyl-

pentan-2-one

48.

5-Hydroxy-2,2,4-

trimethyl-octan-3-one

49.

2-(Hydroxy-phenyl-

methyl)-butyraldehyde

50.

1-hydroxy-2,4,4-trimethyl-

1-phenyl-pentan-3-one

51.

4-Chloro-1-butanol

52.

1-Bromo-2-hexanol

53.

1-Bromo-3,3-dimethyl-2-

butanol

54.

9-Bromo-10-hydroxy-

trans-decalin

55.

2-Bromo-cyclohexane-1,3-

diol

56.

2,3-Dibromo-cyclohexanol

57.

3-Hydroxy-butyric acid

methyl ester

58.

3-Hydroxy-2-methyl-3-

phenyl-propionic acid 2,6-

dimethyl-phenyl ester

59.

1-Bromo-but-3-en-2-ol

60.

3-Bromo-2-hydroxy-

propionic acid methyl ester

Aldehydes

1.

Butyraldehyde

2.

Benzaldehyde

3.

3-Phenyl-propenal

Page 191: Instructor utilities guide

C-5

4.

3-Methyl butanal

5.

3-Isopropyl-benzaldehyde

6.

4-Nitrobenzaldehyde

7.

3-Nitro-benzaldehyde

8.

But-2-enal

9.

2-Ethyl-hex-2-enal

10.

3-Acetyl-benzaldehyde

11.

3-Hydroxybutanal

12.

3-Hydroxy-3-phenyl-

propanal

13.

2-Ethyl-3-hydroxy-

butyraldehyde

14.

2-(Hydroxy-phenyl-

methyl)-butyraldehyde

15.

Bromo-acetaldehyde

16.

4-Chloro-butyraldehyde

17.

4-Chloro-benzaldehyde

18.

4-Acetamidobenzaldehyde

Ketones

1.

1-Phenyl-ethanone

2.

Cyclohexanone

3.

2-Propanone

4.

2-Butanone

5.

2,2-Dimethyl-pentan-3-one

6.

4-Acetyltoluene

7.

2-Acetyltoluene

8.

4-Methyl-benzophenone

9.

Cyclodecane-1,6-dione

10.

Bicyclo[2.2.1]heptan-2-one

11.

4-Methyl-pent-3-en-2-one

12.

2-Cyclohexen-1-one

Page 192: Instructor utilities guide

C-6

13.

3-Methyl-cyclohex-2-

enone

14.

2,5-Cyclohexadiene-1,4-

dione

15.

3-Acetyl-benzaldehyde

16.

4-Hydroxy-4-phenyl-

butan-2-one

17.

4-Hydroxy-4-methyl-

pentan-2-one

18.

1-hydroxy-2,4,4-trimethyl-

1-phenyl-pentan-3-one

19.

5-Hydroxy-2,2,4-

trimethyl-octan-3-one

20.

2-Bromo-cyclohexanone

21.

3-Oxo-butyric acid

22.

2-Oxo-propionic acid

23.

3-Oxo-butyric acid methyl

ester

24.

2-Oxo-cyclohexane

carboxylic acid methyl

ester

Acids

1.

Benzoic acid

2.

Heptanoic acid

3.

Formic acid

4.

Acetic acid

5.

Propionic acid

6.

Butanoic acid

7.

Pentanoic acid

8.

2-Methyl-propionic acid

9.

3-Methyl butanoic acid

10.

2,2-Dimethylpropanoic

acid

11.

2-Phenylacetic acid

12.

Cyclohexanecarboxylic

acid

13.

Ethane-1,2-dioic acid

14.

Propanedioic acid

15.

Hexanedioic acid

16.

Heptanedioic acid

Page 193: Instructor utilities guide

C-7

17.

3-Nitro-benzoic acid

18.

4-Nitro-benzoic acid

19.

2-Nitrobenzeneacetic acid

20.

2,4-Dinitrophenylacetic

acid

21.

2-Propenoic acid

22.

Bicyclo[2.2.1]hept-5-ene-

2-carboxylic acid

23.

3-Oxo-butyric acid

24.

2-Oxo-propionic acid

25.

2-Bromo-butanoic acid

26.

m-Chlorobenzoic acid

27.

N-Acetylanthranilic acid

Esters

1.

Ethyl-2-phenyl acetate

2.

3-Methylbutyl acetate

3.

Methyl propionate

4.

Methyl acetate

5.

Ethyl acetate

6.

Propionic acid ethyl ester

7.

Propanoic acid, 1,1-

dimethylethyl ester

8.

Methyl butanoate

9.

Ethyl butanoate

10.

3-Methylbutyl butanoate

11.

Benzoic acid methyl ester

12.

Benzoic acid ethyl ester

13.

Methyl phenylacetate

14.

3-Methylbutyl

phenylacetate

15.

Ethyl heptanoate

16.

Acetic acid 1-phenyl-ethyl

ester

17.

Formic acid methyl ester

Page 194: Instructor utilities guide

C-8

18.

Formic acid propyl ester

19.

Formic acid phenyl ester

20.

Propionic acid 2,6-

dimethyl-phenyl ester

21.

Dihydro-furan-2-one

22.

Oxepan-2-one

23.

1,7-Dimethyl-

heptanedioate

24.

Heptanedioic acid diethyl

ester

25.

3-Nitro-benzoic acid ethyl

ester

26.

Propionic acid-2,6-

dimethyl-4-nitro-phenyl

ester

27.

2-Bromo-heptanedioic acid

dimethyl ester

28.

2-Propenoic acid, methyl

ester

29.

2-Propenoic acid, ethyl

ester

30.

Cyclohex-3-enecarboxylic

acid methyl ester

31.

But-2-ynedioic acid ethyl

ester methyl ester

32.

3-Oxo-butyric acid methyl

ester

33.

3-Oxo-butyric acid ethyl

ester

34.

2-Oxo-cyclohexane

carboxylic acid methyl

ester

35.

Methyl 2-chloropropionate

36.

3-Hydroxy-butyric acid

methyl ester

37.

3-Bromo-2-hydroxy-

propionic acid methyl ester

38.

3-Hydroxy-2-methyl-3-

phenyl-propionic acid 2,6-

dimethyl-phenyl ester

Amines

1.

Benzylamine

2.

Diisopropyl amine

3.

Triethyl amine

4.

Methyl amine

5.

Propyl amine

6.

n-Heptylamine

7.

n-Octylamine

Page 195: Instructor utilities guide

C-9

8.

Isopropylamine

9.

sec-Butylamine

10.

Aniline

11.

Diethylamine

12.

N-Methylpropylamine

13.

N-Ethylisopropylamine

14.

N-Methylaniline

15.

N-Methyldibutylamine

16.

Butyldiisopropylamine

17.

Benzyldiisopropylamine

18.

Triisopropylamine

19.

N,N-Dimethylaniline

20.

Cyclobutylamine

21.

1-Phenylpiperidine

22.

Quinoline

23.

N-Allylaniline

Amides

1.

N,N-Diisopropyl-

acetamide

2.

Acetanilide

3.

Formamide

4.

Butyramide

5.

Cyclohexanecarboxamide

6.

N-Ethylacetamide

7.

2,2-Dimethyl-

propionamide

8.

N,N-Dimethylacetamide

9.

Formanilide

10.

N,N-Diphenylformamide

11.

1-Acetylpiperidine

Page 196: Instructor utilities guide

C-10

12.

Cinnamamide

13.

2-Bromopropionamide

14.

4-Acetamidobenzaldehyde

15.

2-Bromo-N-

phenylpropionamide

16.

N-Acetylanthranilic acid

Halides

1.

Chlorophenylmethane

2.

2-Chloro-2-methyl

propane

3.

Chlorocyclohexane

4.

1-Chloro-3-methyl butane

5.

1,4-Dibromo-2-butene

6.

Chlorobutane

7.

1-tert-Butyl-4-

chloromethyl-benzene

8.

Ethyl bromide

9.

Bromomethyl-benzene

10.

2-Chloro-hexane

11.

2-Chloro-butane

12.

2-Chloro-3-methylbutane

13.

2-Chloro-4-methyl pentane

14.

3-Chloro-2-methyl pentane

15.

exo-2-Chloro-

bicyclo[2.2.1]heptane

16.

Bromocyclohexane

17.

2-Chloro-2-methylpentane

18.

4a-Chloro-decahydro-

naphthalene

19.

1,2-Dibromo-hexane

20.

1,2-Dibromo-2-methyl-

butane

21.

1,2-Dibromo-1-methyl-

cyclohexane

22.

4a,8a-Dibromo-decahydro-

naphthalene

23.

1-Chloromethyl-2-nitro-

benzene

Page 197: Instructor utilities guide

C-11

24.

Benzene Chloride

25.

Bromobenzene

26.

3-Chloro-1-butene

27.

3-Chloro-cyclohexene

28.

4-Chloro-1-butanol

29.

1-Bromo-2-hexanol

30.

1-Bromo-3,3-dimethyl-2-

butanol

31.

9-Bromo-10-hydroxy-

trans-decalin

32.

Bromo-acetaldehyde

33.

4-Chloro-benzaldehyde

34.

4-Chloro-butyraldehyde

35.

2-Bromo-cyclohexanone

36.

2-Bromo-butanoic acid

37.

m-Chlorobenzoic acid

38.

Methyl 2-chloropropionate

39.

2-Bromo-heptanedioic acid

dimethyl ester

40.

2-Bromopropionamide

41.

2-Bromo-N-phenyl

propionamide

42.

1-Bromo-but-3-en-2-ol

43.

4-Bromo-3-ethoxy-

but-1-ene

44.

3-Bromo-2-hydroxy-

propionic acid methyl ester

45.

2-Bromo-cyclohexane-1,3-

diol

46.

2,3-Dibromo-cyclohexanol

Ethers

1.

1,2-Epoxy-cyclohexane

2.

Diethyl ether

3.

2-Methoxypropane

4.

1-Ethoxy-butane

5.

Di-tert-butyl ether

Page 198: Instructor utilities guide

C-12

6.

Diisopentyl ether

7.

Ethyl 2-hexyl ether

8.

2-Methoxy-2-methyl-

propane

9.

Dibenzyl Ether

10.

Benzyl methyl ether

11.

Ethyl phenyl ether

12.

Benzyl ethyl ether

13.

Tetrahydrofuran

14.

2,3-Epoxy-butane

15.

1,2-Epoxyhexane

16.

1,2-Epoxyethylbenzene

17.

3,3-Dimethyl-1,2-

epoxybutane

18.

1,2-Epoxy-2-methyl-

butane

19.

1-Methyl-1,2-

epoxycyclohexane

20.

4a,8a-Epoxy-decahydro-

napthalene

21.

1,1-Diethoxy-ethane

22.

2,2-Diethoxy-propane

23.

Benzaldehyde

diethylacetal

24.

1-Ethoxy-2-butene

25.

3,4-Epoxy-but-1-ene

26.

1,2-Dimethyl-1,2-epoxy-

cyclohex-4-ene

27.

4-Bromo-3-ethoxy-but-1-

ene

Natural Products

1.

Citric Acid

2.

Glycine

3.

Fumaric Acid

4.

Alpha-ketogluteric Acid

5.

Dopamine

6.

D-Glucose

Page 199: Instructor utilities guide

C-13

7.

Sucrose

8.

Vanillin

9.

Capsaicin

10.

Cocaine

11.

Cholesterol

Page 200: Instructor utilities guide

D-1

Appendix D

Quantum Equations

The experiments in the quantum simulation are based on actual experimental measurements, as is

the case for the emission and adsorption experiments or on equations that are derived from

fundamental principles. Given in this section is a description of some of these equations that an

instructor may wish to pass on to the students in the class. It is beyond the scope of this user’s

guide to detail how these equations were derived. Most of the supporting information for these

equations can be found in a good undergraduate physics text. In the case of the Millikan Oil

Drop Experiment, the equations used in the simulation were developed from Millikan’s original

paper.

Photoelectric Effect. In the photoelectric experiment, the kinetic energy of the electron

ejected from a metal due to an incident photon is calculated using the equation, Ekinetic = h ,

where h is Planck’s constant, is the frequency of the photon, and is the work function for the

metal. Values of the work function used for all the available metals are given in the Metal Table

found in the QuantumDB directory. In this experiment, no multiple photon events are allowed to

occur.

Blackbody Radiation. In the quantum simulation, each available metal can be heated up to its

melting point, where it is then allowed to melt. Before the metal melts, each metal is treated as a

perfect blackbody emitter and follows Planck’s blackbody radiation formula. The equation that is

used in the simulation is given in terms of the intensity (not the energy density, which is

normally the case) and is =1

18)(

5 Tkhc BeT

hcNI where I( ) is the intensity of the

radiation as a function of wavelength, ; N is a normalizing factor set to 0.2 to keep the intensity

within the bounds of 0 to 1; and the other variables take on their normal values.

Thompson Experiment. In the Thompson Experiment, the charge-to-mass ratio, q/me, for an

electron can be calculated by measuring the deflection of a beam of electrons on a phosphor

screen caused by an applied electric field and then measuring the magnitude of a perpendicular

magnetic field required to bring the deflected beam back to the center of the phosphor screen.

The setup and geometry of the experiment has an incident beam of electrons with a given kinetic

energy (velocity), which passes through an electric field of strength E and a perpendicular

magnetic field of strength B. Initially, B is set to 0 (zero), and the incident beam is deflected on

the phosphor screen by applying a voltage across the electric plates. The deflection and voltage

must be measured. The deflected beam is then brought back to the zero (or middle) of the

phosphor screen by applying the magnetic field. From these measurements and using values

specified in the INI variables, the charge-to-mass ratio for an electron, q/me, can be calculated.

The derivation of the following equations is straightforward, but involves more detail than is

necessary here. The charge-to-mass ratio, q/me, is calculated using the equation

Page 201: Instructor utilities guide

D-2

22

2

lB

Ez

m

q

e

= , where

q = the charge on the electron in coulombs,

me = the mass of the electron in kg,

E = is the magnitude of the electric field calculated using E = V/d,

V = voltage applied to the electric plates in volts,

d = the spacing between the electric plates in m and is specified as an INI variable in Lab.ini

(default setting = 0.050 m),

z = the deflection of the electron beam as the beam exits the electric and magnetic fields,

B = the applied magnetic field in T, and

l = the length of the electric and magnetic fields. (This is also specified as an INI variable in

Lab.ini. The default setting is 0.050 m.)

The deflection of the electron beam as the beam exits the electric and magnetic field, z, cannot be

measured directly, but must be calculated using the measured deflection on the phosphor screen,

x. The equation that calculates z from x is straightforward to derive and reduces to

lb

xz

21+= , where

z = the deflection of the electron beam as the beam exits the electric and magnetic fields,

x = the deflection of the electron beam as measured at the phosphor screen,

b = the distance from the electric and magnetic field to the phosphor screen and is specified as

an INI variable in Lab.ini (default setting = 0.762 m),

l = the length of the electric and magnetic fields. (This is also specified as an INI variable in

Lab.ini. The default setting is 0.050 m.)

Millikan Oil Drop Experiment. In the Millikan Oil Drop Experiment, the charge of an

electron is measured using the following process: (1) A random number of electrons (between 0

and 5) are deposited on very fine oil mist droplets using an electron gun. (2) The mass of an

individual droplet is calculated by measuring the terminal velocity of the drop. (3) The drop is

then suspended (or stopped from falling) by adjusting the voltage across the electric plates. (4)

From the mass of the drop and the voltage required to suspend the drop, the charge on the drop

can be calculated. The following equations are required for this calculation.

To calculate the radius of the oil droplet from the terminal velocity, the first approximation of the

radius, is

r =9 air vt

2 g ( oil air ),

Page 202: Instructor utilities guide

D-3

which can then be used to calculate a more accurate value using the equation

r =9 air vt

2 g ( oil air)

1

1+ b pr

1/ 2

,

where r on the right side of the equation is the radius acquired from the first approximation and

the new r is used for the second iteration and so on until the answer converges. The variables are

defined as follows:

vt = terminal velocity;

g = 9.81 m s-2

, acceleration due to gravity;

oil = density of oil = 821 kg m-3

(set as an INI variable in Video.ini);

air = density of air = 1.22 kg m-3

(set as an INI variable in Video.ini);

air = viscosity of air = 1.4607 10-5

kg m-1

s-1

(set as an INI variable in Video.ini);

b = correction for small drop size = 8.1184 10-8

m atm;

p = atmospheric pressure in atm = 1 (set as an INI variable in Video.ini).

From this, the mass of the droplet can be calculated from the equation

oilrm =3

3

4.

If a voltage is applied such that the drop is stationary, then the force due to gravity is balanced by

the force due to the electric field, or

mgqE = .

Rearranging and using E = V/dplates yields

V

gmdCnQ

V

gmdq

platesplates== )(or , where

q = total charge on the drop,

Q(n) = number of electrons on the drop (an integer),

C = the fundamental charge of an electron,

E = electric field = V/dplates,

V = voltage across the plates, and

dplates = the distance between the voltage plates = 0.010 m (set as an INI variable in Video.ini).

To do a more refined calculation of q, or to calculate it for a nonzero velocity for an applied

field, the equation

Page 203: Instructor utilities guide

D-4

q =4 dplates3 V

1

g( oil air )

9 air

2

3

1/ 2

1

1+ b pr

3 / 2

vt v field( ) vt

can be used, where the only new variable not described previously, vfield, is the velocity of the

drop in the applied electric field.

Page 204: Instructor utilities guide

E-1

Appendix E

Answers to Preset Unknowns

Inorganic Qualitative Analysis Unknowns

Unknown Cation Unknown Cation Unknown Cation

1

2

3

4

5

6

7

8

9

10

11

12

13

14

15

16

17

18

19

20

21

22

23

24

25

26

27

28

29

30

31

32

33

34

35

36

37

38

39

40

41

42

Na+

K+

Na+, K

+

Water

Water

Na+

K+

Na+, K

+

Pb2+

Hg22+

Ag+

Water

Ag+, Hg2

2+, Pb

2+

Hg22+

, Pb2+

Ag+, Pb

2+

Ag+, Hg2

2+

Water

Ag+, Hg2

2+, Pb

2+

Ag+, Hg2

2+

Ag+, Pb

2+

Hg22+

, Pb2+

Ag+

Pb2+

Hg22+

Co2+

, Cr3+

Co2+

, Cu2+

Cr3+

, Cu2+

Water

Co2+

, Cr3+

, Cu2+

Cr3+

Cu2+

Co2+

Co2+

, Cr3+

, Cu2+

Water

Co2+

Cu2+

Cr3+

Cr3+

, Cu2+

Co2+

, Cr3+

Co2+

, Cu2+

Ba2+

, Sr2+

Ba2+

43

44

45

46

47

48

49

50

51

52

53

54

55

56

57

58

59

60

61

62

63

64

65

66

67

68

69

70

71

72

73

74

75

76

77

78

79

80

81

82

83

84

Ba2+

, Ca2+

Sr2+

Ba2+

, Mg2+

Ca2+

Sr2+

, Ca2+

Mg2+

Sr2+

, Mg2+

Water

Ca2+

, Mg2+

Ba2+

, Sr2+

, Ca2+

, Mg2+

Sr2+

, Ca2+

, Mg2+

Ba2+

, Ca2+

, Mg2+

Ba2+

, Sr2+

, Mg2+

Ba2+

, Sr2+

, Ca2+

Co2+

, Cu2+

Co2+

, Ni2+

Cu2+

, Ni2+

Co2+

, Cu2+

, Ni2+

Water

Ni2+

Cu2+

Co2+

Water

Co2+

Cu2+

Ni2+

Co2+

, Cu2+

, Ni2+

Cu2+

, Ni2+

Co2+

, Ni2+

Co2+

, Cu2+

Al3+

, Sb3+

Al3+

, Sn4+

Al3+

, Zn2+

Sb3+

, Sn4+

Sb3+

, Zn2+

Sn4+

, Zn2+

Water

Al3+

, Sb3+

, Sn4+

Al3+

, Sb3+

, Zn2+

Al3+

, Sn4+

, Zn2+

Sb3+

, Sn4+

, Zn2+

Al3+

, Sb3+

, Sn4+

, Zn2+

85

86

87

88

89

90

91

92

93

94

95

96

97

98

99

100

101

102

103

104

105

106

107

108

109

110

111

112

113

114

115

116

117

118

119

120

121

122

123

124

Zn2+

Sb3+

Sn4+

Al3+

Ag+, Mg

2+, Cu

2+

Ag+, Mg

2+, Cr

3+

Ag+, Mg

2+, Co

2+

Ag+, Ca

2+, Cu

2+

Ag+, Ca

2+, Cr

3+

Ag+, Ca

2+, Co

2+

Ag+, Sr

2+, Cu

2+

Ag+, Sr

2+, Cr

3+

Ag+, Sr

2+, Co

2+

Ag+, Ba

2+, Cu

2+

Ag+, Ba

2+, Cr

3+

Ag+, Ba

2+, Co

2+

Hg22+

, Ba2+

, Co2+

Hg22+

, Ba2+

, Cr3+

Hg22+

, Ba2+

, Cu2+

Hg22+

, Sr2+

, Co2+

Hg22+

, Sr2+

, Cr3+

Hg22+

, Sr2+

, Cu2+

Hg22+

, Ca2+

, Co2+

Hg22+

, Ca2+

, Cr3+

Hg22+

, Ca2+

, Cu2+

Hg22+

, Mg2+

, Co2+

Hg22+

, Mg2+

, Cr3+

Hg22+

, Mg2+

, Cu2+

Pb2+

, Mg2+

, Cu2+

Pb2+

, Mg2+

, Cr3+

Pb2+

, Mg2+

, Co2+

Pb2+

, Ca2+

, Cu2+

Pb2+

, Ca2+

, Cr3+

Pb2+

, Ca2+

, Co2+

Pb2+

, Sr2+

, Cu2+

Pb2+

, Sr2+

, Cr3+

Pb2+

, Sr2+

, Co2+

Pb2+

, Ba2+

, Cu2+

Pb2+

, Ba2+

, Cr3+

Pb2+

, Ba2+

, Co2+

Page 205: Instructor utilities guide

E-2

Organic Qualitative Analysis Unknowns

Alkenes

1. 1,4-Dibromo-2-butene

2. 1-Ethoxy-2-butene

3. 2-Buten-1-ol

4. 2-Methyl-2-pentene

5. 3-Chloro-1-butene

6. 4-Methyl-pent-3-en-2-one

7. Ethyl acrylate

8. Methyl acrylate

9. 2-Propenoic acid

10. Acrylamide

11. N-Vinylaniline

12. 2,5-Cyclohexadiene-1,4-dione

13. But-2-enal

14. 3-Phenyl-propenal

15. Cinnamamide

16. Cyclohexene

17. Cyclopenta-1,3-diene

18. 4,5-Dimethyl-cyclohexene

19. 1-Hexene

20. 2-Methyl-1-butene

21. 3-Methyl-cyclohex-2-enone

22. 1-Methyl-cyclohexene

23. 4-Methyl-2-pentene

24. nitro-Benzene

25. 2-Nitro-styrene

26. 4-Nitro-styrene

27. Styrene

Acids

28. Benzoic acid

29. Heptanedioic acid

30. Heptanoic acid

31. Cyclohexanecarboxylic acid

32. Acetic acid

33. Hexanedioic acid

34. Butanoic acid

35. 2,2-Dimethylpropanoic acid

36. Formic acid

37. 3-Methyl butanoic acid

38. Propanedioic acid

39. Pentanoic acid

40. 2-Phenylacetic acid

41. Propionic acid

42. 3-Oxo-butyric acid

43. 2-Propenoic acid

44. 2-Oxo-propionic acid

45. 2-Nitrobenzeneacetic acid

46. m-Chlorobenzoic acid

47. 2-Bromo-butanoic acid

48. 3-Nitro-benzoic acid

49. 4-Nitro-benzoic acid

50. 2,4-Dinitrophenylacetic acid

51. 2-Methyl-propionic acid

52. Ethanedioc acid

Alcohols

53. Benzyl alcohol

54. 3-Methyl-1-butanol

55. 2-Methyl-2-propanol

56. 2-Methyl-butane-1,2-diol

57. 1-Butanol

58. 1-Heptanol

59. 1-Hexanol

60. 2-Methyl-1-butanol

61. 2-Phenyl ethanol

62. 4-tert-Butylbenzyl alcohol

63. 2-Nitro-benzyl alcohol

64. 4-Nitro-benzyl alcohol

65. 2-Butanol

66. 1-Hexanol

67. 1-Phenylethanol

68. Diphenyl-methanol

69. 1-Phenyl-1-propanol

70. 2,2-Dimethyl-pentan-3-ol

71. 2-Methyl-3-pentanol

72. 4-Methyl-2-pentanol

73. Cyclohexanol

74. 2,3-Dimethyl-2-butanol

75. 2-Phenyl-2-propanol

76. 2-Methyl-2-pentanol

77. 2-Methyl-2-butanol

78. 2-Chloro-4-methyl pentane

79. 3-Chloro-2-methyl pentane

80. Bromobenzene

81. Bromomethyl-benzene

Amides

82. N-Ethylacetamide

83. Formamide

84. Butyramide

85. N,N-Dimethylacetamide

86. Cyclohexanecarboxamide

87. Formanilide

88. 1-Acetylpiperidine

89. N,N-Diphenylformamide

90. 2-Bromopropionamide

91. Cinnamamide

92. Acetanilide

Amines

93. Benzylamine

Page 206: Instructor utilities guide

E-3

94. n-Heptylamine

95. Diisopropyl amine

96. Triethyl amine

97. Methyl amine

98. Propyl amine

99. Aniline

100. sec-Butylamine

101. N-Methylaniline

102. N-Methyldibutylamine

103. N-Methylpropylamine

104. Cyclobutylamine

105. n-Octylamine

106. Triisopropylamine

107. N,N-Dimethylaniline

108. Quinoline

109. Isopropylamine

Esters

110. Ethyl-2-phenyl acetate

111. 3-Methylbutyl acetate

112. Methyl propionate

113. Methyl acrylate

114. 1,7-Dimethyl-heptanedioate

115. Methyl acetylacetate

116. 2-Oxo-cyclohexane carboxylic acid

methyl ester

117. Ethyl heptanoate

118. Ethyl-2-phenyl acetate

119. Propyl formate

120. Ethyl acrylate

121. Methyl 2-chloropropionate

122. 3-Hydroxy-butyric acid methyl ester

123. 2-Bromo-heptanedioic acid dimethyl

ester

124. Cyclohex-3-enecarboxylic acid methyl

ester

125. Ethyl acetoacetate

126. Ethyl butanoate

127. Ethyl benzoate

128. Ethyl 3-nitrobenzoate

129. Methyl formate

130. Phenylformate

131. 3-Methylbutyl butanoate

132. 3-Methylbutyl phenylacetate

133. Methyl butanoate

134. Methyl phenylacetate

135. Heptanedioic acid diethyl ester

136. Propanoic acid, 1,1-dimethylethyl ester

137. Propionic acid 2,6-dimethyl-phenyl

ester

Ethers

138. Diethyl ether

139. Tetrahydrofuran

140. Ethyl phenyl ether

141. Benzyl ethyl ether

142. Ethyl 2-hexyl ether

143. Di-tert-butyl ether

144. 1-Ethoxy-2-butene

145. 2-Methoxy-2-methyl-propane

146. 1,1-Diethoxy-ethane

147. 2,2-Diethoxy-propane

148. Dibenzyl Ether

149. 1-Ethoxy-butane

150. 2-Methoxypropane

151. Diisopentyl ether

Halides

152. Benzyl chloride

153. 2-Chloro-2-methyl propane

154. Chlorocyclohexane

155. 1-Chloro-3-methyl butane

156. Benzene Chloride

157. 4-Chloro-1-butanol

158. 2-Chloro-norbornane

159. 3-Chloro-cyclohexene

160. 3-Chloro-1-butene

161. 3-Bromo-cyclohexane-1,2-diol

162. 4-Chloro-benzaldehyde

163. 4-Chloro-butyraldehyde

164. Bromo-acetaldehyde

165. 2-Bromo-cyclohexanone

166. m-Chlorobenzoic acid

167. 2-Nitrobenzyl chloride

168. 4-tert-Butyl-benzyl chloride

169. 1-Bromo-3,3-dimethyl-2-butanol

170. 1-Bromo-2-hexanol

171. 1,4-Dibromo-2-butene

172. 2-Bromo-butanoic acid

173. Bromocyclohexane

174. Ethyl bromide

175. 1,2-Dibromo-hexane

176. 2-Chloro-butane

177. 2-Chloro-hexane

178. 2-Chloro-3-methylbutane

179. 2-Chloro-2-methylpentane

180. Hexane-1,2-diol

181. syn-Butane-2,3-diol

182. Benzene-1,3-diol

183. 2,6-Dimethyl-4-nitro-phenol

184. Cyclohex-2-enol

185. 2-Buten-1-ol

186. 3-Hydroxybutanal

187. 4-Hydroxy-4-phenyl-butan-2-one

188. 4-Chloro-1-butanol

189. 1-Bromo-2-hexanol

190. 1-Bromo-but-3-en-2-ol

191. 3-Hydroxy-butyric acid methyl ester

Page 207: Instructor utilities guide

E-4

Ketones

192. Acetophenone

193. Cyclohexanone

194. 2-Propanone

195. 2-Butanone

196. 2,2-Dimethyl-pentan-3-one

197. 4-Acetyltoluene

198. 2-Acetyltoluene

199. 4-Methyl-benzophenone

Aldehydes

200. Butyraldehyde hydrate

201. Benzaldehyde

202. 3-Phenyl-propenal

203. 3-Methyl butanal

204. 3-Isopropyl-benzaldehyde

205. 4-Nitrobenzaldehyde

206. But-2-enal

207. 3-Hydroxybutanal

208. 3-Hydroxy-3-phenyl-propanal

209. Bromo-acetaldehyde

210. 4-Chloro-butyraldehyde

211. 4-Chloro-benzaldehyde

212. 4-Acetamidobenzaldehyde

General Unknown

213. 1-Ethoxy-2-butene

214. 2-Methyl-2-pentene

215. 2-Propenoic acid

216. But-2-enal

217. Cyclohexene

218. Cyclopenta-1,3-diene

219. 1-Hexene

220. 1-Methyl-cyclohexene

221. nitro-Benzene

222. Styrene

223. Benzoic acid

224. Cyclohexanecarboxylic acid

225. Acetic acid

226. Butanoic acid

227. Propanedioic acid

228. 2-Phenylacetic acid

229. m-Chlorobenzoic acid

230. Ethanedioc acid

231. 1-Butanol

232. 1-Hexanol

233. 1-Phenylethanol

234. 4-Methyl-2-pentanol

235. 2-Chloro-4-methyl pentane

236. Bromobenzene

237. N,N-Dimethylacetamide

238. N,N-Diphenylformamide

239. Benzylamine

240. Triethyl amine

241. Aniline

242. N,N-Dimethylaniline

243. Methyl propionate

244. Ethyl heptanoate

245. Ethyl acetoacetate

246. Ethyl benzoate

247. Diethyl ether

248. Tetrahydrofuran

249. Dibenzyl Ether

250. 3-Chloro-cyclohexene

251. 1-Bromo-2-hexanol

252. Bromocyclohexane

253. Ethyl bromide

254. 2-Chloro-3-methylbutane

255. syn-Butane-2,3-diol

256. Cyclohex-2-enol

257. Acetophenone

258. Cyclohexanone

259. 2-Butanone

260. Benzaldehyde

261. 3-Methyl butanal

262. But-2-enal

Page 208: Instructor utilities guide

E-5

Titration Unknowns

Preset #2

1. 0.1611 M

2. 0.1552 M

3. 0.1518 M

4. 0.1501 M

5. 0.1497 M

6. 0.1503 M

7. 0.1516 M

8. 0.1535 M

9. 0.1559 M

10. 0.1587 M

11. 0.1619 M

12. 0.1654 M

13. 0.1692 M

14. 0.1732 M

15. 0.1774 M

Preset #4

1. 0.2566 M

2. 0.2457 M

3. 0.2389 M

4. 0.2349 M

5. 0.2330 M

6. 0.2328 M

7. 0.2340 M

8. 0.2364 M

9. 0.2399 M

10. 0.2442 M

11. 0.2495 M

12. 0.2556 M

13. 0.2625 M

14. 0.2703 M

15. 0.2788 M

Preset #6

1. 67.52 wt%

2. 66.94 wt%

3. 66.45 wt%

4. 66.05 wt%

5. 65.70 wt%

6. 65.40 wt%

7. 65.13 wt%

8. 64.91 wt%

9. 64.73 wt%

10. 64.62 wt%

11. 64.65 wt%

12. 65.02 wt%

13. 66.16 wt%

14. 68.96 wt%

15. 74.88 wt%

Preset #8

1. 0.3209 M

2. 0.3064 M

3. 0.2968 M

4. 0.2910 M

5. 0.2879 M

6. 0.2870 M

7. 0.2880 M

8. 0.2907 M

9. 0.2948 M

10. 0.3004 M

11. 0.3073 M

12. 0.3156 M

13. 0.3253 M

14. 0.3364 M

15. 0.3491 M

Preset #10

1. 74.84 wt%

2. 74.23 wt%

3. 73.70 wt%

4. 73.24 wt%

5. 72.83 wt%

6. 72.46 wt%

7. 72.13 wt%

8. 71.84 wt%

9. 71.62 wt%

10. 71.51 wt%

11. 71.68 wt%

12. 72.62 wt%

13. 75.45 wt%

14. 82.47 wt%

15. 97.25 wt%

Preset #11

1. 0.3209 M

2. 0.3064 M

3. 0.2968 M

4. 0.2910 M

5. 0.2879 M

6. 0.2870 M

7. 0.2880 M

8. 0.2907 M

9. 0.2948 M

10. 0.3004 M

11. 0.3073 M

12. 0.3156 M

13. 0.3253 M

14. 0.3364 M

15. 0.3491 M

Preset #13

1. 79.12 wt%

2. 78.50 wt%

3. 77.96 wt%

4. 77.47 wt%

5. 77.03 wt%

6. 76.63 wt%

7. 76.28 wt%

8. 75.96 wt%

9. 75.72 wt%

10. 75.62 wt%

11. 75.92 wt%

12. 77.29 wt%

13. 81.48 wt%

14. 91.86 wt%

15. 87.51 wt%

Preset #15

1. 0.0133 M

2. 0.0132 M

3. 0.0131 M

4. 0.0131 M

5. 0.0131 M

6. 0.0131 M

7. 0.0132 M

8. 0.0132 M

9. 0.0133 M

10. 0.0134 M

11. 0.0135 M

12. 0.0136 M

13. 0.0137 M

14. 0.0138 M

15. 0.0139 M