Giter Club home page Giter Club logo

oea-reading-progress's Introduction

Note: This module is currently released as v0.1, and is dependent on the OEA framework v0.7

Reading Progress Module

Reading Progress is a free tool in Microsoft Teams that helps students practice their reading fluency through independent reading practice. Educators can assign reading passages to students to be read out loud through an audio or video recording that is submitted to the educator.

With Reading Progress, students' reading performance can be reviewed and analyzed, and recommendations are provided on how students can improve their reading fluency and literacy. It provides personalized reading experiences and data-driven insights on student progress.

Microsoft Insights Visual

Problem Statement and Module Impact

Reading fluency is top of mind for many educators and parents. Defined as a reader’s ability to read text with accuracy, speed, and expression, reading fluency is a reliable factor to determining whether a student comprehends text.

Reading Progress, available in 100 languages, provides repeated oral reading practice for learners with error analysis capabilities to identify how to support readers' fluency. This relieves pressure for students, reduces classroom disruption, helps to identify gaps in learning and saves teachers' time. It is designed to improve reading fluency for K-12 emerging readers, non-native readers, and those with dyslexia and other learning disabilities.

Reading Progress data can be used for different scenarios including:

  • Dashboards for education leaders to track student reading fluency practice at a school or district level.
  • Combining Reading Progress data with other data sources to show the relationship between reading fluency and other metrics like assessments, attendance, and student demographic data.

Module Setup Instructions

Microsoft Insights Visual

Preparation: This module currently leans on v0.7 of the OEA framework. Ensure you have proper Azure subscription and credentials and setup of the OEA framework. This will include v0.7 of the OEA python class.

Note: It is highly recommended that you review and deploy the Microsoft Education Insights module (Reading Progress data is available through Microsoft Education Insights and can be landed into your organization's data lake with our existing Microsoft Education Insights module). For production data-use, follow the preliminary steps outlined in the Insights module.

  1. Run the setup.sh script
    • Open cloud shell in your Azure subscription (use ctrl+click on the button below to open in a new page)
      Launch Cloud Shell
    • Download the module release to your Azure clouddrive
      cd clouddrive
      wget https://github.com/microsoft/OpenEduAnalytics/releases/download/module_Reading_Progress_v0.1/module_Reading_Progress_v0.1.zip
      unzip ./module_Reading_Progress_v0.1.zip
    • Run the setup script like this (substitute "mysynapseworkspacename" with your synapse workspace name, which must be less than 13 characters and can only contain letters and numbers - e.g. syn-oea-cisd3v07kw1):
      ./module_Reading_Progress_v0.1/setup.sh mysynapseworkspacename) to install this package into your own environment.
  2. Run the Reading Progress module main pipeline template or the ReadingProgress_example notebook into your Synapse workspace to see the functionality of module assets.
    • It is recommended that you first run the module example notebook to understanding the methods of data processing, before running the pipeline. Although, running either the example notebook or the main pipeline accomplish the same processes.
  3. Verify that the module pipeline landed data into stage 1 and 2, and SQL and lake databases were created. See the module pipeline page for detailed instructions.
  4. Download the module Power BI template file. Module test data is already imported into the Power BI. See the module Power BI page page for details and instructions for switching the Power BI template data source, to import from your Synapse workspace data source.

Data Sources

This module imports digital activity on reading fluency for an education system.

See the module test data page for details on data format and contents.

Module Components

