ncepst-exceltools 0.1.0__tar.gz

ncepst_exceltools-0.1.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 ncepst
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

ncepst_exceltools-0.1.0/PKG-INFO

@@ -0,0 +1,598 @@
+Metadata-Version: 2.4
+Name: ncepst-exceltools
+Version: 0.1.0
+Summary: Create and format native Excel charts using xlwings on Windows
+Author: ncepst
+License-Expression: MIT
+Project-URL: Repository, https://github.com/ncepst/PyExcelTools
+Project-URL: Issues, https://github.com/ncepst/PyExcelTools/issues
+Classifier: Development Status :: 4 - Beta
+Classifier: Operating System :: Microsoft :: Windows
+Classifier: Programming Language :: Python :: 3
+Classifier: Topic :: Office/Business
+Classifier: Topic :: Scientific/Engineering :: Visualization
+Requires-Python: >=3.10
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: xlwings
+Requires-Dist: pywin32; sys_platform == "win32"
+Dynamic: license-file
+
+## はじめに
+本ライブラリは、**Pythonで技術資料向けの Excel グラフの体裁を効率的に整える**ことを目的としています。  
+主に **XYプロット（散布図）** を対象としており、測定データやシミュレーションデータなど、繰り返しグラフ作成が必要となる用途を想定しています。   
+
+対象環境は Windows + Excel （Excel 2021 以降推奨）+ Python 3.10 以降 となります。  
+使用する主なライブラリは `xlwings` と `win32com` です。
+
+## 基本的な使い方
+
+### インストール方法
+
+```powershell
+pip install ncepst-exceltools
+```
+
+### 最新版への更新
+
+```powershell
+pip install --upgrade ncepst-exceltools
+```
+
+### 散布図を作成する
+
+```python
+import xlwings as xw
+from xlwings.constants import AxisType
+from win32com.client import constants
+import numpy as np
+import time
+import os
+from exceltools import ScatterChart, RGB
+
+# 計測開始
+t1 = time.time()
+
+SeriesName = "系列名"
+title = "タイトル"
+
+# ------------------------------------------------------------
+# path は適宜変更してください (Ctrl + Shift + C でパスのコピー)
+# ------------------------------------------------------------
+excel_path = r"C:\Users\*****\Desktop\test.xlsx"
+Sheet = "Sheet1"
+    
+# 指定のエクセルファイルがなければ作成する
+if not os.path.exists(excel_path):
+    wb = xw.Book()           # 新規Excelを開く
+    wb.save(excel_path)
+else:
+    wb = xw.Book(excel_path) # 既存のExcelを開く
+    
+# 指定のワークシートがなければ作成する
+if Sheet in [s.name for s in wb.sheets]:
+    ws = wb.sheets[Sheet]
+else:
+    ws = wb.sheets.add(Sheet)
+
+# エクセルの画面更新を無効にする
+wb.app.screen_updating = False
+
+# 上部に13行のセルを挿入する
+ws.range("1:13").insert("down")
+
+# デモデータ作成
+data = 19
+cell0 = np.linspace(-90, 90, data)
+cell1 = np.cos(np.deg2rad(cell0))
+cell = [cell0, cell1]
+
+# データの貼り付け
+ws.range(4,8).value = SeriesName
+ws.range(2,8).value = title
+for n in range(2):
+    for i in range(data):
+        ws.range(n+3,i+9).value = cell[n][i]
+        
+# 数値の表示桁数の変更
+for i in range(data):
+    ws.range(3, i+9).number_format = "0"    # 小数0桁まで
+for i in range(data):
+    ws.range(4, i+9).number_format = "0.00" # 小数2桁まで
+        
+# cell1を数式に変更したい場合
+for n in range(data):
+    col = 9 + n                          # 9=I列
+    col_letter = xw.utils.col_name(col)  # "I", "J", "K", ...
+    ws.range(4, col).value = f"=cos({col_letter}3/180*pi())"
+    ws.range(5, col).value = f"=cos({col_letter}3/180*pi())*1.01"
+
+chart1 = ScatterChart(ws = ws,
+                      start_range="H3",
+                      row = 3,
+                      col = data +1,
+                      paste_range="A1",
+                      width_cm=12.54, 
+                      height_cm=7.54,
+                      name = "",
+                      title = "",
+                      series_list = [{"color": RGB(68,114,196)}],
+                      x_title = "角度 (deg.)",
+                      x_min = -90,
+                      x_max = +90,
+                      x_major = 15,
+                      x_cross = -90,
+                      x_format = "0",
+                      y_format = "0.0",
+                      legend="",
+                      frame_color="",
+                      )  
+    
+# エクセルの画面更新を有効にする
+wb.app.screen_updating = True
+
+# エクセルファイルを保存する
+wb.save()
+
+# 計測終了
+t2 = time.time()
+elapsed_time = round(t2-t1,3)
+print("処理時間:"+str(elapsed_time)+" s")
+```
+
+### 選択中のグラフを修正する
+
+```python
+from exceltools import ModifyChart, RGB, add_shape, add_line, template
+import xlwings as xw
+import time
+
+# 計測開始
+t1 = time.time()
+
+wb = None
+try:
+    wb = xw.books.active
+    ws = wb.sheets.active
+    wb.app.screen_updating = False
+
+    import random
+    r = random.randint(0, 100)
+
+    chart = ModifyChart(title=f"タイトル{r}", width_cm=12, height_cm=8, title_space=0, x_major=15,
+                        NS=1, plot_area_space="absolute", height_inc=0,width_inc=0)
+
+    wb.app.screen_updating = True
+
+except Exception as e:
+    print("Error:",e)
+
+finally:
+    if wb is not None:
+        wb.app.screen_updating = True
+    
+# 計測終了
+t2 = time.time()
+elapsed_time = round(t2-t1,3)
+print("処理時間:"+str(elapsed_time)+" s")
+```
+
+### 複数グラフの一括変更
+
+```python
+import xlwings as xw
+from exceltools import BatchModifyCharts
+
+# アクティブシートの埋め込みグラフを変更
+charts = BatchModifyCharts(target="sheet", preset="std", width_cm=12)
+print(f"{len(charts)} 個のグラフを処理しました")
+
+# Ctrlを押しながら外枠を複数選択したグラフだけを変更
+BatchModifyCharts(target="selected", preset="excel2021")
+
+# アクティブブックの全ワークシートを対象に変更
+BatchModifyCharts(target="book", preset="no_grid", legend_font_size=12)
+
+```
+
+BatchModifyChartsにおいては、`NS=None`（既定）で各グラフの系列数を自動取得します。  
+`sheet`、`book`、`selected` モードでは、変更後のブックを自動保存しません。  
+必要に応じてExcelで保存してください。  
+`dir` モードのみ、処理後に上書き保存します。
+
+### フォルダ内のExcelファイルを一括変更
+
+`target="dir"` を指定し、`directory` に対象フォルダのパスを渡します。  
+以下のパスは、ご自身のフォルダに置き換えてください。  
+Windowsのパスは `r"..."` と書くと、バックスラッシュ（`\`）をそのまま指定できます。  
+
+```python
+from exceltools import BatchModifyCharts
+
+saved = BatchModifyCharts(
+    target="dir",
+    directory=r"C:\Users\ユーザー名\Documents\測定結果",
+    recursive=False,  # True: サブフォルダも対象
+    preset="grid",
+    width_cm=12,
+)
+
+for path in saved:
+    print("保存:", path)
+```
+
+`recursive=False`（既定）では指定フォルダ直下だけを処理します。  
+サブフォルダ内のファイルも対象にする場合は `recursive=True` を指定します。
+
+実行すると対象ファイルの一覧と、次の確認を表示します。
+
+```text
+上記ファイルの全てにグラフの書式設定を適用しますか？[yes/N] :
+```
+
+`yes` と入力すると実行します。`Yes`、`YES` も使用できます。  
+Enterのみ、`N`、`y` など、それ以外の入力ではファイルを開かず中止します。
+
+**dirモードは対象ファイルを上書き保存します。**
+
+対象は `.xlsx`、`.xlsm`、`.xlsb`、`.xls` の全ワークシート内の埋め込みグラフです。  
+`~$` で始まる一時ファイルを除外し、グラフがないブックは保存しません。
+
+専用のExcelを起動し、マクロ・イベント・リンク更新を無効にして処理します。  
+ファイルは処理後に閉じます。  
+戻り値は保存したファイルの絶対パス（Path）のリストです。
+
+エラーが発生した場合は対象パスを示して停止し、そのファイルは保存しません。  
+先に保存されたファイルの変更は残ります。
+
+### シート目次の作成・更新
+
+`create_sheet_index()` は、アクティブなExcelブックの先頭に「目次」シートを作成し、  
+各シートへのリンクと、各シートから「目次へ戻る」リンクを追加します。  
+対象のブックをExcelでアクティブにしてから実行してください。  
+
+```python
+from exceltools import create_sheet_index
+
+create_sheet_index()
+```
+
+**既存の「目次」シートは削除して作り直します。**  
+各シートの1行目に「目次へ戻る」リンク用の行を挿入します。  
+同名のリンクが既に1行目にあるシートには、行を追加しません。  
+1行目以外に「目次へ戻る」リンクがある場合は、見つかったリンクの行全体を削除してから1行目に追加します。  
+その行の他のデータも削除対象になるため、実行前に内容を確認してください。  
+処理後に完了ダイアログを表示します。上書き保存は行わないため、必要に応じてExcelで保存してください。
+
+## 背景
+Python から Excel グラフを作成する手段として、`openpyxl` や `xlwings` が利用できますが、    
+以下のような課題を感じていました。
+- Excel 上で手動作成したグラフと比べて、**書式が一致しないことが多い**
+- 技術資料用途では、**細かな体裁調整が多数必要**になる
+- `matplotlib` で作成した画像形式のグラフを貼り付ける方法では、  
+  Excel COM を介さないため処理速度の面でメリットはあるものの、  
+  Excel 上での再編集ができず、用途に合わないケースがある
+    
+また、Excel グラフの体裁を細かく調整するには多数のパラメータ指定が必要となり、  
+手軽に自動化プログラムへ組み込むことが難しいという問題もありました。
+
+そこで、**グラフ作成だけでなく書式設定までを含めて自動化プログラムに組み込めること**を目的として、  
+繰り返し利用可能な汎用関数としてコードを作成し、ライブラリとして公開しました。  
+
+これにより、技術資料作成や解析用途における作業効率の向上を図っています。  
+
+## 概要 
+
+グラフ書式設定パラメータは`PRESET`で管理しています。
+
+`PRESET` を追加・修正する場合は、インストール先の
+`ModifyChart.py`、`ScatterChart.py`内にある `PRESET` を編集してください。
+
+インストール先の例：
+
+```text
+C:\Users\ユーザー名\AppData\Local\Programs\Python\Python31*\Lib\site-packages\exceltools
+```
+
+実際のインストール先は、次のコードで確認できます。
+
+```python
+import exceltools
+
+print(exceltools.__file__)
+```
+
+※ ライブラリを更新・再インストールすると、直接編集した内容が上書きされる場合があります。
+
+## グラフ書式設定の指定方法
+
+グラフの書式設定の項目のうち、用途ごとに指定が必要な項目が関数の引数としてリスト化されています。  
+`ScatterChart` は `ws`、`start_range`、`paste_range` が必須引数です。
+`ModifyChart` は引数を省略すると、アクティブなグラフを対象にします。
+グラフオブジェクトを `chart` に直接指定することもできます。
+その他の任意引数で、書式などを設定します。
+
+また、`PRESET`は **dict形式** で関数外に定義されており、  
+外側の辞書のキー`"excel2021"`に、Excel 2021 の散布図の書式設定が格納されています。  
+各グラフ設定パラメータはネスト(入れ子)辞書として管理されており、必要に応じて上書き・変更が可能です。
+
+```python
+from exceltools import ModifyChart, RGB
+from exceltools.ModifyChart import PRESET
+
+PRESET["std"] = {
+    **PRESET["excel2021"],
+    "title_font_color": RGB(0, 0, 0),
+    "axis_title_font_color": RGB(0, 0, 0),
+    "axis_tick_font_color": RGB(0, 0, 0),
+}
+```
+上記のようにベースとなる設定を維持したまま一部を上書きすることで、  
+詳細な書式設定を定義できます。  
+関数の引数で`preset`を指定することができ、デフォルト引数では`preset="std"`が適用されます。
+
+呼び出し側でも、PRESETの更新が可能で、  
+以下では、グリッド線の表示設定を一時的に False に変更しています。  
+呼び出し側での変更は その Python セッション内で (スクリプトが終了するまで) 有効となります。  
+以下は設定変更の例です。`....` の部分には、必要な引数を指定してください。
+
+```python
+from exceltools import ScatterChart
+from exceltools.ScatterChart import PRESET
+
+PRESET["std"]["x_major_grid"] = False
+chart1 = ScatterChart(....)
+
+PRESET["std"]["x_major_grid"] = True
+chart2 = ScatterChart(....)
+```
+
+任意引数のうち、系列ごとの書式設定は `series_list = [{"name":"系列1"},{"name":"系列2"}, ...]`  
+で指定します。各系列は **dict形式** で定義し、系列をまとめてリスト`series_list`に格納します。
+
+`ModifyChart`を`series_list = None` で実行する場合には、  
+処理する系列数を関数の引数`NS`で指定してください。  
+デフォルト引数では`NS=1`となっています。
+`BatchModifyCharts`については`NS`の自動取得に対応しています。
+
+一方、`ScatterChart`では、`row` と `col` の値から`NS`が自動計算されます。  
+`row` や `col` が `None` の場合は、`start_range`の入力値から`.end('down').row` 等を使って自動取得されます。   
+`paste_range`ではグラフを貼り付ける左上の座標として、どのセルの左上を基準にするのかを指定します。
+
+### ModifyChart関数の引数説明
+```python
+def ModifyChart(chart: Any = "active",        # ExcelのChartオブジェクト
+                ws = None,                    # None (系列ごとにRange指定する場合のみWorksheetオブジェクトを指定)
+                preset = "std",               # プリセットスタイル名
+                width_cm = None,              # グラフ幅(cm), Noneで変更なし
+                height_cm = None,             # グラフ高さ(cm), Noneで変更なし
+                name = None,                  # グラフ名変更, Noneで変更なし
+                title: str|bool|None = None,  # タイトル文字列, Falseで無効化, Noneで変更なし
+                title_font_color = None,      # タイトルフォント色(RGB)
+                title_font_size = None,       # タイトルフォントサイズ
+                title_space = +0,             # タイトルとグラフの間隔(pt)
+                NS = 1,                       # データ系列数
+                series_list: list[dict]|None = None,  # 各系列の設定
+                style = None,                 # 線＋マーカーのスタイル
+                smooth = None,                # Trueで曲線、Falseで折れ線
+                marker = None,                # マーカー種類: "C":●, "S":■, "D":◆, "T":▲, "N":なし
+                alpha = None,                 # 線の透明度(0~1)
+                x_title: str|bool|None = None,# X軸タイトル文字列。Falseで無効化、Noneで変更なし
+                x_title_space = +0,           # プロットエリアを下側に広げる場合はマイナス
+                x_min: float|str|None = None, # X軸最小値, "auto"で自動調整, Noneで変更なし
+                x_max: float|str|None = None, # X軸最大値, "auto"で自動調整, Noneで変更なし
+                x_major: float|None = None,   # X軸主目盛間隔, Noneで変更なし, グリッド線表示設定はPRESET
+                x_minor: float|None = None,   # X軸副目盛間隔, Noneで変更なし, グリッド線表示設定はPRESET
+                x_cross = None,               # Y軸との交差位置, Noneで変更なし
+                x_format = None,              # X軸表示形式 ("0.00", "0.0E+00", "0%" など), Noneで変更なし
+                x_log: bool|None = None,      # Trueで対数表示, Noneで変更なし
+                y_title: str|bool|None = None,# Y軸タイトル, Noneで変更なし
+                y_title_space = +0,           
+                y_min: float|str|None = None,  
+                y_max: float|str|None = None,  
+                y_major: float|None = None,    
+                y_minor: float|None = None,    
+                y_cross = None,                    # X軸との交差位置, Noneで変更なし        
+                y_format = None,              
+                y_log: bool|None = None,       
+                y2_title: str|bool|None = None,    # Y軸タイトル文字列, Falseで無効化, Noneで変更なし
+                y2_min: float|str|None = None,
+                y2_max: float|str|None = None,
+                y2_major: float|None = None,
+                y2_minor: float|None = None,
+                y2_format = None,
+                y2_log: bool|None = None,       
+                frame_color: bool|int|None = None, # グラフ枠色 (False:枠なし, 0:黒枠, Noneでpreset)
+                legend: bool|str|None = None,      # 凡例表示(False:非表示, Noneで変更なし, "right"で右側に表示) 
+                legend_font_size = None,           # 凡例のフォントサイズ, Noneで変更なし
+                legend_width_inc = 0,              # 凡例ボックスの幅増減(pt)
+                legend_height_inc = 0,             # 凡例ボックスの高さ増減(pt)
+                legend_right_space = 0,            # 凡例の右端 = プロットエリアの右端を基準とした凡例位置制御
+                legent_top_space = 0,              # 凡例の上端 = プロットエリアの上端を基準とした凡例位置制御
+                transparent_bg: bool|None = None,  # 背景を透明化する場合はTrue
+                chart_type = None,                 # "bar"で棒グラフに変更
+                x_bold_line: float|None = None,    # x_bold_line=0でx=0が太線
+                y_bold_line: float|None = None,    # y_bold_line=0でy=0が太線
+                plot_area_space: str = "relative", # プロットエリア調整時の基準位置を"absolute"/"relative"で指定
+                width_inc = 0,                     # プロットエリアの幅増減(pt)
+                height_inc = 0,                    # プロットエリアの高さ増減(pt)
+                right_space = 0,                   # plot_area_space="abs"のときの右のスペース指定
+                ):
+```
+- 型ヒントには `Python 3.10 以降`の記法を使用しています。
+  
+- `smooth`、`alpha`、`marker` の優先順位は、`series_list` の各系列の設定 > 関数の引数 > `PRESET` です。
+  各系列や関数の引数で指定しない場合(Noneの場合)は、`PRESET` の設定を使用します。
+
+- 線の太さは、`series_list` の各系列の `weight` で指定できます。
+  指定しない場合は、`PRESET` の `line_weight` を使用します。
+  `line_weight` は関数の引数ではありません。
+ 
+- `ScatterChart`関数の場合には、上記の引数: `NS`、`chart`の代わりに、  
+必須引数:`start_range`、`paste_range`、 任意引数:`row`、`col` が加わって、`ws`は必須引数に変わります。  
+戻り値はChartオブジェクトとなります。
+
+- `title`、`x_title`、`y_title`、`y2_title`、`legend`には文字列を入力できる他に、`False`で無効化を指定できます。  
+  `frame_color`には整数(RGB値)を入力できる他に、`False`で外枠の無効化を指定できます。  
+
+- `legend`の仕様   
+  `legend="TR+bw+fb"`のようにポジションとオプションを指定できます。順不同で複数指定可能です。  
+  `legend="right"`では、プロットエリアの右に凡例を配置します。オプションも利用可能です。
+   ```
+    Position:  (プロットエリア基準)
+      Vertical  : T = Top,    B = Bottom  
+      Horizontal: L = Left,   R = Right,   C = Center 
+  
+    Options:  
+      bw : background white (背景を白)  
+      fb : frame black      (枠を黒)  
+      tb : text black       (テキストを黒)
+   ```
+   
+- `chart_type = "bar"` を指定すると、集合縦棒グラフ (`xlColumnClustered`) が表示されます。   
+  ただしこの場合、内部処理でtry構文の例外が発生し、グリッド線の設定・軸のフォント設定には未対応です。
+  
+- 引数で `chart_type = "line"`を指定し、そのうち一部の系列の chart_type を "bar" にすると、  
+  棒グラフ+折れ線グラフの組み合わせグラフ を表示できます。(グリッドと軸の設定はできません)
+
+### series_listで指定可能なkeyとそのデフォルト値
+以下から任意のkeyのみ設定可能です。
+```python
+series_list = [
+    {
+        "name": "系列1",               # 系列名
+        "color": RGB(68,114,196),     # 色
+        "style": "line+marker",       # スタイル
+        "marker": "C",                # マーカー: "C":●, "S":■, "D":◆, "T":▲
+        "size": 5,                    # マーカーサイズ
+        "weight": 1.5,                # 線の幅 (pt)
+        "smooth": True,               # 曲線(True) or 折れ線(False)
+        "alpha": None,                # 線の透明度(0~1), デフォルト None
+        "axis": "primary",            # "y2"で副軸
+        "XValues":None,               # 系列のXの値(ExcelのRange指定)
+        "Values":None,                # 系列のYの値(ExcelのRange指定)
+        "sheet":None,                 # 系列のデータがあるシート名
+        "chart_type": None,           # グラフ種類の変更(デフォルトは散布図)
+        "trendline": None,            # 近似曲線
+        "trendline_name":None,        # 近似曲線の名前
+        "trendline_color":None,       # 近似曲線の色
+        "trendline_weight":None,      # 近似曲線の太さ
+        "trendline_style":None,       # 近似曲線のDashstyle(solid,dash)
+        "trendline_option": None,     # 近似曲線オプション("eq+r2")
+        "legend":None,                # 系列を凡例に入れるか選択
+        "data_label":None             # データラベルの表示
+    },
+]
+```
+### サブ関数
+`ModifyChart.py`には、`add_shape`、`add_line`、`template`の3つの関数が、  
+メイン関数`ModifyChart` とは独立に定義されており、  
+`from exceltools import ModifyChart, RGB, add_shape, add_line, template` のようにインポートして使います。  
+- `add_shape`: `chart`のプロットエリアに、帯(長方形)、注釈用のテキストボックスを追加します。  
+- `add_line` : `chart`のプロットエリアに、線もしくは破線を追加します。  
+- `template` : グラフテンプレート機能を利用します。(テンプレートとして保存した`.crtx`ファイルを使います)
+
+詳細な使い方は、`ModifyChart.py` の各関数定義の下にある docstring をご参照ください。
+
+また、`template`関数があればメイン関数を使わず、手軽にテンプレートを適用できますが、  
+`.crtx`ファイルから**書式設定のパラメータを直接確認、編集することはできません。**
+
+本ライブラリのコードでは、  
+●　数値的に Excel グラフを制御できること  
+●　書式設定パラメータを一覧化し、コード上で管理できること  
+が利点と考えています。
+
+### PRESET["excel2021"] 一覧
+```python
+PRESET = {
+    # "Aptos Narrow 本文"は Excel 2021以降のみ
+    "excel2021": {
+        "title_font_size": 14,
+        "title_font_color": RGB(89,89,89),
+        "title_font_bold": False,
+        "title_font_name": "Aptos Narrow 本文",
+        "axis_title_font_size": 10,
+        "axis_title_font_name": "Aptos Narrow 本文",
+        "axis_title_font_color": RGB(89,89,89),
+        "axis_title_font_bold": False,
+        "axis_tick_font_color": RGB(89, 89, 89),
+        "axis_tick_font_size": 9,
+        "axis_tick_font_name": "Aptos Narrow 本文",
+        "axis_line": True,
+        "axis_line_color": RGB(191, 191, 191),
+        "axis_line_weight": 0.75,    
+        "x_major_grid": True,
+        "y_major_grid": True,
+        "x_minor_grid": None,
+        "y_minor_grid": None,
+        "major_grid_color": RGB(217, 217, 217),
+        "major_grid_weight": 0.75,
+        # TickMark: None, Inside, Outside, Cross
+        "x_major_tickmark": constants.xlTickMarkNone,  # 目盛の内向き/外向きなし
+        "y_major_tickmark": constants.xlTickMarkNone,
+        "x_minor_tickmark": None,
+        "y_minor_tickmark": None,
+        # 外枠の有無は引数で指定してください
+        "frame_color": RGB(217,217,217),
+        "frame_weight": 0.75,
+        "plot_area_frame": None,
+        "plot_area_frame_color": RGB(0,0,0),
+        "plot_area_frame_weight": 1.0,
+        "style": "line+marker",
+        "smooth": True,
+        "alpha": None,
+        "line_weight": 1.5,
+        "marker": "C",
+        "markersize": 5,
+        "y2_major_grid": False,  # 副軸グリッド表示なし
+        "y2_minor_grid": False,
+        "y2_major_tickmark": constants.xlTickMarkNone,
+        "y2_minor_tickmark": None,
+    },
+}
+```
+### 補足
+- 透明度(0～1)の`alpha`は`matplotlib`由来です。  
+- 線の太さ`line_weight`はExcel COM のプロパティ名`Line.Weight`に由来します。 
+  (matplotlibでは`linewidth`)  
+- マーカーの種類(`"C","S","D","T","N"`)は頭文字に由来します。
+  (matplotlibの`"o","s","^"`などは使えません)  
+- スタイル(`style`)は、以下の指定に対応しています。  
+ `"line+marker"`、`"line"`(ラインのみ)、`"marker"`(マーカーのみ)、`"dash"`(破線)、`"dash+marker"`など    
+  また、`matplotlib`由来の表記`"--"`や`"-."`も使用可能です。  
+  (破線は上記2種類のみ対応しています)  
+- 関数の引数が多いため、同じ引数を二度渡さないよう注意してください。  
+  (二重指定すると `SyntaxError` になります)
+- 系列の色指定については`RGB(r,g,b)`の他に、以下の文字列でも指定できます。
+```python
+COLOR_NAME_TO_RGB = {
+              "blue": RGB(68,114,196),
+              "orange":RGB(237,125,49),
+              "green":RGB(112,173,71),
+              "yellow":RGB(255,192,0),
+              "purple":RGB(112,48,160),
+              "brown":RGB(192,0,0),
+              "navy":RGB(0,32,96),
+              "gray":RGB(165,165,165),
+              "teal":RGB(0,128,128),
+              "cyan": RGB(0,255,255),
+              "magenta": RGB(255,0,255),
+              }
+```
+
+## 関連リンク
+
+**Qiita 投稿記事**
+
+[Python xlwings でエクセルグラフの体裁調整を自動化](https://qiita.com/ncepst/items/54c63974242bb9e18c23)
+
+**VBA連携**
+
+[PythonFromVBA.bas](https://github.com/ncepst/PyExcelTools/blob/main/PythonFromVBA.bas)
+
+Pythonスクリプトは Excelマクロから実行することもでき、マクロにショートカットキーを割り当てると便利です。  
+VBAコードには、自動判定の範囲 または 選択範囲 でグラフを作成するマクロも含まれており、柔軟な運用が可能です。
+
+## License
+MIT License  
+Copyright (c) 2025 ncepst