Higher Distinction

csse.uwa.edu.au

Higher Distinction

Student Scores Manual User ManualApplication ManualTable of ContentsUser Manual.........................................................................................................................................21.Purpose of the Student Scores Project..........................................................................................22.Getting Started..............................................................................................................................32.1.Accessing the data..............................................................................................................................32.2.Opening the application......................................................................................................................32.3.Configuring the macro........................................................................................................................43.Interpreting the Results.................................................................................................................44.Special Features............................................................................................................................54.1.Database searching.............................................................................................................................54.2.Colour coding.....................................................................................................................................65.Required Data Format...................................................................................................................7Reference Manual.................................................................................................................................71.Making use of Names...................................................................................................................71.1.Nomenclature......................................................................................................................................71.2.Meaning of names...............................................................................................................................82.Use of Formulae............................................................................................................................92.1.General Formulae...............................................................................................................................92.2.Array Formulae.................................................................................................................................10Appendix - Macros.............................................................................................................................11Index of FiguresFigure 1 - File format window..............................................................................................................3Figure 2 - Macro configuration window..............................................................................................4Figure 3 - Tables on the Submit sheet..................................................................................................5Figure 4 - Search terminal description.................................................................................................6Figure 5 - A more interesting search....................................................................................................6Figure 6 - Highlighting different grades...............................................................................................7User Manual1.Purpose of the Student Scores ProjectThe goal behind the creation of the studentscores.sxc project was to create an easy to use spreadsheetbased tool for analysing and retrieving information about student scores in some particular unit. The rawstudent data contained in a comma delimited text file is imported into the document and is then processed tooutput some statistics about the class itself as well as final marks of individual students. Apart from this ourapplication contains a data base and a worksheet that allows the user to easily search the results with almostany desired criteria. This feature allows for more functionality and allows deeper insights if the user isinterested in more specific statistical analysis.Page 2 of 11


Student Scores Manual Getting Started2.Getting StartedTo be able to use the spreadsheet to its full capabilities there are three steps to be taken. These tasks canbe done in any order, but it is recommended to proceed as follows.2.1.Accessing the dataFirstly you need to open OpenOffice.org Calc. Once Calc has started up go to the menu bar in the top leftside of the window and select File, then select Open.... This will invoke a new window where you willneed to browse to the directory where the text file containing the data is stored. Select the file and click Ok.The browse window will disappear and the widow below will be brought to your attention. Take the stepslisted in the frame below.1. Check that Separatedby is selected.2. Select Comma if notselected already3. Click Ok.You can also go to the RequiredData Format section to find outmore about the required text fileformat. You will see a spreadsheetappear with the values in the textfile filled into appropriate tablecells. We will need to copy theseFigure 1 - File format windowcells. To do this left-click thecursor over the cell A1 (A for thecolumn, 1 for the row) and then whilst pressing down the left mouse button drag the cursor to the K columncell in the last non-empty row. Release the mouse. You notice now that that area is now black - it ishighlighted. Right-click anywhere within that region and select copy in the pop-up menu. We are now donewith the data file and can move on to opening the main application.2.2.Opening the applicationAgain follow File -> Open and browse to the directory that contains studentscores.sxc. Open thisfile as before. You will see a menu appear, click Run. You will be then welcomed with a greeting windowand then another one with brief instructions. Proceed further. At this stage we will need to paste the data wecopied earlier. You will see that the application will automatically go to the RawData sheet and the cell A1will be selected for you as well. Right click on that cell and select paste from the pop-up. The process ofcopying the data is now finished and you have successfully opened the project.Page 3 of 11


Student Scores Manual Getting Started2.3.Configuring the macroThe final step to make the application fully functional involves binding a macro to a key stroke. SelectTools, then select Configure.... Refer to the following diagram for instructions for the window thatFigure 2 - Macro configuration windowpops up. Now you have done everything to be able to use the program!3.Interpreting the ResultsOnce you have copied the data correctly into the document (refer to section 2.Gettting Started) theanalysis of the data will immediately appear in the Analysis sheet and the final student records will bepresented on the Submit sheet. Each student will have a final mark and a grade based on that. Note thatgrades like P*, UP, UF are not considered and also every incorrectly enrolled student is given a fail. You cannavigate between sheets by selecting the tabs at the bottom left corner of the view. However, only theSubmit, Analysis and Criteria sheets should be relevant to the user. On the Analysis sheet youwill find several tables with useful statistics. In the top right corner there is a table (Table 1 below) analysingthe results of students based on their degree programme, immediately below the same computation is carriedout based on the gender of the students and also for local and international students. Further below you willsee a table (Table 2) that presents statistics with useful data such as the mean, median etc about the practicalassessment component for the unit, the exam and the final marks.Page 4 of 11


