japanize-matplotlib


Namejapanize-matplotlib JSON
Version 1.1.3 PyPI version JSON
download
home_pagehttps://github.com/uehara1414/japanize-matplotlib
Summarymatplotlibのフォント設定を自動で日本語化する
upload_time2020-10-21 10:20:37
maintainer
docs_urlNone
authoruehara1414
requires_python
licenseMIT License
keywords
VCS
bugtrack_url
requirements No requirements were recorded.
Travis-CI No Travis.
coveralls test coverage No coveralls. 
            [![PyPI version](https://badge.fury.io/py/japanize-matplotlib.svg)](https://badge.fury.io/py/japanize-matplotlib)
# japanize-matplotlib
matplotlib を日本語表示に対応させます

## 利用方法
matplotlibをimportした後、japanize_matplotlibをimportします。

```python
import matplotlib.pyplot as plt
import japanize_matplotlib

plt.plot([1, 2, 3, 4])
plt.xlabel('簡単なグラフ')
plt.show()
```


![demo](https://raw.githubusercontent.com/uehara1414/japanize-matplotlib/master/demo.png?token=AOnChuZIQchUxiL0U8qlW633FM-RMSuvks5bxW8zwA%3D%3D "demo")

## インストール
```sh
# pipenvで
pipenv install japanize-matplotlib

# またはpipで
pip install japanize-matplotlib
```

## 利用フォント
IPAフォントのIPAexゴシック(Ver.003.01)を利用しています。
利用にあたっては[IPAフォントライセンスv1.0](https://github.com/uehara1414/japanize-matplotlib/blob/master/japanize_matplotlib/fonts/IPA_Font_License_Agreement_v1.0.txt)に同意してください。

## FAQ
### import japanize_matplotlib したのに日本語表示になりません [#1](https://github.com/uehara1414/japanize-matplotlib/issues/1)
import japanize_matplotlib してから matplotlib でグラフを描画するまでにフォントの設定が変わる処理が入っていると、日本語表示がなされない可能性があります。

例えば、seaborn を利用している場合であれば sns.set() などで描画フォントが seaborn のデフォルトに上書きされ、日本語表示がされなくなります。

sns.set(font="IPAexGothic") のように利用フォントに IPAexGothic を設定するか、フォント上書き後に japanize_matplotlib.japanize() を利用するなどで日本語表示できるはずです。

### import のみして利用されないコードなのでフォーマッターに消されてしまいます
リンターなどの警告が気になる・コードを消される方向けに japanize_matplotlib.japanize() メソッドの実行でも import 時と同じくフォントを設定できるようになっています。
無意味な実行になりますが、時と場合に応じて実行してください。

もしくはリンターごとに無視させる設定をすることで対応できるはずです。# noqa などで設定してください。

### なぜインストール時は japanize-matplotlib で import 時は japanize_matplotlib なのですか？
チェインケースが読みやすく好きだからです。import時にはチェインケースは利用できないのでスネークケースになっています。

Raw data

            {
    "_id": null,
    "home_page": "https://github.com/uehara1414/japanize-matplotlib",
    "name": "japanize-matplotlib",
    "maintainer": "",
    "docs_url": null,
    "requires_python": "",
    "maintainer_email": "",
    "keywords": "",
    "author": "uehara1414",
    "author_email": "akiya.noface@gmail.com",
    "download_url": "https://files.pythonhosted.org/packages/aa/85/08a4b7fe8987582d99d9bb7ad0ff1ec75439359a7f9690a0dbf2dbf98b15/japanize-matplotlib-1.1.3.tar.gz",
    "platform": "",
    "description": "[![PyPI version](https://badge.fury.io/py/japanize-matplotlib.svg)](https://badge.fury.io/py/japanize-matplotlib)\n# japanize-matplotlib\nmatplotlib \u3092\u65e5\u672c\u8a9e\u8868\u793a\u306b\u5bfe\u5fdc\u3055\u305b\u307e\u3059\n\n## \u5229\u7528\u65b9\u6cd5\nmatplotlib\u3092import\u3057\u305f\u5f8c\u3001japanize_matplotlib\u3092import\u3057\u307e\u3059\u3002\n\n```python\nimport matplotlib.pyplot as plt\nimport japanize_matplotlib\n\nplt.plot([1, 2, 3, 4])\nplt.xlabel('\u7c21\u5358\u306a\u30b0\u30e9\u30d5')\nplt.show()\n```\n\n\n![demo](https://raw.githubusercontent.com/uehara1414/japanize-matplotlib/master/demo.png?token=AOnChuZIQchUxiL0U8qlW633FM-RMSuvks5bxW8zwA%3D%3D \"demo\")\n\n## \u30a4\u30f3\u30b9\u30c8\u30fc\u30eb\n```sh\n# pipenv\u3067\npipenv install japanize-matplotlib\n\n# \u307e\u305f\u306fpip\u3067\npip install japanize-matplotlib\n```\n\n## \u5229\u7528\u30d5\u30a9\u30f3\u30c8\nIPA\u30d5\u30a9\u30f3\u30c8\u306eIPAex\u30b4\u30b7\u30c3\u30af(Ver.003.01)\u3092\u5229\u7528\u3057\u3066\u3044\u307e\u3059\u3002\n\u5229\u7528\u306b\u3042\u305f\u3063\u3066\u306f[IPA\u30d5\u30a9\u30f3\u30c8\u30e9\u30a4\u30bb\u30f3\u30b9v1.0](https://github.com/uehara1414/japanize-matplotlib/blob/master/japanize_matplotlib/fonts/IPA_Font_License_Agreement_v1.0.txt)\u306b\u540c\u610f\u3057\u3066\u304f\u3060\u3055\u3044\u3002\n\n## FAQ\n### import japanize_matplotlib \u3057\u305f\u306e\u306b\u65e5\u672c\u8a9e\u8868\u793a\u306b\u306a\u308a\u307e\u305b\u3093 [#1](https://github.com/uehara1414/japanize-matplotlib/issues/1)\nimport japanize_matplotlib \u3057\u3066\u304b\u3089 matplotlib \u3067\u30b0\u30e9\u30d5\u3092\u63cf\u753b\u3059\u308b\u307e\u3067\u306b\u30d5\u30a9\u30f3\u30c8\u306e\u8a2d\u5b9a\u304c\u5909\u308f\u308b\u51e6\u7406\u304c\u5165\u3063\u3066\u3044\u308b\u3068\u3001\u65e5\u672c\u8a9e\u8868\u793a\u304c\u306a\u3055\u308c\u306a\u3044\u53ef\u80fd\u6027\u304c\u3042\u308a\u307e\u3059\u3002\n\n\u4f8b\u3048\u3070\u3001seaborn \u3092\u5229\u7528\u3057\u3066\u3044\u308b\u5834\u5408\u3067\u3042\u308c\u3070 sns.set() \u306a\u3069\u3067\u63cf\u753b\u30d5\u30a9\u30f3\u30c8\u304c seaborn \u306e\u30c7\u30d5\u30a9\u30eb\u30c8\u306b\u4e0a\u66f8\u304d\u3055\u308c\u3001\u65e5\u672c\u8a9e\u8868\u793a\u304c\u3055\u308c\u306a\u304f\u306a\u308a\u307e\u3059\u3002\n\nsns.set(font=\"IPAexGothic\") \u306e\u3088\u3046\u306b\u5229\u7528\u30d5\u30a9\u30f3\u30c8\u306b IPAexGothic \u3092\u8a2d\u5b9a\u3059\u308b\u304b\u3001\u30d5\u30a9\u30f3\u30c8\u4e0a\u66f8\u304d\u5f8c\u306b japanize_matplotlib.japanize() \u3092\u5229\u7528\u3059\u308b\u306a\u3069\u3067\u65e5\u672c\u8a9e\u8868\u793a\u3067\u304d\u308b\u306f\u305a\u3067\u3059\u3002\n\n### import \u306e\u307f\u3057\u3066\u5229\u7528\u3055\u308c\u306a\u3044\u30b3\u30fc\u30c9\u306a\u306e\u3067\u30d5\u30a9\u30fc\u30de\u30c3\u30bf\u30fc\u306b\u6d88\u3055\u308c\u3066\u3057\u307e\u3044\u307e\u3059\n\u30ea\u30f3\u30bf\u30fc\u306a\u3069\u306e\u8b66\u544a\u304c\u6c17\u306b\u306a\u308b\u30fb\u30b3\u30fc\u30c9\u3092\u6d88\u3055\u308c\u308b\u65b9\u5411\u3051\u306b japanize_matplotlib.japanize() \u30e1\u30bd\u30c3\u30c9\u306e\u5b9f\u884c\u3067\u3082 import \u6642\u3068\u540c\u3058\u304f\u30d5\u30a9\u30f3\u30c8\u3092\u8a2d\u5b9a\u3067\u304d\u308b\u3088\u3046\u306b\u306a\u3063\u3066\u3044\u307e\u3059\u3002\n\u7121\u610f\u5473\u306a\u5b9f\u884c\u306b\u306a\u308a\u307e\u3059\u304c\u3001\u6642\u3068\u5834\u5408\u306b\u5fdc\u3058\u3066\u5b9f\u884c\u3057\u3066\u304f\u3060\u3055\u3044\u3002\n\n\u3082\u3057\u304f\u306f\u30ea\u30f3\u30bf\u30fc\u3054\u3068\u306b\u7121\u8996\u3055\u305b\u308b\u8a2d\u5b9a\u3092\u3059\u308b\u3053\u3068\u3067\u5bfe\u5fdc\u3067\u304d\u308b\u306f\u305a\u3067\u3059\u3002# noqa \u306a\u3069\u3067\u8a2d\u5b9a\u3057\u3066\u304f\u3060\u3055\u3044\u3002\n\n### \u306a\u305c\u30a4\u30f3\u30b9\u30c8\u30fc\u30eb\u6642\u306f japanize-matplotlib \u3067 import \u6642\u306f japanize_matplotlib \u306a\u306e\u3067\u3059\u304b\uff1f\n\u30c1\u30a7\u30a4\u30f3\u30b1\u30fc\u30b9\u304c\u8aad\u307f\u3084\u3059\u304f\u597d\u304d\u3060\u304b\u3089\u3067\u3059\u3002import\u6642\u306b\u306f\u30c1\u30a7\u30a4\u30f3\u30b1\u30fc\u30b9\u306f\u5229\u7528\u3067\u304d\u306a\u3044\u306e\u3067\u30b9\u30cd\u30fc\u30af\u30b1\u30fc\u30b9\u306b\u306a\u3063\u3066\u3044\u307e\u3059\u3002",
    "bugtrack_url": null,
    "license": "MIT License",
    "summary": "matplotlib\u306e\u30d5\u30a9\u30f3\u30c8\u8a2d\u5b9a\u3092\u81ea\u52d5\u3067\u65e5\u672c\u8a9e\u5316\u3059\u308b",
    "version": "1.1.3",
    "project_urls": {
        "Homepage": "https://github.com/uehara1414/japanize-matplotlib"
    },
    "split_keywords": [],
    "urls": [
        {
            "comment_text": "",
            "digests": {
                "blake2b_256": "aa8508a4b7fe8987582d99d9bb7ad0ff1ec75439359a7f9690a0dbf2dbf98b15",
                "md5": "25965920fe1bdc622e6920a72da2e89e",
                "sha256": "e89e7d9e109820962650e59a130403b59b33915fde3871a265a5891d9bf5e079"
            },
            "downloads": -1,
            "filename": "japanize-matplotlib-1.1.3.tar.gz",
            "has_sig": false,
            "md5_digest": "25965920fe1bdc622e6920a72da2e89e",
            "packagetype": "sdist",
            "python_version": "source",
            "requires_python": null,
            "size": 4118887,
            "upload_time": "2020-10-21T10:20:37",
            "upload_time_iso_8601": "2020-10-21T10:20:37.049056Z",
            "url": "https://files.pythonhosted.org/packages/aa/85/08a4b7fe8987582d99d9bb7ad0ff1ec75439359a7f9690a0dbf2dbf98b15/japanize-matplotlib-1.1.3.tar.gz",
            "yanked": false,
            "yanked_reason": null
        }
    ],
    "upload_time": "2020-10-21 10:20:37",
    "github": true,
    "gitlab": false,
    "bitbucket": false,
    "codeberg": false,
    "github_user": "uehara1414",
    "github_project": "japanize-matplotlib",
    "travis_ci": false,
    "coveralls": false,
    "github_actions": false,
    "lcname": "japanize-matplotlib"
}
uehara1414
Elapsed time: 0.27010s