#CRS-TGWAC#
##About
CRS-TGWAC (Total Grade Weighted Average Computer) is a/an app/personal programming project by Joe Ferrer to help UPD students effectively and efficiently compute for their TGWA (Total GWA) and keep good track of their academic performance in the university. CRS-TGWAC is a project that aims to answer constant/consistent problems in other TGWACs which are unreliable due to inflexibility to changes at the CRS website, client-side dependencies, and computational errors derived from different sources. CRS-TGWAC simply asks for the user's CRS username and password and it automatically and securely (using a one time session-id/cookie) connects to the CRS website, accessing the html code of the user's grades and corresponding units taken, parsing that code, and coming up with a quick analysis, i.e a quick TGWA computation.
##Development
CRS-TGWAC is already functional at least to its minimum task of quickly computing a user's TGWA. Quick analysis grades-units correspondence/TGWA follows these rules:
- PE units and grades are not counted
2. Subjects with 'INC's without any grade are not counted
3. Subjects that are beyond a student's curriculum (i.e. student-added/personal electives) w/c the student took are still considered in the quick TGWA computation.
4. Quick TGWA Mathematical Formula:
> >Quick TGWA = Total (Units*Grade) >
> ------------------------------------------------------------
Total (Units)
As of the moment CRS-TGWAC is being developed/ debugged/ tested/ improved by the creator, Joe Ferrer, only. Comments/ Suggestions /Insights/ Conributions are very welcome.
Added Dev Notes:
CRS-TGWAC is programmed using the Python programming language partnered with a popular external html parsing library,BeautifulSoup. CRS-TGWAC is still under development and will have a more detailed analysis/ evaluation/ computation of a student's TGWA.
######TGWAC-Deeper-Analysis Feature (Existing)
- Showing all the subjects included in the computation
- Removing student-added/personal electives through user-input and list search for more accurate TGWA computation
- Assessing a user's candidacy for graduating with honors (only considering TGWAC and having satisfied minimum load/units per sem)
######TGWAC-Report Feature (Coming Soon)
- Publishing a formal document.
##Usage
In order to use CRS-TGWAC you must first download the ZIP file of this repository or pull this repository from github. Assuming you don't have python installed yet in your OS, you can download python by clicking this link. Choose the appropriate one for your OS. The preferred version is 2.7.X, X={0,...,9} but other versions higher than 2.6 will do. To install Python, just follow the installation instructions specified there. Next and last, you must install BeautifulSoup4 ,the external html parsing library used for parsing the html code accessed from the CRS website. BeautifulSoup4 can be downloaded at this link ,but is also available in this repository, located at the '_installs' directory. Just extract the compressed file and install by following the instructions here (Unix/Mac OS) or here (Windows OS)
When you're done dealing with the dependencies, just double click CRS.py or run it via your command prompt and all is well.