Waveform Generator Project(dynasas_asg_part2_cpp)

This project is a Waveform Generator that supports both Sine Waves and Square Waves. Users can input parameters such as frequency, amplitude, and phase shift to generate and save waveforms in CSV format. The generated waveform can be visualized using Gnuplot.

Table of Contents

• Features
• Requirements
• Setup
• Usage
• Example Run
• Screenshots
• General Inforamtion

---

Features

• Generate Sine Wave or Square Wave data.
• Save waveform data as a CSV file.
• Plot the generated waveform using Gnuplot.
• Works on both Windows and Linux operating systems.

---

Requirements

Windows:

1. MinGW or any compatible GCC compiler for C++.
2. Gnuplot for Windows (Download from Gnuplot official site).
3. Ensure Gnuplot is added to the system's PATH.

Linux:

1. GCC or Clang (usually pre-installed).
2. Gnuplot (Install via package manager: sudo apt-get install gnuplot).

---

Setup

Windows:

1. Install MinGW:

   • Download from MinGW.
   • During installation, ensure G++ and make are selected.
   • Add the MinGW bin folder (e.g., C:\MinGW\bin) to the system's PATH.

2. Install Gnuplot:

   • Download and install Gnuplot for Windows.
   • Add Gnuplot's bin folder to the system's PATH.

3. Verify Installation: gnuplot --version g++ --version

4. Compile the Program: Open a terminal (PowerShell or Command Prompt) in the project directory:

   g++ main.cpp -I include -L lib -lwaves -o waveform_generator.exe
   

Linux:

1. Install GCC and Gnuplot:

    sudo apt update
    sudo apt install g++ gnuplot
   

2. Verify Installation: gnuplot --version g++ --version

3. Compile the Program: Open a terminal in the project directory

   g++ main.cpp -I include -L lib -lwaves -o waveform_generator.exe
   

Usage

Windows:

1. Open a terminal (Command Prompt or PowerShell) and navigate to the project directory:

   cd path\to\dynasas_asg_part2_cpp

2. Run the program:

   waveform_generator.exe

3. Follow the prompts to select a waveform type and input parameters
4. The generated waveform will be saved to waveform_output.csv & Gnuplot will automatically open to display the plot.

Linux:

1. Open a terminal (Command Prompt or PowerShell) and navigate to the project directory:

   cd path\to\dynasas_asg_part2_cpp

2. Run the program:

   ./waveform_generator.out

3. Follow the prompts to select a waveform type and input parameters
4. The generated waveform will be saved to waveform_output.csv & Gnuplot will automatically open to display the plot.

Example Run

Enter waveform type (sine/square): sine
Enter frequency (Hz): 5
Enter amplitude: 2
Enter phase shift (radians, optional - default 0): 0.5
Waveform saved to waveform_output.csv


Enter waveform type (sine/square): square
Enter frequency (Hz): 2
Enter amplitude: 2
Enter phase shift (radians, optional - default 0): 0.1
Waveform saved to waveform_output.csv

Screenshots

General Information

Frequency

• Frequency refers to the number of cycles a waveform completes per second, measured in Hertz (Hz).
• It determines the pitch of a sound wave (in audio applications).

Amplitude

• Amplitude is the maximum height or strength of the waveform from its equilibrium position.
• It represents the intensity or energy of the wave (e.g., loudness in sound).

Phase

• Phase refers to the initial angle of the waveform at the starting time (usually measured in radians).
• It determines the horizontal shift or displacement of the wave from its standard position.

Time Period

• The time period is the time taken for one complete cycle of the wave.
• It is the inverse of frequency

Sine Wave

• A sine wave is a smooth, continuous waveform representing periodic oscillations.
• Sine waves are common in natural phenomena such as sound waves and electrical signals.

Square Wave

• A square wave alternates between two levels (high and low) with an abrupt transition.
• It is commonly used in digital electronics and clock signals.
• Unlike sine waves, square waves are non-smooth and have sharp edges.