commit d6e72fe7d75922b65618264d250778aeabf37260
parent e0201e6177a9180bc05a6a7e372ed92d781cc629
Author: Amit Dutta <amitdutta4255@gmail.com>
Date: Sat, 28 Mar 2026 21:40:15 +0530
[2026-03-28] : .\{root} : Updated readme based on current state
Diffstat:
4 files changed, 110 insertions(+), 115 deletions(-)
diff --git a/README.md b/README.md
@@ -1,136 +1,60 @@
# <a href="https://github.com/notamitgamer/bsc">notamitgamer/bsc</a>
+## BSc Computer Science Honours (WBSU)
-This repository contains practice code and solutions for **WBSU assignments**.
-
-## License
-This project is licensed under the **MIT License**. See the [LICENSE](LICENSE) file or [opensource.org](https://opensource.org/license/mit) for full details.
+This repository serves as a comprehensive, live archive of my 4-year academic journey in Computer Science at [**Acharya Prafulla Chandra College (APC)**](https://apccollege.ac.in/). It contains practical implementations, assignments, and study materials following the WBSU curriculum.
---
-### Important Note for Students & Classmates
-While this code is public, academic integrity matters!
-
-* **Read & Learn:** You are encouraged to study the logic and understand the implementation.
-* **Don't Copy-Paste:** Using this code directly for your submissions may lead to plagiarism issues.
-* **Write Your Own:** The best way to learn is to understand the logic and then write it yourself from scratch.
-
-> **Challenge yourself: Learn the logic, then close this tab and write your own version.**
-
----
-🔗 **Website**
-For better viewing experience:
-[amit.is-a.dev/bsc](https://amit.is-a.dev/bsc) (Preferred) ***or*** [notamitgamer.github.io/bsc](https://notamitgamer.github.io/bsc)
+### Quick Links
+* **Live Portfolio:** [amit.is-a.dev](https://amit.is-a.dev)
+* **Web View:** [amit.is-a.dev/bsc](https://amit.is-a.dev/bsc)
+* **GitHub Profile:** [@notamitgamer](https://github.com/notamitgamer)
---
-# B.Sc. CS Hons – Programs
+## Roadmap and Progress
-This repository contains **Files of codes that will be done in this 4-year BSc Hons Computer Science**
+> [!NOTE]
+> I am currently in **Semester 1**. Folders for future semesters are placeholders and will be updated in real-time as the academic session progresses.
----
-## Contents
-
-* C Source Codes (`.c`)
+| Semester | Status | Primary Focus |
+| :--- | :--- | :--- |
+| [**Semester 1**](./Semester_1/) | Active | **C Programming**, **R** |
+| [**Semester 2**](./Semester_2/) | Pending | Upcoming |
+| [**Semester 3**](./Semester_3/) | Pending | Upcoming |
+| [**Semester 4**](./Semester_4/) | Pending | Upcoming |
+| [**Semester 5**](./Semester_5/) | Pending | Upcoming |
+| [**Semester 6**](./Semester_6/) | Pending | Upcoming |
+| [**Semester 7**](./Semester_7/) | Pending | Upcoming |
+| [**Semester 8**](./Semester_8/) | Pending | Upcoming |
---
-## How to Run
-
-```bash
-# Compile using GCC
-gcc program.c -o program.exe
+## Environment Setup
-# Run the executable
-./program.exe
-```
+### C and C++ Development
+1. **Download Compiler:** [MinGW64.zip (85 MB)](https://amit.is-a.dev/download/MinGW64.zip) or [**Original MinGW-w64 Executable**](https://github.com/notamitgamer/bsc/releases/tag/MinGW-2021-09-05)
+2. **Configuration:** Extract to `C:\MinGW64` and add `C:\MinGW64\bin` to your System Environment Variables.
+3. **Verification:** Run `gcc --version` in your terminal.
-### Example Program (Factorial)
-
-```c
-#include <stdio.h>
-int main() {
- int n, fact = 1;
- printf("Enter a number: ");
- scanf("%d", &n);
- for(int i=1; i<=n; i++) {
- fact *= i;
- }
- printf("Factorial = %d", fact);
- return 0;
-}
-```
+### R Programming
+> [!TIP]
+> Download and install **R** from [CRAN](https://cran.r-project.org/) and **RStudio** for the best development experience.
---
-## MinGW-w64 Installation Guide: Your C/C++ Compiler Setup
-
-This guide will walk you through the process of setting up your GCC/G++ compiler environment using the packaged MinGW-w64 distribution.
-
-### Step 1: Download the Compiler Archive
-
-Download the compressed MinGW-w64 files from the hosted location.
-
-> **Download Link:** [**Direct Download MinGW64.zip (85 MB)**](https://amit.is-a.dev/download/MinGW64.zip)
-
-> **Download Link:** [**Download the Original MinGW-w64 Executable (84.3 KB)**](https://github.com/notamitgamer/bsc/releases/tag/MinGW-2021-09-05)
-
-### Step 2: Extract the Files
-
-Once the download is complete, extract the contents of the `MinGW64.zip` file to a simple, root-level folder.
-
-1. **Extract the contents** of the Zip file.
-
-2. **Move the resulting folder** to a short, easy-to-reference path.
-
-3. **Recommended Path:** `C:\MinGW64`
-
-### Step 3: Add the Tools to Your System PATH
+## Academic Integrity
-Adding the `bin` directory to your PATH variable allows you to run `gcc` or `g++` from any terminal window without navigating to the installation folder every time.
-
-1. **Open System Settings:** Open the Start Menu and search for **"Edit the system environment variables"**.
-
-2. **Open Variables Window:** Click the **"Environment Variables..."** button.
-
-3. **Edit Path:** Under the **"System variables"** section, select the **`Path`** variable and click **"Edit..."**.
-
-4. **Add New Entry:**
-
- * Click **"New"**.
-
- * Paste the path to your installation's binary directory: `C:\MinGW64\bin`
-
-5. **Save Changes:** Click **`OK`** on all open windows to finalize the system changes.
-
-### Step 4: Verify the Installation
-
-To ensure the compiler is correctly set up and accessible, open a new command line session and run a simple check.
-
-1. **Open a NEW Terminal:** Close any existing Command Prompt or PowerShell windows, and open a fresh one.
-
-2. **Run the Test Command:** Type the following command:
-
- ```
- gcc --version
- ```
-
-3. **Expected Result:** If successful, you should see the version information for the GCC compiler (e.g., `gcc (MinGW.org GCC-6.3.0-1) 6.3.0`).
-
-> **Congratulations!** Your C/C++ development environment is now ready.
-
-> If you do not want to work that much, just go to this [website](https://www.programiz.com/c-programming/online-compiler) and run your programs.
+> [!IMPORTANT]
+> While this code is public for reference, academic integrity is a priority.
+> * **Understand the Logic:** Study the implementations to learn the underlying concepts.
+> * **Avoid Plagiarism:** Direct copy-pasting for college submissions is strongly discouraged.
+> * **Independent Implementation:** The best way to learn is to understand the logic and then rewrite it from scratch.
---
-
## Author
-
-### Amit Dutta
-
-* **amitdutta4255@gmail.com**
-* **mail@amit.is-a.dev**
-
-* [**GitHub Profile**](https://github.com/notamitgamer)
-* [**Portfolio**](https://amit.is-a.dev)
-
-----
\ No newline at end of file
+**Amit Dutta**
+* **Personal Email:** [amitdutta4255@gmail.com](mailto:amitdutta4255@gmail.com)
+* **Work Email:** [mail@amit.is-a.dev](mailto:mail@amit.is-a.dev)
+* **License:** [MIT](./LICENSE)+
\ No newline at end of file
diff --git a/Semester_1/README.md b/Semester_1/README.md
@@ -5,8 +5,78 @@
>
> **Current Status:**
> * **Actively Updated:** New code and materials are added following the college schedule.
-> * **Technologies:** Primarily focusing on **C Programming**, **R Programming**.
+> * **Technologies:** Primarily focusing on **C Programming** and **R Programming**.
>
> **Explore More:**
> * See my other projects on my [**Portfolio**](https://amit.is-a.dev/)
> * Follow my development journey on [**GitHub**](https://github.com/notamitgamer)
+
+---
+
+## Directory Structure
+
+To keep the repository organized, the C and R programs are divided into specific categories based on their origin and purpose.
+
+### C Programming
+* **`/assignment-primary/`**: Core college assignments and standard problems.
+* **`/assignment-secondary/`**: Additional or extended college assignments.
+* **`/internal-practice/`**: Code written for internal exam preparation.
+* **`/practice-c/`**: General, day-to-day C programming practice files.
+* **`/tuition-c/`**: Programs and problem-solving exercises completed during tuition classes (files prefixed with `APC-PRAC`, `APC-S`, etc.).
+* **`/EduInCS Exam/`**: Specific code solutions for exam papers organized by date.
+* **`/letusc/`**: Chapter-wise exercise solutions from the textbook *"Let Us C"*.
+* **`/khurapati-idea/`**: Experimental code, logical tests, and out-of-the-box ideas.
+
+### R Programming
+* **`/R/`**: Contains all R-related coursework, split into:
+ * `/Code/`: R script files (`.r`) for practicals.
+ * `/Material_PDF/`: Study materials and reference documents for R.
+
+---
+
+## How to Find a Specific Code
+
+1. **Identify the Category:** Determine if the code was an assignment, a textbook problem, or a tuition exercise, and navigate to the corresponding folder above.
+2. **Naming Convention:** Most files are sequentially numbered for easy tracking (e.g., `assignment-p-01.c`, `luc018.c`, `APC-PRAC-005.c`).
+3. **Internal Comments:** Open the file. Most source codes include a commented section at the top detailing the exact problem statement or logic being solved.
+
+---
+
+## How to Run the Programs
+
+### Running C Programs (`.c`)
+Ensure you have a C compiler (like GCC via MinGW) installed. If you haven't set it up, refer to the [Main Repository README](../README.md) for the installation guide.
+
+1. Open your terminal or command prompt.
+2. Navigate to the folder containing the specific program:
+
+ ```bash
+ cd Semester_1/assignment-primary
+ ```
+4. Compile the code using GCC:
+
+ ```bash
+ gcc assignment-p-01.c -o program.exe
+ ```
+6. Execute the compiled file:
+
+ ```bash
+ ./program.exe
+ ```
+
+### Running R Programs (`.r`)
+It is highly recommended to run R programs using RStudio for the best visual experience with data and plots.
+
+#### To run via command line:
+
+1. Open your terminal.
+2. Navigate to the R Code directory:
+
+ ```bash
+ cd Semester_1/R/Code
+ ```
+4. Execute the script using `Rscript`:
+
+ ```bash
+ Rscript R_Prac-1.r
+ ```+
\ No newline at end of file
diff --git a/Semester_1/assignment-primary/front_page.docx b/Semester_1/assignment-primary/front_page.docx
Binary files differ.
diff --git a/Semester_1/assignment-primary/front_page.pdf b/Semester_1/assignment-primary/front_page.pdf
Binary files differ.
