Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/jaxgeller/high-school-recruits-analytics
An interactive experience analyzing the trajectory of high school basketball players.
https://github.com/jaxgeller/high-school-recruits-analytics
Last synced: 16 days ago
JSON representation
An interactive experience analyzing the trajectory of high school basketball players.
- Host: GitHub
- URL: https://github.com/jaxgeller/high-school-recruits-analytics
- Owner: jaxgeller
- License: mit
- Created: 2015-11-11T21:25:17.000Z (about 9 years ago)
- Default Branch: master
- Last Pushed: 2015-11-29T21:24:52.000Z (about 9 years ago)
- Last Synced: 2023-09-19T18:47:05.106Z (over 1 year ago)
- Language: JavaScript
- Homepage: https://jaxgeller.com/hs-bball-trajectory
- Size: 1.76 MB
- Stars: 5
- Watchers: 1
- Forks: 2
- Open Issues: 1
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# How Do High School Basketball Recruits Pan Out?
This is an interactive data visualization of the trajectory of high school recruits and their nba draft position. Check out the demo [here]().
In this repo you will find the [raw JSON data](https://github.com/jaxgeller/high-school-recruits-analytics/tree/master/data) for the visualization, the [scraper](https://github.com/jaxgeller/high-school-recruits-analytics/tree/master/scraper) used to gather this data, as well as the [frontend](https://github.com/jaxgeller/high-school-recruits-analytics/tree/master/www) for the chart.
### Dependencies
+ Make
+ Npm
+ Node.js v4+
+ Gulp
+ Python3
+ Pip3/Requests
+ Pip3/BeautifulSoup4
### Running the visualization
Run the following to compile and run the visualization, access it on `http://localhost:3000`
```sh
$ git clone https://github.com/jaxgeller/high-school-recruits-analytics
$ cd high-school-recruits-analytics
$ cd www && npm install
$ cd ../ && make build
```
### Gather the data
Data is included in this repo, but if you'd like to build from scratch run
```sh
$ make raw
```
This may take a while. It gathers data from different sources, 247 Sports (for HS rankings), Wikipedia (for draft data), and ESPN NBA (for stats and pictures).
After this is done, you'll need to transform the raw data into separate years for use with the sankey plot. Run
```sh
$ make format
```
This yields individual year datasets, as well as nodes and links for the sankey plot.
### Using the data
The data can be used and downloaded from the data directory in this repo.
Raw data is encoded as JSON and contains all the meta data about players.
If there is high enough demand, I can add a csv of the raw player data for use in other plots. Track [this](https://github.com/jaxgeller/high-school-recruits-analytics/issues/2) issue if interested.
### Contributing
All contributions are welcome. If there are issues with the site, data, or tools asociated with it, please open up an issue or submit a pull request.
### Special Thanks
I'd like to thank [Daniel Christian](https://twitter.com/DChris1123) for the write up on the data. He did an excellent job writing an anecdotal analysis focussing on some of the busts and booms.
I'd also like to thank [Chris Allen](https://twitter.com/cp_allen) for the amazing and beautiful design of the site.
### License
[MIT](https://github.com/jaxgeller/high-school-recruits-analytics/blob/master/LICENSE)