<commit_before>.. This file is part of the OpenDSA eTextbook project. See
.. http://algoviz.org/OpenDSA for more details.
.. Copyright (c) 2012 by the OpenDSA Project Contributors, and
.. distributed under an MIT open source license.

.. avmetadata:: OpenDSA Preface
   :author: <NAME>
   :prerequisites:
   :topic: OpenDSA
   :short_name: Intro

Preface
=======

**Welcome to OpenDSA!**
OpenDSA is an open source to provide online course materials for 
Data Structures and Algorithms courses.
For this semester in CS3114, we will be using OpenDSA for Sorting and
Hashing.
Your OpenDSA "textbook" is made up of a series of modules.
Each module corresponds to roughly one section in a regular textbook.
OpenDSA content combines text and images with algorithm visualizations
for all of the algorithms and lots of interactive assessment exercises
so that you can tell if you really know what you have been reading.

**Supported browsers:** We support any reasonably recent version of
Chrome, Firefox, or Safari.
Unfortunately, we do not attempt to support Internet Explorer, and we
can pretty well guarantee that it won't work there.
At this time we have no plans to take any special effort to support
the non-standard requirements imposed by Internet Explorer.

**Registration and Accounts:**
To get credit for completing exercises and modules, you will need to
be logged in.
First you should register an account by clicking on the link in the
upper-right corner of any OpenDSA page.
The system will let you use any (unused) name and password for your
account, but we ask that you use your Virginia Tech PID for you
account name.
That will let us give you appropriate course credit for what you have
done.

Registration is simple, just click on the Registration link and fill
out the form.
Once you register, you will need to then click the "Login" button.
Once you log in, you should see your account name in the upper-right
corner.
You can log out by clicking on the logout link.
You shouldn't really need to logout unless you want another person to
be able to use the same computer to also access the OpenDSA materials
under another account.

**Overview of major elements:**
An OpenDSA module contains a number of interactive components intended
to help you learn the material, in addition to regular text and
graphics.
There are short slideshows that help explain steps of an
algorithm,
there are full Algorithm Visualizations that go through a complete
example of the algorithm,
there are "proficiency exercises" where you show the steps 
taken by an algorithm, and there are sets of questions.

**Getting credit:**
You can get completion credit for the following:
Going through a slideshow, completing a proficiency exercise, or
completing a question set.
You must be logged in to get credit.
If you go through the exercise and *then* log in, the system should
give you credit.

**Slideshows:**
Slideshows are controlled by the buttons at the top.
"<" and ">" buttons will back up or advance by one slide, while "<<"
and ">>" will take you to the beginning or end of the slideshow.
You get credit for a slideshow just for progressing to the end (one
step at a time).
A green checkmark should show up on the right when you get credit.

**Visualizations:**
While the slideshows are used to demonstrate a part of an algorithm on
a fixed input, the visualizations let you run the whole algorithm on
input that you can choose.
Generally these have some parameters that you can set (such as number
of elements in an input array, and the values of the input).
The "Run" button will start the visualization.
It will also restart the visualization with new data values if you did
not specify your own input.
"Reset" will typically clear all of the input fields and restart the
visualization.

**Question Sets:** Most modules finish with a collection of multiple
choice, True/False, or type-a-number questions.<commit_msg>Add info to Preface about seeing scores and credit.<commit_after>.. This file is part of the OpenDSA eTextbook project. See
.. http://algoviz.org/OpenDSA for more details.
.. Copyright (c) 2012 by the OpenDSA Project Contributors, and
.. distributed under an MIT open source license.

.. avmetadata:: OpenDSA Preface
   :author: <NAME>
   :prerequisites:
   :topic: OpenDSA
   :short_name: Intro

Preface
=======

**Welcome to OpenDSA!**
OpenDSA is an open source to provide online course materials for 
Data Structures and Algorithms courses.
For this semester in CS3114, we will be using OpenDSA for Sorting and
Hashing.
Your OpenDSA "textbook" is made up of a series of modules.
Each module corresponds to roughly one section in a regular textbook.
OpenDSA content combines text and images with algorithm visualizations
for all of the algorithms and lots of interactive assessment exercises
so that you can tell if you really know what you have been reading.

