Skip to main content
Skip table of contents

GPA Student Screens

Use the GPA Student Screens function to determine what appears on GPA-related student pages, including the Quick Lookup page and the Cumulative Information page.

Define GPA Settings for Quick Lookup Page

  1. Navigate to the GPA Info for Student Screens page. 

  2. Choose the type of current GPA to display under schedule:

    • Weighted: If your school calculates weighted GPAs, the system also includes the number of credit hours students earn in each course in the GPA calculation.

    • Weighted Percent

    • Simple: If your school calculates simple GPAs, only the students' grades are involved in the calculation, and the credit hours of each course are not referenced.

    • Simple Percent

    • Total Earned Credit

  3. Click Submit

Define GPA Settings for Cumulative Info Page

For the Cumulative Info student page, you can define the rows of information that appear for each student.

  1. Navigate to the GPA Info for Student Screens page. 

  2. Enter in the first Row Title field the name of the first row to appear on the Cumulative Info page. The name should clearly indicate the information the user is viewing, such as Cumulative GPA (Weighted).

  3. Use the tables following this list to determine the information you want to display in the Data column.

  4. Click Submit

For Cumulative GPAs:

Field Expression

Code

Notes

Cumulative GPA (weighted)

^(*gpa)

The cumulative GPA for the student.

Cumulative GPA (simple)

^(*gpa.simple)

Same as Cumulative GPA (weighted), except uses the simple calculation method rather than weighted.

Cumulative credit hours earned

^(*credit_hours)

Includes all courses from the Historical Grades page.

Class rank (based on
cumulative weighted GPA)

^(*class_rank_out_of;gpa)

Use any valid GPA type as the GPA parameter, such as gpa.simple and gpa.percent.

Cumulative avg. % earned
in all classes (weighted)

^(*gpa.percent)

Refer to Cumulative Percentage GPA.

Cumulative avg. % earned
in all classes (simple)

^(*gpa.percent.simple)

Refer to Cumulative Simple Percentage GPA.

For GPAs for specific years and terms:

Field Expression

Code

Notes

GPA for Quarter 1 (weighted)

^(*gpa;Q1)

Calculates the GPA for Q1 of the current school year, such as the year in which the user is currently working. Q1's grades must have already been stored.

GPA for the student's entire junior year

^(*gpa;11)

Calculates the GPA for grade 11.

GPA for Q1 of the student's junior year

^(*gpa;11;Q1)

Calculates the GPA for Q1 of grade 11 for the current student.

The sequence of the parameters Q1 and 11 is not significant; ^(*gpa;Q1;11) returns the same number as ^(*gpa;11;Q1).

GPA for the year 2004

^(*gpa;2004)

Calculates the GPA for 2004 for the current student.

GPA for Quarter 3 (simple)

^(*gpa.simple;Q3)

Same as GPA for the year 2004, but using the simple calculation method. You can use percent instead of simple if you want the percent GPA.

For Current GPAs:

Field Expression

Code

Notes

The current GPA (simple)

^(*gpa.current)

From the grades on the Quick Lookup page, such as those current as of today.

Current grades are always calculated using the simple method.

The average % being earned
in the current classes (simple)

^(*gpa.current.percent)

From the grades on the Quick Lookup page, such as those current as of today.

For Weighted GPAs by Credit Type:

Field Expression

Code

Notes

Weighted GPA by Credit Type

^(*gpa.credit_type.ENG)

Weighted GPA for grades for the current student in the current year that are of the credit type ENG. To calculate all historical grades, see the Weighted GPA by Credit Type by Grade field expression.

Weighted GPA by Credit Type by Grade

^(*gpa.credit_type.ENG;12)

Same as Weighted GPA by Credit Type, but also includes grade 12. For all historical grades, enter each grade and separate each grade with commas, such as *gpa.credit_type.ENG;9,10,11,12.

For Class Ranking by GPA:

Class ranking codes always begin with *classrank and may be followed by zero to three optional parameters:

Parameter "method" - Specifies the name of the class rank method for which a rank should be returned. Class rank calculation methods are defined by the user in the Class Rankings section of School Setup.

Parameter "result" - Specifies the type of data to return as the result. Possible values are "rank", "outof", "rankoutof", "percentile", "rankdate", "gpa", and "schoolname". If omitted, the default value is "rank".

Parameter "percentiledigits" - If the parameter "result" is "percentile", this parameter specifies the number of decimal places to compute the percentage. If omitted, "2" is the default.

Field Expression

Code

Notes

Class rank, weighted (default)

^(*classrank) or ^(*classrank method="weighted")

Numerical class rank based on cumulative weighted GPA for the student's entire academic career for this school.

Class rank, user defined

^(*classrank method="UserDefined")

Class rank based on a user-defined GPA calculation method as specified in Class Rankings in School Setup.

Class rank, rank result

^(*classrank) or ^(*classrank result="rank")

Numerical class rank based on cumulative weighted GPA for the student's entire academic career for this school.

Class rank, outof result

^(*classrank result="outof")

Number of students ranked.

Class rank, rankoutof result

^(*classrank result="rankoutof")

Rank for the student, the text "out of", and the number of students ranked.

Class rank, percentile result

^(*classrank result="percentile")

Student rank percentile to the number of places specified by the percentiledigits parameter.

Class rank, rankdate result

^(*classrank result="rankdate")

Date the rank was last updated.

Class rank, gpa result

^(*classrank result="gpa")

Result of the GPA code used to determine the class rank.

Class rank, schoolname result

^(*classrank result="schoolname")

Name of the school where the student earned the rank.

Class rank, percentiledigits

^(*classrank result="percentile" percentiledigits="3")

When used with the percentile result, specifies the number of decimal places to compute the percentage.


JavaScript errors detected

Please note, these errors can depend on your browser setup.

If this problem persists, please contact our support.