Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Reading: Add cohort chart and raw scores #2761

merged 17 commits into from Feb 12, 2020

Reading: Add cohort chart and raw scores #2761

merged 17 commits into from Feb 12, 2020


Copy link

@kevinrobinson kevinrobinson commented Feb 11, 2020

Who is this PR for?

APs at MTSS, reading specialists, literacy coaches

What problem does this PR fix?

When problem solving for a specific student (eg, in MTSS), it's sometimes challenging to make meaning out of benchmark screeners, especially for folks like APs who are less intimately familiar with benchmarks for each screener at each grade level.

Setting benchmarks supports this kind of triage, but after that folks still seek another level of understanding. Raw scores provide this, as do chart visualizations that allow making inferences about growth. But these leave a lot of space for different interpretations and predictions about future growth that aren't necessarily reasonable to make from just these data points, and those interpretations may not directly support problem solving about instructional changes or interventions.

As another way to approach this, charts comparing the student's score to other students in their grade cohort at school can be a more intuitive and actionable way for folks to triage. It's trying to support folks in the more abstract "are things okay" or "should we prioritize attention or staffing" in a way that's scoped to what they have power over in the context of a problem-solving meeting.

What does this PR do?

Adds cohort charts, and raw scores also in the process. Abstracts the BoxChart to do this.

It de-colors the charts for percentiles and raw scores, to avoid implying that some kind of coloring for benchmarks is also being applied to the percentiles or elsewhere. We'll have to test interpretation of all these, but the assumption is that this cohort chart is a secondary action here, and one that will be supported in PD training or coaching beforehand.

It also ports the JS F&P interpretation code to Ruby for use in computing percentiles, and factors the related JS code out to mirror the Ruby code, with comments on both sides.

Screenshot (if adding a client-side feature)

Screen Shot 2020-02-12 at 11 47 50 AM


Which features or pages does this PR touch?

  • Student Profile

Does this PR use tests to help verify we can deploy these changes quickly and confidently?

  • Included specs for changes
  • Manual testing made more sense here

@@ -77,7 +77,6 @@ group :development, :test do
gem 'bourbon', '~> 4.3.2'
gem 'capybara'
gem 'database_cleaner'
gem 'descriptive-statistics'
Copy link
Contributor Author

@kevinrobinson kevinrobinson Feb 12, 2020

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

separate, but unused since probably d13e03a

Copy link
Contributor Author

@kevinrobinson kevinrobinson commented Feb 12, 2020


@kevinrobinson kevinrobinson merged commit 357478a into master Feb 12, 2020
1 check passed
@kevinrobinson kevinrobinson deleted the feature/more-charts branch Feb 12, 2020
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
None yet
None yet

Successfully merging this pull request may close these issues.

None yet

1 participant