Student Scores Manual Interpreting the ResultsOn the right side of the document starting with column I we have presented the distribution of thesemarks once again and the number of students for every percentile (Table 3). These results are also displayedin graphical form in the graphs further to the right. Refer to the following figure for more details.Table 1Table 3Graphs related to Table 3Table 2Figure 3 - Tables on the Submit sheet4.Special Features4.1.Database searchingTo allow more user functionality and permit the user to explore the student data to a deeper extent thanthe static implementation of the Submit and Analysis sheets, our project also provides a data base and atool for user defined searching on the Criteria sheet. On this sheet you will see a series of terminalslabeled A to F. A terminal is a block of cells serving as a quick search facility where you can specify thesearch field and the searching criteria. In this version of the project these two fields are located in the Ccolumn (cells in column D are not enabled). The search field of a terminal is always immediately to the rightof its label (A-F). In this field you can copy any cell from row 1 of the Database sheet. The names areintuitive. Once you have inserted a search field you can now type in a value to search for in the cell below.Refer to the diagram on the next page.Page 5 of 11


Student Scores Manual Special FeaturesFigure 4 - Search terminal descriptionThe output now to the right will be based on the entries among the students that match your specifiedcriteria. You can also use more interesting search criteria. Consider Figure 3.Figure 5 - A more interesting searchThe output of terminal E is now based on all the students who passed the exam and terminal F displaysstatistics about the students whose last name is lexicographically less than Zarev ie who are alphabeticallyprior to Zarev.4.2.Colour codingAnother special feature of the program is color coding of the different scores on the Submit sheet. Thisfeature allows the user to specify different colour highlighting of students on the submit sheet based on theirgrade. Bring your attention to the K column of the Criteria sheet. You see a list of grades. Try changingthe colour of some of these cells. Select the desired cell, right click and choose Format Cells... fromthe pop-up menu. Then select the Background tab, choose a colour and click Ok. The cell changed it'scolour to the one you specified and if you press F10 the submit sheet will be updated and all rows thatcontain a student record with the same grade as the cell you just highlighted will be shown in the samecolour. For example we might want to highlight everybody who failed.Page 6 of 11


Student Scores Manual Required Data Format5.Required DataFormatThe data that is insertedinto the RawData sheet has tobe in comma delimited textformat. That means that allentries in the same line areseparated by a comma and atthe end of every line there isno separator. The first line isexpected to contain in thisorder: unit number, unit nameFigure 6 - Highlighting different gradesand the semester the unit runsin. All following lines have to contain the following fields in this order and still separated by a comma:Student numberTitle, eg MR, MRS, MISS, MS etcInitialsFamily name, in upper case.Degree programme, eg 5013 (Sci/Eng)Enrollment status, where a blank cell (or with any number of spaces in it) represents correctenrollment, all else meaning incorrect enrollment statusA percentage score achieved by the student for all practical assessment, a mark out of 100.The score achieved by the student in final exam, a mark out of 100.Their gender, M or F.Their enrollment type, 1 for Full time, 2 for Part time.Whether they are local or international students, N for local, F for internationalFollowing this format will make sure that the application will function correctly.Reference Manual1.Making use of Names1.1.NomenclatureA descriptive naming scheme is used by dividing the names up into three parts. Each part is made up ofparameters which have underscores separating them. The first part of a name always refers to either thesheet it is defined or the sheet it is used. Below is a table defining these relationships.Page 7 of 11


