cm-chart 1.0.0__tar.gz

cm_chart-1.0.0/PKG-INFO

@@ -0,0 +1,39 @@
+Metadata-Version: 2.4
+Name: cm_chart
+Version: 1.0.0
+Summary: 计算概论C课程中文图表快捷输出工具
+Author: Chen Mo
+Author-email: chenmoemail@126.com
+Classifier: Programming Language :: Python :: 3
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Operating System :: OS Independent
+Classifier: Natural Language :: Chinese (Simplified)
+Classifier: Intended Audience :: Education
+Requires-Python: >=3.8
+Description-Content-Type: text/markdown
+Requires-Dist: matplotlib>=3.5
+Dynamic: author
+Dynamic: author-email
+Dynamic: classifier
+Dynamic: description
+Dynamic: description-content-type
+Dynamic: requires-dist
+Dynamic: requires-python
+Dynamic: summary
+
+# cm_chart
+
+中文图表快捷输出工具。它不替代 `matplotlib`，而是帮学生先解决中文字体、常见图表和保存图片。
+
+```bash
+pip install cm_chart
+```
+
+```python
+import cm_chart
+
+fig, ax = cm_chart.bar(['苹果', '香蕉', '梨'], [12, 8, 15], title='水果销量')
+cm_chart.save(fig, '水果销量.png')
+```
+
+所有画图函数都会返回 `fig, ax`，学生可以继续用原生 `matplotlib` 修改细节。

cm_chart-1.0.0/README.md

@@ -0,0 +1,16 @@
+# cm_chart
+
+中文图表快捷输出工具。它不替代 `matplotlib`，而是帮学生先解决中文字体、常见图表和保存图片。
+
+```bash
+pip install cm_chart
+```
+
+```python
+import cm_chart
+
+fig, ax = cm_chart.bar(['苹果', '香蕉', '梨'], [12, 8, 15], title='水果销量')
+cm_chart.save(fig, '水果销量.png')
+```
+
+所有画图函数都会返回 `fig, ax`，学生可以继续用原生 `matplotlib` 修改细节。

cm_chart-1.0.0/cm_chart/__init__.py

@@ -0,0 +1,6 @@
+"""cm_chart - 中文图表快捷输出工具。"""
+
+from .core import setup_chinese_font, bar, line, pie, wordfreq_bar, grade_distribution, save
+
+__version__ = '1.0.0'
+__all__ = ['setup_chinese_font', 'bar', 'line', 'pie', 'wordfreq_bar', 'grade_distribution', 'save']

cm_chart-1.0.0/cm_chart/core.py

@@ -0,0 +1,89 @@
+from collections import Counter
+
+
+def _plt():
+    import matplotlib.pyplot as plt
+    setup_chinese_font()
+    return plt
+
+
+def setup_chinese_font():
+    """尽量设置常见中文字体，减少中文乱码。"""
+    import matplotlib.pyplot as plt
+    plt.rcParams['font.sans-serif'] = [
+        'Arial Unicode MS',
+        'SimHei',
+        'Microsoft YaHei',
+        'Noto Sans CJK SC',
+        'PingFang SC',
+        'Heiti SC',
+    ]
+    plt.rcParams['axes.unicode_minus'] = False
+
+
+def bar(labels, values, title='', xlabel='', ylabel='', color='#4C78A8'):
+    """画柱状图，返回 fig, ax。"""
+    plt = _plt()
+    fig, ax = plt.subplots(figsize=(8, 4.5))
+    ax.bar(labels, values, color=color)
+    ax.set_title(title)
+    ax.set_xlabel(xlabel)
+    ax.set_ylabel(ylabel)
+    fig.tight_layout()
+    return fig, ax
+
+
+def line(x, y, title='', xlabel='', ylabel='', color='#F58518', marker='o'):
+    """画折线图，返回 fig, ax。"""
+    plt = _plt()
+    fig, ax = plt.subplots(figsize=(8, 4.5))
+    ax.plot(x, y, color=color, marker=marker)
+    ax.set_title(title)
+    ax.set_xlabel(xlabel)
+    ax.set_ylabel(ylabel)
+    fig.tight_layout()
+    return fig, ax
+
+
+def pie(labels, values, title=''):
+    """画饼图，返回 fig, ax。"""
+    plt = _plt()
+    fig, ax = plt.subplots(figsize=(6, 6))
+    ax.pie(values, labels=labels, autopct='%1.1f%%')
+    ax.set_title(title)
+    fig.tight_layout()
+    return fig, ax
+
+
+def wordfreq_bar(wordfreq, n=20, title='词频统计'):
+    """画词频柱状图。wordfreq 可以是字典或 [(词, 次数), ...]。"""
+    items = wordfreq.items() if isinstance(wordfreq, dict) else wordfreq
+    top = sorted(items, key=lambda item: item[1], reverse=True)[:n]
+    labels = [item[0] for item in top]
+    values = [item[1] for item in top]
+    return bar(labels, values, title=title, xlabel='词语', ylabel='次数')
+
+
+def grade_distribution(scores, title='成绩分布'):
+    """画成绩分布柱状图。"""
+    bands = Counter()
+    for score in scores:
+        score = float(score)
+        if score >= 90:
+            bands['90-100'] += 1
+        elif score >= 80:
+            bands['80-89'] += 1
+        elif score >= 70:
+            bands['70-79'] += 1
+        elif score >= 60:
+            bands['60-69'] += 1
+        else:
+            bands['0-59'] += 1
+    labels = ['90-100', '80-89', '70-79', '60-69', '0-59']
+    return bar(labels, [bands[label] for label in labels], title=title, xlabel='分数段', ylabel='人数')
+
+
+def save(fig, filename, dpi=160):
+    """保存图片并返回文件名。"""
+    fig.savefig(filename, dpi=dpi, bbox_inches='tight')
+    return filename