**Supported browsers:** We support any reasonably recent version of
Chrome, Firefox, or Safari.
Unfortunately, we do not attempt to support Internet Explorer, and we
can pretty well guarantee that it won't work there.
At this time we have no plans to take any special effort to support
the non-standard requirements imposed by Internet Explorer.

**Registration and Accounts:**
To get credit for completing exercises and modules, you will need to
be logged in.
First you should register an account by clicking on the link in the
upper-right corner of any OpenDSA page.
The system will let you use any (unused) name and password for your
account, but we ask that you use your Virginia Tech PID for you
account name.
That will let us give you appropriate course credit for what you have
done.

Registration is simple, just click on the Registration link and fill
out the form.
Once you register, you will need to then click the "Login" button.
Once you log in, you should see your account name in the upper-right
corner.
You can log out by clicking on the logout link.
You shouldn't really need to logout unless you want another person to
be able to use the same computer to also access the OpenDSA materials
under another account.

**Overview of major elements:**
An OpenDSA module contains a number of interactive components intended
to help you learn the material, in addition to regular text and
graphics.
There are short slideshows that help explain steps of an
algorithm,
there are full Algorithm Visualizations that go through a complete
example of the algorithm,
there are "proficiency exercises" where you show the steps 
taken by an algorithm, and there are sets of questions.

**Getting credit:**
You can get completion credit for the following:
Going through a slideshow, completing a proficiency exercise, or
completing a question set.
You must be logged in to get credit.
If you go through the exercise and *then* log in, the system should
give you credit.

**Seeing your credit and seeing your current score:**
Most exercises or slideshows will give you visual confirmation when
you have completed it.
If you complete all exercises and slideshows for a module, the title
line will show "Module Complete" in green.
Also, the table of contents page should show a green checkmark beside
the title of completed modules.
You have to be logged in to see information about previous work.

If you are logged in, when you click on your ID in the upper right
corner of the page, you will see a list of exercises, your current
score for the exercise, and the total points possible for the
exercise. At the bottom of the page will be your current point total.
Be aware that the data used by this page are only refreshed
periodically (about every half hour), so recent work might not
register there.

**Slideshows:**
Slideshows are controlled by the buttons at the top.
"<" and ">" buttons will back up or advance by one slide, while "<<"
and ">>" will take you to the beginning or end of the slideshow.
You get credit for a slideshow just for progressing to the end (one
step at a time).
A green checkmark should show up on the right when you get credit.

**Visualizations:**
While the slideshows are used to demonstrate a part of an algorithm on
a fixed input, the visualizations let you run the whole algorithm on
input that you can choose.
Generally these have some parameters that you can set (such as number
of elements in an input array, and the values of the input).
The "Run" button will start the visualization.
It will also restart the visualization with new data values if you did
not specify your own input.
"Reset" will typically clear all of the input fields and restart the
visualization.

**Question Sets:** Most modules finish with a collection of multiple
choice, True/False, or type-a-number questions.
{'fraction_non_alphanumeric': 0.04367314101827376, 'fraction_numerical': 0.0018388690955062636, 'mean_word_length': 4.428571428571429, 'pattern_counts': {'":': 0, '<': 11, '<?xml version=': 0, '>': 11, 'https://': 0, 'lorem ipsum': 0, 'www.': 0, 'xml': 0}, 'pii_count': 0, 'substrings_counts': 0, 'word_list_counts': {'cursed_substrings.json': 0, 'profanity_word_list.json': 0, 'sexual_word_list.json': 0, 'zh_pornsignals.json': 0}}
{'dir': 'git-commits-cleaned', 'id': '6232545', 'n_tokens_mistral': 2177, 'n_tokens_neox': 2104, 'n_words': 1415}