{"id":25138475,"url":"https://github.com/raeid-u/calculator-app","last_synced_at":"2025-04-03T03:18:51.444Z","repository":{"id":274742921,"uuid":"923927041","full_name":"Raeid-U/calculator-app","owner":"Raeid-U","description":"score/grade/mark calculator for students. leverages stdio to handle user interaction with business logic in cpp. ","archived":false,"fork":false,"pushed_at":"2025-01-29T04:57:14.000Z","size":10065,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-02-08T17:16:45.275Z","etag":null,"topics":["cpp","stdio"],"latest_commit_sha":null,"homepage":"","language":"C++","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/Raeid-U.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}},"created_at":"2025-01-29T04:44:21.000Z","updated_at":"2025-01-29T21:40:43.000Z","dependencies_parsed_at":"2025-01-29T05:37:16.551Z","dependency_job_id":null,"html_url":"https://github.com/Raeid-U/calculator-app","commit_stats":null,"previous_names":["raeid-u/calculator-app"],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Raeid-U%2Fcalculator-app","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Raeid-U%2Fcalculator-app/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Raeid-U%2Fcalculator-app/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Raeid-U%2Fcalculator-app/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/Raeid-U","download_url":"https://codeload.github.com/Raeid-U/calculator-app/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":246927841,"owners_count":20856198,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","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":["cpp","stdio"],"created_at":"2025-02-08T17:16:47.613Z","updated_at":"2025-04-03T03:18:51.420Z","avatar_url":"https://github.com/Raeid-U.png","language":"C++","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Student Grade Calculator\n\nThis program helps students calculate their final grades, GPA, and the required exam grades to achieve desired course outcomes. It provides an interactive terminal-based interface for easy input and computation.\n\n## Compilation\n\nTo compile the program, use the following command in your terminal:\n\n```bash\ng++ -o StudentCalculatorApp main.cpp FinalGradeCalculator.cpp GPACalculator.cpp RequiredExamGradeCalculator.cpp\n```\n\nThis command compiles the source files (`main.cpp`, `FinalGradeCalculator.cpp`, `GPACalculator.cpp`, `RequiredExamGradeCalculator.cpp`) and generates an executable named `StudentCalculatorApp`.\n\n## Running the Program\n\nAfter compiling, you can run the program with the following command:\n\n```bash\n./StudentCalculatorApp\n```\n\nThis command executes the compiled program and starts the student grade calculator.\n\n## Program Functions\n\nThe program offers three main functions:\n\n1. **Final Grade Calculator**\n2. **GPA Calculator**\n3. **Required Exam Grade Calculator**\n\n### Final Grade Calculator\n\nThis function calculates the final grade for a course based on the grades and weights of individual assignments.\n\n#### How It Works\n\n1. Prompts for the number of assignments.\n2. Collects the grade and weight for each assignment.\n3. Computes the weighted average to determine the final grade.\n\n#### Example\n\n```cpp\n// Pseudocode for clarity\nint numAssignments = 3;\nvector\u003cdouble\u003e grades = {85.0, 90.0, 75.0};\nvector\u003cdouble\u003e weights = {0.3, 0.3, 0.4};\ndouble finalGrade = calculateFinalGrade(grades, weights);\ncout \u003c\u003c \"Final Grade: \" \u003c\u003c finalGrade \u003c\u003c \"%\" \u003c\u003c endl;\n```\n\n#### Visual\n\n```\n ___________________________\n|                           |\n|   Final Grade Calculator  |\n|___________________________|\n\nEnter the number of assignments completed in the course: 3\nEnter the grade (as a percent) for assignment 1: 85\nEnter the weight for assignment 1: 30\nEnter the grade (as a percent) for assignment 2: 90\nEnter the weight for assignment 2: 30\nEnter the grade (as a percent) for assignment 3: 75\nEnter the weight for assignment 3: 40\nFinal Grade: 82%\n```\n\n### GPA Calculator\n\nThis function calculates the GPA (Grade Point Average) for a semester based on the final grades of individual courses.\n\n#### How It Works\n\n1. Prompts for the number of courses.\n2. Collects the final grade for each course.\n3. Computes the average grade and converts it to a GPA.\n\n#### Example\n\n```cpp\n// Pseudocode for clarity\nint numCourses = 4;\nvector\u003cdouble\u003e grades = {85.0, 90.0, 78.0, 88.0};\ndouble gpa = calculateGPA(grades);\ncout \u003c\u003c \"GPA: \" \u003c\u003c gpa \u003c\u003c endl;\n```\n\n#### Visual\n\n```\n ___________________________\n|                           |\n|      GPA Calculator       |\n|___________________________|\n\nEnter the number of courses: 4\nEnter the final grade (as a percent) for course 1: 85\nEnter the final grade (as a percent) for course 2: 90\nEnter the final grade (as a percent) for course 3: 78\nEnter the final grade (as a percent) for course 4: 88\nFinal Average: 85.25%\nGPA: 3.3\n```\n\n### Required Exam Grade Calculator\n\nThis function calculates the minimum grade needed on final assessments to achieve a desired overall course grade.\n\n#### How It Works\n\n1. Prompts for the current term grade.\n2. If applicable, collects the summative grade.\n3. Asks for the desired overall grade.\n4. Computes the required exam grade.\n\n#### Example\n\n```cpp\n// Pseudocode for clarity\ndouble termGrade = 80.0;\ndouble summativeGrade = 85.0;\ndouble desiredGrade = 90.0;\ndouble requiredExamGrade = calculateRequiredExamGrade(termGrade, summativeGrade, desiredGrade);\ncout \u003c\u003c \"Required Exam Grade: \" \u003c\u003c requiredExamGrade \u003c\u003c \"%\" \u003c\u003c endl;\n```\n\n#### Visual\n\n```\n ___________________________\n|                           |\n| Required Exam Calculator  |\n|___________________________|\n\nEnter your term grade (as a percentage): 80\nEnter your summative grade (as a percentage): 85\nEnter the desired grade in the course: 90\nTo achieve 90% in the course, you need to get 95% on the exam.\n```\n\n## Conclusion\n\nThe Student Grade Calculator is a tool that aids in computing final grades, GPA, and required exam grades through an intuitive terminal interface. This tool can be especially useful for students aiming to understand and track their academic performance.\n\n### Code Repository\n\nFor the complete source code and more details, visit the [GitHub repository](https://github.com/Raeid-U/calculator-app.git).\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fraeid-u%2Fcalculator-app","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fraeid-u%2Fcalculator-app","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fraeid-u%2Fcalculator-app/lists"}