Metadata-Version: 2.4
Name: majoplot
Version: 0.1.18
Summary: Automates scenario-specific data preprocessing and plotting workflows for condensed-matter physics labs (OriginLab COM backend + Matplotlib for preview).
Project-URL: Homepage, https://github.com/ponyofshadows/majoplot
Project-URL: Source, https://github.com/ponyofshadows/majoplot
Project-URL: Issues, https://github.com/ponyofshadows/majoplot/issues
Author: ponyofshadows
License: MIT
License-File: LICENSE
Keywords: com,condensed-matter,materials-science,origin,originlab,plotting,ppms,vsm,xrd
Classifier: Intended Audience :: Science/Research
Classifier: License :: OSI Approved :: MIT License
Classifier: Operating System :: Microsoft :: Windows
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Programming Language :: Python :: 3.13
Classifier: Topic :: Scientific/Engineering :: Physics
Classifier: Topic :: Scientific/Engineering :: Visualization
Requires-Python: >=3.11
Requires-Dist: matplotlib>=3.8
Requires-Dist: numpy>=2.0
Requires-Dist: pywin32>=311; platform_system == 'Windows'
Description-Content-Type: text/markdown

English | [中文文档](https://github.com/ponyofshadows/majoplot/blob/master/README.zh-CN.md)

# majoplot

**Majoplot** is designed to automate repetitive data-processing tasks commonly encountered in **condensed-matter physics laboratories**.
Since figures generated by **Origin** can retain embedded data when pasted into PowerPoint slides—making it a convenient tool for data presentation—Majoplot uses **OriginLab as its primary plotting backend**.

---

## Main Features

* Preview raw data generated by instruments such as **VSM, PPMS, and XRD** within a single interface
* Batch-generate figures and automatically organize them into appropriate **Folders** inside an **OPJU project**

---

## Notes

This program **does not include OriginLab**.
To use OriginLab as the plotting backend, you must **obtain a valid OriginLab license** and **install OriginLab on your system** separately.

---

## Installation

Make sure **Python (including pip)** is installed on your system.

```bash
# (Not recommended) Install globally via pip
# pip install majoplot

# (Recommended) Install via uv
uv tool install majoplot
## If the uv tool script directory is not in your PATH, run:
## python -m uv tool install majoplot
```

---

## Usage

1. Open a command-line window in any directory and run the following command to launch the graphical interface:

```bash
# If installed globally via pip
# python -m majoplot

# If installed via uv
uv run majoplot
## If the uv tool script directory is not in PATH, run:
## python -m uv run majoplot
```

Then simply follow the instructions provided by the graphical user interface.