https://github.com/samson-mano/2d_contour_plotter
C# application for reading 2D data from CSV or TXT files and generating contour plots.
https://github.com/samson-mano/2d_contour_plotter
Last synced: 9 months ago
JSON representation
C# application for reading 2D data from CSV or TXT files and generating contour plots.
- Host: GitHub
- URL: https://github.com/samson-mano/2d_contour_plotter
- Owner: Samson-Mano
- License: mit
- Created: 2025-06-04T12:19:31.000Z (about 1 year ago)
- Default Branch: master
- Last Pushed: 2025-06-07T01:14:33.000Z (about 1 year ago)
- Last Synced: 2025-07-03T07:48:35.335Z (11 months ago)
- Language: C#
- Size: 3.08 MB
- Stars: 1
- Watchers: 0
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE.txt
Awesome Lists containing this project
README
# 2D Contour Plotter
**2D Contour Plotter** is a standalone C# software application that enables users to plot 2D contour plots directly from text or CSV files. Built with .NET 4.7 and the OxyPlot library, this tool works similarly to Matplotlib but runs natively on Windows without the need for any compilers or external dependencies like Python.
## Features
- **Standalone Application**: No need to install or configure compilers. Simply download and run the software on any Windows machine.
- **Quick and Easy Plotting**: Quickly generate 2D contour plots from CSV or TXT files containing multi-dimensional data.
- **Intuitive GUI**: User-friendly interface with simple file input and selection options for contour plotting.
- **Supports Multiple Data Types**: Plot single or multiple data columns (e.g., pressure, phase, etc.) with ease.
## Use Case
The software is ideal for users who need a quick, standalone solution for visualizing data in 2D contours. It’s perfect for engineers, scientists, or data analysts working with CSV or TXT data files and looking for a simple way to generate contour plots without the hassle of complex setup or scripting.
## How to Use
1. **Prepare your data**: The software reads CSV or TXT files with data formatted as follows:
- **Header**: The first row should contain column names (e.g., `x`, `y`, `z1`, `z2`, etc.).
- **Data**: Each subsequent row should contain numerical values separated by commas. You can have multiple columns for different `z` values (e.g., `Pressure_1`, `Phase_1`, etc.).
### Example Data 1 (Multiple `z` Values)
```csv
x,y,Pressure_1,Phase_1,Pressure_2,Phase_2,Pressure_3,Phase_3
-2.237,0.426,67.477,-1.027,16.950,-54.290,21.998,157.099
-2.237,1.278,79.329,0.961,19.298,-56.269,24.514,155.832
-2.237,2.130,93.536,2.507,21.856,-58.239,27.130,154.657
-2.237,2.983,109.999,3.370,24.527,-60.190,29.725,153.587
.....
..... etc
```
### Example Data 2 (Single z Value)
```csv
x,y,Pressure_1
-1.141,0.217,371.857
-1.141,0.652,454.944
-1.141,1.087,551.070
....
.... etc
```
2. **Load Your Data**:
- Click on the **Read CSV** or **Read TXT** button to load your file into the application.
- Select the appropriate **Z column** (e.g., `Pressure_1`, `Phase_1`, etc.) from the combo box.
3. **Plot the Contour**:
- After selecting the desired data column, click the **Plot** button to generate a 2D contour plot based on the input data.
4. **Download**:
- To use the software on any Windows machine, download the portable version by clicking the link below:
[Download 2D_Contour_Plotter Portable ZIP](2D_Contour_Plotter_portable_version.7z)
## Screenshots
Here is an example of the software interface and the contour plot it generates:
**1. GUI Interface**:
Click on the image to see the user interface of the software.
**2. Example Contour Plot**:
This is an example of the contour plot generated by the software based on sample data.
## Installation
1. Download the portable version from the link above.
2. Extract the contents of the ZIP file to a folder on your system.
3. Run the `2D_Contour_Plotter.exe` file to launch the software.
4. Follow the instructions under **How to Use** to generate your contour plots.
## Requirements
- Windows operating system (any version).
- No additional libraries or frameworks required beyond the .NET 4.7 framework, which is pre-installed on most systems.
## License
MIT License. See the [LICENSE](LICENSE) file for more information.