Student Scores Manual Making use of NamesFirst parameter of the first part of a nameAnalysisCriteriaDatabaseFilterRawSubmittedSheet in which it is usedAnalysisCriteriaDatabase or CriteriaFilterRawDataSubmitThe second part groups the third part using a has-a relationship where possible. For example a Studenthas an Enrolment_Type, as defined in Filter_Student_Enrolment_Type.The third part is the intuitive description for the array/range/cell. An example of the construction of aname is as follows - for an array that is defined in the RawData sheet, that we want to classify as part of aStudent, and want the description to be Exam_Assessment, then we create the nameRaw_Student_Exam_Assessment.1.2.Meaning of namesNames can refer to single cells, arrays(1D) or ranges so it may be difficult to understand what formulaeare doing just by looking at the names they contain alone. There are over 60 names used in the document butbelow the meaning for some important names is stated.Name Range MeaningAnalysis_Faculty_Degree_Mean =$Analysis.$C$3:$C$8 An array containing the mean scores forthe groups Sci/Eng, Sci, BCM, Sci/Law,Eng, CogSci.Criteria_Colours_HD =$Criteria.$K$4 A cell containing the background colourfor the FillBackground macro.Database_Criteria_A =$Criteria.$C$1:$D$2 A range containing the criteria forsearching the database. This criteria isused by terminal A.Database_Database=$Database.$A$1:$N$501Filter_Student_Enrolment_Status =$Filter.$F$1:$F$500The range defining the database anddatabase title entries.An array containing the enrollment statusfor the students.Filter_Student_Enrolled =$Filter.$G$1:$G$500 An array containing the enrollment statusof a student as a 1 or 0.Filter_Student_No_Enrolled =$Filter.$Q$1 A cell that contains the number ofstudents enrolled.Raw_Student_Gender =$RawData.$I$2:$I$501 An array that contains the original studentgender.Raw_Unit_Name =$RawData.$B$1 A cell that contains the unit name.Page 8 of 11


Student Scores Manual Use of Formulae2.Use of Formulae2.1.General formulaeBasic formulaePass RateCreating Chart Labels=IF(C24=0;"";ROUND(C25/C24;3))=G3&" - "&H3Text concatenation is used to create the labels for the charts and rounding is used when necessary byusing the ROUND() function.CountingNo of StudentsNo of students enrolled in the5013 Degree Programme=SUM(Filter_Student_Enrolled)=SUMIF(Filter_Student_Degree_Programme;5013;Filter_Student_Enrolled)Counting students that satisfy certain criteria is done using the SUMIF() function, however if no criteriaare to be satisfied then this can be accomplished by simply using the SUM() function.Calculating resultsFor the Exam MarkFor the Final Grades=IF(Filter_Student_Enrolled;ROUND(Filter_Student_Practical_Assessment*0.4+Filter_Student_Exam_Assessment*0.6);"")=IF(ISNUMBER(Filter_Student_Final_Overall_Score);IF(Filter_Student_Final_Overall_Score>=80;"HD";IF(Filter_Student_Final_Overall_Score>=70;"D";IF(Filter_Student_Final_Overall_Score>=60;"CR";IF(Filter_Student_Final_Overall_Score>=50;"P";IF(Filter_Student_Final_Overall_Score>=45;"N+";"N")))));"")Checking if a student is enrolled is the priority in calculating an exam mark. For the final grade wesimply use nested IF() statements.Page 9 of 11


Student Scores Manual Use of FormulaeManipulating dataChecking the Enrollment of aStudentShifting Data Up One CellAssigning Numeric Valuesfor the Practical Assessment=IF(0=50))}{=SUM(Filter_Student_Enrolled*(Filter_Student_Practical_Assessment


Student Scores Manual Use of FormulaeCalculating meansFor Female StudentsFor Sci/Eng Students{=IF(D12=0;"";SUM(Filter_Student_Enrolled*(Filter_Student_Gender="F")*Filter_Student_Final_Overall_Score)/D12)}{=IF(D3=0;"";SUM(Filter_Student_Enrolled*(Filter_Student_Degree_Programme=A3)*Filter_Student_Final_Overall_Score)/D3)}Again this is a simple matter when using array formulae. All we need to do is sum the scores of thestudents in the array that satisfy certain criteria, and divide by the number of students in that criteria.Appendix - MacrosThe Welcome macro loads as soon asthe document is started, and greets the userusing prompts. This is done simply bycreating a message box, eg.MsgBox "My Message",80,"My Title"A cell range can be selectedby the current controller of thedocument as is shown to theright.document.CurrentController.Select(cellRange)The FillBackground macro looksat the exam scores of each of thestudents and then highlights thebackground. An example of some ofthis code is shown to the right.If examCell.Value >= 80 ThencellRange.cellBackColor = colourHDPage 11 of 11

More magazines by this user
Similar magazines