Out-of-the box assets for this OEA module include:

  1. Test Data: Artificially generated K-12 test data set, which supports the module pipeline and Power BI template. Test data matches the School Data Sync format. As well as, data and schema information under the Data folder
    • metadata.csv: Metadata CSV to support module data refining for relevant Insights tables.
  2. Pipeline Template: One main pipeline template which lands data into the data lake in Stage 1 (for raw data) and processes into the Stage 2 data lake (for structured, queryable data). Stage 2 data is then made available via a serverless SQL endpoint.
  3. Notebooks: Two sets of notebooks that can be used for either data exploration, or necessary for landing, schema cleaning, correction and refining data in the pipeline; notebooks are automatically installed upon running the setup script.
    • ReadingProgress_example.ipynb: A module example notebook that demonstrates the basic functions of landing raw test data to Stage 1, ingestion from Stage 1 to Stage 2/Ingested, schema correction to stage2/Ingested_Corrected, and refinement to Stage2/Refined.
    • Reading Progress Pipeline-Supporting Notebooks: Module-specific notebooks that clean the data, ingests the Insights tables, corrects table schemas, and refines the dataset (via data aggregation and transformation).
  4. PowerBI Template: Two PowerBI templates which explores data in a basic way. Screenshots of the PowerBI example template(s) are shown below.
    • One set of dashboards, relevant to the K-12 Insights test data.
    • There are two different formats of PowerBI files: one of which is pre-loaded with test data making it easy to quickly interact with data, and the other uses DirectQuery to query the data from your own Serverless SQL database. See instructions on the module PowerBI page to switch the dashboard data source to direct query from your Synapse workspace.
Dashboard Explanation Student Reading Fluency Summary

Additional Information

Resource Description
Reading Progress Product Guide Intro to Reading Progress and what it offers.
Reading Progress Course Take the Reading Progress course on MS Learn.
Demo Tenant for Reading Progress Get access to a demo tenant provisioning that comes with demo data and demo scripts for Reading Progress.
Overview of Microsoft Education Insights Intro to Education Insights, what it can do, and what it can provide.

Contributions from the Community

The Reading Progress module welcomes contributions.

This module was developed by Kwantum Analytics and Microsoft Education. The architecture and reference implementation for all modules is built on Azure Synapse Analytics - with Azure Data Lake Storage as the storage backbone, and Azure Active Directory providing the role-based access control.

Legal Notices

Microsoft and any contributors grant you a license to the Microsoft documentation and other content in this repository under the Creative Commons Attribution 4.0 International Public License, see the LICENSE file, and grant you a license to any code in the repository under the MIT License, see the LICENSE-CODE file.

Microsoft, Windows, Microsoft Azure and/or other Microsoft products and services referenced in the documentation may be either trademarks or registered trademarks of Microsoft in the United States and/or other countries. The licenses for this project do not grant you rights to use any Microsoft names, logos, or trademarks. Microsoft's general trademark guidelines can be found at http://go.microsoft.com/fwlink/?LinkID=254653.

Privacy information can be found at https://privacy.microsoft.com/en-us/

Microsoft and any contributors reserve all other rights, whether under their respective copyrights, patents, or trademarks, whether by implication, estoppel or otherwise.

Recommend Projects

  • React photo React

    A declarative, efficient, and flexible JavaScript library for building user interfaces.

  • Vue.js photo Vue.js

    🖖 Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.

  • Typescript photo Typescript

    TypeScript is a superset of JavaScript that compiles to clean JavaScript output.

  • TensorFlow photo TensorFlow

    An Open Source Machine Learning Framework for Everyone

  • Django photo Django

    The Web framework for perfectionists with deadlines.

  • D3 photo D3

    Bring data to life with SVG, Canvas and HTML. 📊📈🎉

Recommend Topics

  • javascript

    JavaScript (JS) is a lightweight interpreted programming language with first-class functions.

  • web

    Some thing interesting about web. New door for the world.

  • server

    A server is a program made to process requests and deliver data to clients.

  • Machine learning

    Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.

  • Game

    Some thing interesting about game, make everyone happy.

Recommend Org

  • Facebook photo Facebook

    We are working to build community through open source technology. NB: members must have two-factor auth.

  • Microsoft photo Microsoft

    Open source projects and samples from Microsoft.

  • Google photo Google

    Google ❤️ Open Source for everyone.

  • D3 photo D3

    Data-Driven Documents codes.