{"id":29570188,"url":"https://github.com/utkarshthedev/12thproject","last_synced_at":"2026-02-25T23:33:27.143Z","repository":{"id":304695727,"uuid":"1019644064","full_name":"UtkarshTheDev/12thProject","owner":"UtkarshTheDev","description":null,"archived":false,"fork":false,"pushed_at":"2025-12-28T16:21:03.000Z","size":467,"stargazers_count":1,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2025-12-31T04:51:02.689Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/UtkarshTheDev.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2025-07-14T16:39:33.000Z","updated_at":"2025-12-28T16:21:06.000Z","dependencies_parsed_at":"2025-07-14T21:29:33.597Z","dependency_job_id":"28e8e939-ca4a-4144-ab2f-f63c25cf06d1","html_url":"https://github.com/UtkarshTheDev/12thProject","commit_stats":null,"previous_names":["utkarshthedev/12thproject"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/UtkarshTheDev/12thProject","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/UtkarshTheDev%2F12thProject","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/UtkarshTheDev%2F12thProject/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/UtkarshTheDev%2F12thProject/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/UtkarshTheDev%2F12thProject/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/UtkarshTheDev","download_url":"https://codeload.github.com/UtkarshTheDev/12thProject/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/UtkarshTheDev%2F12thProject/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":29844876,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-02-25T22:37:40.667Z","status":"ssl_error","status_checked_at":"2026-02-25T22:37:25.960Z","response_time":61,"last_error":"SSL_read: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":[],"created_at":"2025-07-19T02:34:47.058Z","updated_at":"2026-02-25T23:33:27.137Z","avatar_url":"https://github.com/UtkarshTheDev.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Result Analysis (Class 12th CS Project)\n\nA comprehensive Python application designed to analyze, manage, and visualize student examination results from Excel sheets. This project parses raw result data, organizes it, and provides tools for statistical analysis and graphical representation.\n\n\u003e Idea Given By Mam\n\n## Features\n\n- **📂 Excel Data Import:** Seamless parsing of result sheets with automatic detection of subjects, marks, and student details. Supports fuzzy search to quickly find Excel files in the directory.\n- **📊 Data Visualization:** Generate insights using Bar Charts, Line Charts, and Scatter Plots to analyze class performance.\n- **📈 Statistical Analysis:** Automatically calculates percentages and totals. Groups students based on custom or default percentage thresholds.\n- **💾 Organized Storage:** Keeps processed data structured by Class and Exam name in a local `user-data` database (CSV format).\n- **🖥️ Interactive Interface:** Features a user-friendly CLI menu with support for keyboard navigation (using `curses`) and a compatibility mode for standard terminals.\n- **🗑️ Data Management:** Built-in tools to view and safely delete old class or exam records.\n\n## Requirements\n\nEnsure you have Python installed. The project relies on the following external libraries:\n\n- `pandas` (Data manipulation)\n- `numpy` (Numerical operations)\n- `matplotlib` (Plotting graphs)\n- `thefuzz` (Fuzzy string matching for file search)\n- `openpyxl` (Excel file reading backend)\n\n## Installation\n\nYou can install the package easily using pip:\n\n```bash\npip install result-analysis\n```\n\n### From Source\n1. Clone this repository.\n2. Navigate to the project directory.\n3. Install using pip:\n\n   ```bash\n   pip install .\n   ```\n\n   For development (editable mode), use:\n   ```bash\n   pip install -e .\n   ```\n\n   *Note: Windows users might need `windows-curses` for the full UI experience.*\n\n## Usage\n\nOnce installed, you can run the application from anywhere using the main command or its shortcuts (`rsa`, `rta`):\n\n```bash\nresult-analysis\n# OR\nrsa\n# OR\nrta\n```\n\n### Download Samples\nTo download sample Excel files for testing:\n```bash\nrsa download samples\n```\nThis will create a `samples/` folder in your current working directory containing test data (`IIIA.xlsx`, etc.).\n\n### Running the App\nAlternatively, you can run it as a Python module:\n\n```bash\npython -m main\n```\n\n1. Place your raw Result Excel files (`.xlsx`) in the directory where you are running the command.\n2. Follow the on-screen menu to:\n   - **Upload:** Select and process an Excel file.\n   - **Group:** Create summary statistics based on percentage ranges.\n   - **View:** Display result tables in the terminal.\n   - **Plot:** Visualize the data.\n   - **Delete:** Remove unwanted data.\n\n## Project Structure\n\n- `main.py`: Entry point.\n- `data/`: Data parsing and handling logic.\n- `ui/`: User interface components.\n- `graphs/`: Plotting and visualization logic.\n- `group/`: Grouping logic.\n- `user-data/`: Automatically generated directory where processed CSV files are stored, organized by Class and Exam.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Futkarshthedev%2F12thproject","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Futkarshthedev%2F12thproject","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Futkarshthedev%2F12thproject/lists"}