cm_chart-1.0.0/cm_chart.egg-info/PKG-INFO

@@ -0,0 +1,39 @@
+Metadata-Version: 2.4
+Name: cm_chart
+Version: 1.0.0
+Summary: 计算概论C课程中文图表快捷输出工具
+Author: Chen Mo
+Author-email: chenmoemail@126.com
+Classifier: Programming Language :: Python :: 3
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Operating System :: OS Independent
+Classifier: Natural Language :: Chinese (Simplified)
+Classifier: Intended Audience :: Education
+Requires-Python: >=3.8
+Description-Content-Type: text/markdown
+Requires-Dist: matplotlib>=3.5
+Dynamic: author
+Dynamic: author-email
+Dynamic: classifier
+Dynamic: description
+Dynamic: description-content-type
+Dynamic: requires-dist
+Dynamic: requires-python
+Dynamic: summary
+
+# cm_chart
+
+中文图表快捷输出工具。它不替代 `matplotlib`，而是帮学生先解决中文字体、常见图表和保存图片。
+
+```bash
+pip install cm_chart
+```
+
+```python
+import cm_chart
+
+fig, ax = cm_chart.bar(['苹果', '香蕉', '梨'], [12, 8, 15], title='水果销量')
+cm_chart.save(fig, '水果销量.png')
+```
+
+所有画图函数都会返回 `fig, ax`，学生可以继续用原生 `matplotlib` 修改细节。

cm_chart-1.0.0/cm_chart.egg-info/SOURCES.txt

@@ -0,0 +1,9 @@
+README.md
+setup.py
+cm_chart/__init__.py
+cm_chart/core.py
+cm_chart.egg-info/PKG-INFO
+cm_chart.egg-info/SOURCES.txt
+cm_chart.egg-info/dependency_links.txt
+cm_chart.egg-info/requires.txt
+cm_chart.egg-info/top_level.txt

cm_chart-1.0.0/cm_chart.egg-info/dependency_links.txt

@@ -0,0 +1 @@
+

cm_chart-1.0.0/cm_chart.egg-info/requires.txt

@@ -0,0 +1 @@
+matplotlib>=3.5

cm_chart-1.0.0/cm_chart.egg-info/top_level.txt

@@ -0,0 +1 @@
+cm_chart

cm_chart-1.0.0/setup.cfg

@@ -0,0 +1,4 @@
+[egg_info]
+tag_build = 
+tag_date = 0
+

cm_chart-1.0.0/setup.py

@@ -0,0 +1,21 @@
+from setuptools import setup, find_packages
+
+setup(
+    name='cm_chart',
+    version='1.0.0',
+    author='Chen Mo',
+    author_email='chenmoemail@126.com',
+    description='计算概论C课程中文图表快捷输出工具',
+    long_description=open('README.md', encoding='utf-8').read(),
+    long_description_content_type='text/markdown',
+    packages=find_packages(),
+    install_requires=['matplotlib>=3.5'],
+    python_requires='>=3.8',
+    classifiers=[
+        'Programming Language :: Python :: 3',
+        'License :: OSI Approved :: MIT License',
+        'Operating System :: OS Independent',
+        'Natural Language :: Chinese (Simplified)',
+        'Intended Audience :: Education',
+    ],
+)