https://github.com/datamade/school-report-cards
Tools for parsing annual school report card data from the state of Illinois
https://github.com/datamade/school-report-cards
database illinois school school-report-cards
Last synced: over 1 year ago
JSON representation
Tools for parsing annual school report card data from the state of Illinois
- Host: GitHub
- URL: https://github.com/datamade/school-report-cards
- Owner: datamade
- License: mit
- Created: 2013-10-24T20:14:42.000Z (over 12 years ago)
- Default Branch: master
- Last Pushed: 2018-06-12T14:49:23.000Z (about 8 years ago)
- Last Synced: 2025-01-14T00:42:31.785Z (over 1 year ago)
- Topics: database, illinois, school, school-report-cards
- Language: Makefile
- Homepage:
- Size: 8.73 MB
- Stars: 10
- Watchers: 6
- Forks: 2
- Open Issues: 6
-
Metadata Files:
- Readme: README.md
- License: LICENSE.md
Awesome Lists containing this project
README
School Report Cards
===================
[](https://travis-ci.org/datamade/school-report-cards)[](https://travis-ci.org/datamade/school-report-cards)
Tools for parsing annual school report card data from the state of Illinois
## Requirements
* [GNU Make](https://www.gnu.org/software/make/)
* [GNU Wget](https://www.gnu.org/software/wget/)
* [Python 3](https://www.python.org/downloads/)
* [csvkit](https://csvkit.readthedocs.io/en/latest/tutorial/1_getting_started.html#installing-csvkit)
* [xlsx2csv](https://github.com/dilshod/xlsx2csv)
* [PostgreSQL](http://www.postgresql.org/)
* [unzip](http://www.info-zip.org/)
### Ubuntu
Most of these dependencies are installed by default
```
sudo apt-get install postgresql
pip install csvkit
pip install xlsx2csv
```
### Mac OS X
Most of these dependencies are installed by default
```
brew install postgresql
pip install csvkit
pip install xlsx2csv
```
## `make database`
You will need to run `createdb schools` to initialize the postgres database.
Running `make database` will import the data into
normalized tables in a postgresql database.
Right now, the database scripts only fully process the school-level
data that appears in all 22 years of data. These include:
* ACT Scores
* Demography and enrollment
* Time spent on subject
* Class sizes, by grade
* School level characteristics like parent involvement, truancy, and graduation rate.
## `make csv`
If you just wish to download the data without importing it into a database, run `make csv`. It will:
1. Download ISBE report card data from 1997-2015
2. Convert the fixed width files to csv format, with year-over-year normalized column names