Metadata-Version: 2.4
Name: quantitas
Version: 1.2.0b3
Summary: A practical tool for calculations with physical units
Author: Gakuto
License-Expression: MIT
Project-URL: Repository, https://github.com/Gakuto8/Quantitas
Keywords: quantity,unit
Requires-Python: >=3.12
Description-Content-Type: text/markdown
License-File: LICENSE.txt
Dynamic: license-file

# Quantitas

## 概要
Quantitasは、煩雑な単位計算を手軽に実行するためのパッケージです。物理量に対して四則演算などの計算を行ったり、単位変換をしたりできます。また、本パッケージには、自然科学の分野でよく使われる単位や定数の多くがあらかじめ実装されており、ユーザーは自身で定義することなくこれらを使うことができます。

## インストール
```
pip install quantitas
```

## クイックスタート
例として、理想気体の状態方程式を使った計算をしてみましょう。
```python
import quantitas as qt
from quantitas.units import * #Quantitasが収録する全ての単位をインポート
from quantitas import R #気体定数をインポート

p = 1*atm_ #圧力 (1気圧)
V = 2.5*L_ #体積 (2.5 L)
T = 300*K_ #温度 (300 K)

n = p*V/(R*T) #物質量を計算
d = n/V #密度を計算

print(n)
#出力: 0.1015549697892018 mol
print(d)
#出力: 40.62198791568072 m^-3⋅mol
```
単位を表す変数名には末尾にアンダースコア (`_`) が付きます。気体定数`R`などのよく使われる定数の多くはあらかじめ定義されています。

上のサンプルコードのように物理量は`print`関数で表示することもできますが、物理量を出力するのに特化した`qrint`関数がおすすめです。
```python
from quantitas import qrint

qrint(d)
#出力: 40.62198791568072 m^-3⋅mol

qrint(d, [mol_, L_]) #単位を指定すると自動で変換されます
#出力: 0.04062198791568072 mol⋅L^-1

qrint([n, d]) #複数の物理量もまとめて出力できます
#出力: 0.1015549697892018 mol  40.62198791568072 m^-3⋅mol
```
単位はユーザーが定義することもできます。`give_symbol`関数を使うことで物理量に文字列の記号を与えることができます。
```python
kph_ = qt.give_symbol(km_/h_, "kph") #キロメートル毎時
qrint(340*m_/s_, kph_)
#出力: 1224.0 kph
```

## もっと詳しく
本パッケージには上で紹介しきれなかった機能や仕様がたくさんあります。Quantitasについてもっと知りたいと思った方は以下をご参照ください。
* [チュートリアル](https://github.com/Gakuto8/Quantitas/blob/main/docs/TUTORIAL.md)
* [仕様書](https://github.com/Gakuto8/Quantitas/blob/main/docs/REFERENCE.md)
* [定数と単位の一覧](https://github.com/Gakuto8/Quantitas/blob/main/docs/CONSTANTS_AND_UNITS.md)

## License
This project is licensed under the MIT License, see the LICENSE.txt file for details.
