Skip to content

Forecast best and worst case scenarios for your academic grades

License

Unknown, MIT licenses found

Licenses found

Unknown
LICENSE
MIT
LICENSE.md
Notifications You must be signed in to change notification settings

NeuroShepherd/gradecast

Repository files navigation

gradecast

R-CMD-check Codecov test coverage

The goal of gradecast is to allow students to calculate a possible range of final grades for their academic program based on their current grades, quantity of completed ECTS points, and the number of remaining ECTS points. The package is designed to be used in a Shiny app, where the user can input their data and see the possible range of final grades in a plot.

Installation

You can install the development version of gradecast from GitHub with:

# install.packages("devtools")
devtools::install_github("NeuroShepherd/gradecast")

Example

Calculating Range of Grades

library(gradecast)

# Example of completing 1 semester i.e. 30 ECTS with a 1.5 grade (German)
# and having 60 ECTS left to complete the program. Uses the standard German
# grading scale of 1 to 5 (1 being the best grade and 5 being the worst).
calculate_grade_range(
  completed_ects = 30,
  current_grade = 1.5,
  remaining_ects = 60,
  max_passing_grade = 1,
  min_passing_grade = 5
)
#>  best_outcome worst_outcome 
#>      1.166667      3.833333

Projection plot

# The results can be projected in a plot

plot_grade_range(
  completed_ects = 30,
  current_grade = 1.5,
  remaining_ects = 60,
  max_passing_grade = 1,
  min_passing_grade = 5,
  caption_width = 95
)

Shiny Application

run_app()

Misc: Grade Conversion

The package also provides a function to convert grades between different grading scales, in particular it supports the conversion between the German and US grading scales (affectionaly known as “freedom units” here.)

grade_in_germany <- 1.3

convert_to_freedom_units(grade_in_germany)
#> [1] 3.7

About

Forecast best and worst case scenarios for your academic grades

Resources

License

Unknown, MIT licenses found

Licenses found

Unknown
LICENSE
MIT
LICENSE.md

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Languages