A newer version of Graderworks is available. You should download Graderworks version 4.
Graderworks is a grading support software for SOLIDWORKS educators. Graderworks can analyze students files, extract information, and perform routine grading tasks which will free you up to perform higher-level critiques of your students' files.
You must have SOLIDWORKS installed on your computer for Graderworks to run.
We recommend that your computer have a solid state hard drive. Since Graderworks opens hundreds of SOLIDWORKS files, it needs to be able to read from the disk quickly which is why an SSD is helpful. Imagine how long it takes your computer fully to open a SOLIDWORKS file, then multiply this by the number of files you need to grade, and you will get approximately how long it will take for Graderworks to analyze your files. In addition, a fast processor and at least 8GB of memory is helpful.
When you first run Graderworks, the main page will show you some basic information about the software. In the message area, you will see information about your License, Graderworks version, and the version of SOLIDWORKS that is compatible with Graderworks.
You will also see information about the current assignment (in the Assignment selection group). You can add or delete assignments in addition to selecting old assignments that you have already made. To get started, you should click "Add a New Assignment" and create a new assignment.
In the "Root Folder" group, you can see the current root folder and also browse for a different root folder. The root folder is the folder containing the SOLIDWORKS files, folders with SOLIDWORKS files, or .zip files containing SOLIDWORKS files which you wish to analyze. The default root folder is the desktop. If your student's files are not on the desktop, then you must change the root folder.
At the top of the main window click "configure" which will cause the configuration window to open. There are several tasks that you need to perform to tell Graderworks how to analyze your student's files.
Graderworks can grade various kinds of assignments.
Graderworks lets you select what types of files you would like it to analyze. Unchecking any of the boxes to exclude a particular type of SOLIDWORKS file.
In the "Username Identification" group, you must specify to Graderworks how to identify each student. Graderworks expects each student submission to have a particular format. Most schools use some learning management system (LMS) like Canvas, Blackboard, Moodle, Schoology, D2L, or some other system. These systems allow you to batch download your student submissions to your computer. During this download, the LMS will rename your students' submissions with some sort of identifier in the file name. The 'Username Identification' within Graderworks is designed to help extract the username identifier from the filename. Within Graderworks, you must specify the beginning character before the LMS added identifier, and you must specify the ending character after the LMS added identifier.
If you do not use an LMS with batch download and rename capabilities, then you could tell your students to use a particular naming convention in their file names (like appending their username and then an (-) dash).
In the table below, within Graderworks the Start Identifier is set to nothing so Graderworks will start at the beginning of the file, and the End Identifier is set to an underscore (_). The last column in the table shows the name that Graderworks will associate with each file.
|Student's school username
|File renamed by LMS
|Graderworks extracted username
Once, you have selected your root folder, type of assignment, type of SOLIDWORKS files, and set the username identification, then you can preview how Graderworks will extract the usernames by clicking "preview username extraction". Graderworks will launch a new window which shows you what files or folders it found in the root folder and how it plans to extract the usernames.
The advanced section of the user manual will discuss how to map the extracted username to a student's email address, first name, and last name.
Once Graderworks is fully set up, then click "ok" on the configuration window. In the main window click the Analysis->Start from the drop-down menu at the top.
Graderworks will startup SOLIDWORKS in the background and begin to analyze the files or folders. At the bottom of the window, a progress bar will show how much work remains for Graderworks to do. Also, an estimated time remaining and expected completion are displayed. You should not use SOLIDWORKS while Graderworks is running. Depending on the number of files you are analyzing, it might take Graderworks a long time, and the information at the bottom of the window can help you estimate when your computer will be free to use SOLIDWORKS again.
Once Graderworks is finished, it will export all of its data to an Excel Workbook file with multiple sheets. Graderworks will display the output file path when it is finishing analyzing the files. Also, the output file is always in the root folder. The file naming convention is data_GRADERWORKS_year_month_day_hour_mninute.xlsx. The output file has 2 for basic usage and 5 sheets if you are using at least one rubric item.
If you want to view information that you previously analyzed with Graderworks, then click Analysis->Export Existing Saved Date to tell Graderworks to regenerate the output file. This action will also cause Graderworks to recalculate any file grades.
The Graderworks rubric allows you to compare student's models to the correct answer models. Each rubric is specific to an assignment, and each rubric has one or more rubric items. Within each rubric item there are one or more grading items.
Graderworks can grade SOLIDWORKS part and rigid assembly files.
After you have created an assignment in the main window, click on Configure to open the Configuration window. Within the configuration window, click on the "Rubric" tab. The rubric tab allows you to make new rubric items, configure a late penalty, and select to auto-launch a mail-merge of filled out rubric information when Graderworks is complete. Rubrics are specific to an assignment, so if you change the assignment, then your rubric will save and any rubric information for the new assignment will be loaded.
In the rubric tab, click on "Add new rubric item". Each rubric items has many options for how to apply the rubric item.
Once you are finished making your rubric item, then click "save." You can add more than one rubric item. Graderworks will automatically determine which of the student's models match which rubric item. So if students should submit 5 files for an assignment, and if you made 5 rubric itmes, Graderworks will make sure it applies the correct rubric item to each of the student's files.
Graderworks can check each file that was graded to see if the last modified date-time is after a predefined date-time which is the assignment due date. If a single file is modified after the due date, then Graderworks can take off a percentage of the student's overall grade. You must select the calendar day that the assignment is due, and you must type in the time manually to correctly set the due date and time. To use the late work check, you must also specify the percentage of points to take off.
Graderworks can automatically set up a mailmerge of filled out rubrics for you to send to your students via email or individual print and return to your students. To enable this feature, check the box in the Display Results group. The mail merge will run after you click an analysis is finished and grades are calculated (i.e. you need to go to the main window and click Analysis-> Run or Analysis -> Export Existing Saved Data).
Graderworks collects meta-data about the student's files including the creation date, last saved date, and saved by name. These properties are internal to the SOLIDWORKS file and are NOT the windows os equivalent. It is not possible for students to modify these properties in the SOLIDWORKS file (if you find a way, then let us know).
Graderworks uses this meta-data to check for student plagiarism. Graderworks only identifies files that meet certain criteria that are suspicious or unusual, however, what constitutes plagiarism is dependent on how you setup the assignment and what exactly you told your students. Graderworks is only a tool to help you. You are the ultimate judge of plagiarism. Not Graderworks.
A few helpful pieces of advice can steer you in the correct direction while checking for plagiarism.
Graderworks can perform up to five different types of checks which can help you identify plagiarism. Check the boxes next to the types of checks you would like Graderworks to perform.
If a single student submits several files then you would expect that the last savedby name would be the same for all the files. If they are not the same, then you might find this situation suspicious. Graderworks can identify these situations for you.
What if a student borrows his friend's computer to complete part of the assignment. The last saved by name could change for a single student even though the student did all of his own work. In this case, you should check the feature information. Even if they used the same computer, then the feature creation times will be much different if they both did their own work on the same computer.
If two students turn in files and the last saved by name is "bob" for both students, then you might be suspicious. Again, you should check the feature information to obtain a better understanding of how the files were created.
If two students turn in files that were made on the same day, hour, minute, and second then you might suspect that one file is just a copy of the other file. You should check the feature information.
We have found this check to be very helpful and can identify most plagiarism instances when a student shares a file with another student.
If a file is created a long time ago, then you might suspect that the student actually obtained the file from another source (like Grabcad). This check tries to guess a reasonable limit on the create date (average minus 2 stdev). The average and stdev is based on all files turned in by all students for the selected assignment.
If your students are modeling an assembly that requires parts from a source that you give them or from the toolbox, then this plagiarism check might not be the best. For example, some toolbox parts are created in 1998. If the student turns in a part file from 1998, then the average creation date of all the files in an assignment will be much earlier and the stdev will be very large. In these instances, a student could have obtained a file from someone last semester, and still be within 2 stdev of the average. Because of this potential issue, you might find the next check more helpful.
Similar to the previous check, this plagiarism check seeks to identify files made outside the expected time frame. Since most files obtained from an unauthorized source were not created during the current semester, this is an excellent check to find these files from unauthorized sources. For this check to work, you must specify an oldest allowed creation date. Any file created before this specific date will be identified.
Graderworks can perform a few other tasks which you might find helpful. These options are configurable in the 'advanced' tab of the configuration window.
Graderworks can create a screenshot of the isometric view of each file and save it in the folder where the SOLIDWORKS file is located or in the root folder (if you check 'save files in root folder.) These screenshots can be helpful for grading since you can open an image file much faster than opening a SOLIDWORKS file. Similarly, you can tell Graderworks to export a .stl file of each part or assembly file.
Graderwoks will analyze and export (in the "raw data" sheet of the output Excel Workbook) the feature information by default (starting in version 3.13). If you do not want Graderworks to collect or export feature information, then you can uncheck this box. If one of the rubric items is to check for fully defined sketches, then Export Feature Data will be automatically enabled.
When grading assignments with multiple files, by default Graderworks will keep all of the files for a single student open (in SOLIDWORKS which means they are in memory) until it finishes collecting data about all of the student's files. This often helps speed up Graderworks since when it must analyze an assembly file it will need to open all the part files anyway. The performance improvement is because Graderworks will not need to close the files, then reopen them to open the assembly or drawing. When Graderworks finishes grading a single student's files, it will close all the files before moving on to the next student.
SOLIDWORKS might crash if all of the student's files are open at once (for example if a student turns in 50 SOLIDWORKS files which are all open in memory). The Windows operating system will not allow a single program to take more than an allotted amount of memory and might force it to stop. To fix this situation, just uncheck the box "Keep all of a user's files open."
In addition, to exporting an Excel file with multiple sheets, you can tell Graderworks to export each sheet as a separate .csv file. These .csv files might be helpful if you are trying to read the data using some other software program which uses .csv files.
The student information tab of the configuration window allows you to associate an extracted username with a student's actual first & last name and email address. To see all the extract usernames that Graderworks has found for all assignments click "Export Student Info" and save the .csv file on your computer. The .csv file will have 4 columns:
To associate an extracted username with the additional student information, fill in the columns 2-4. In addition, if you anticipate more extracted usernames, you can add new rows to the .csv file. When you are finished updating the .csv file, you should save the file as a .csv file and close Excel or whatever spreadsheet program that you are using. You must close the sheet in Excel or else Graderworks will not be permitted to read the file while it is open by Excel.
In Graderworks click "Upload student information" and browse to the saved .csv file. Graderworks will analyze the file and output to the main window "Finished Updating Student Information" when it finishes. In the future when you view the output Excel files, Graderworks will automatically show you the extracted username, email, first name, and last name for all the student's it knows about.
Are you doing research that involves analyzing SOLIDWORKS files for educational or some other purpose? We can help. We are experts in SOLIDWORKS file analysis and processing large amounts of data. We would love to collaborate. We can even customize Graderworks for your situation or add new features.
You can access the Graderworks data directly using the following python 3 script to get started. We recommend using Pandas to process the data and bokeh to plot the data.
import pandas as pd
pathappdata = os.getenv('APPDATA')
dbpath = os.path.join(pathappdata,'SWGrader','GraderworksDB.sqlite')
conn = sqlite3.connect(dbpath)
assignments = pd.read_sql_query("select * from Assignment",conn)
Read this user manual, and then use Graderworks.
Contact us with as much information as possible and we will fix it as soon as we can.
We currently offer $10 amazon gift card for reporting a bug and working with us to make sure it is fixed.
Contact us and we will send you a license key. You can also run Graderworks with no license for 30 days.
See the pricing page. Pricing is based on the number of students in the SOLIDWORKS class per semester.