LovelyPlots 开源项目安装与使用指南

LovelyPlots 开源项目安装与使用指南

LovelyPlotsMatplotlib style sheets to nicely format figures for scientific papers, thesis and presentations while keeping them fully editable in Adobe Illustrator.项目地址:https://gitcode.com/gh_mirrors/lo/LovelyPlots

目录结构及介绍

文件夹概览

在 LovelyPlots 的项目根目录中，主要包含了以下关键文件与文件夹：

| 名称 | 描述 | | --- | --- | | examples | 示例代码及其产生的图表文件存放地 | | figs | 预设的图形模板或示例图形 | | lovelyplots | 主程序包，内含核心功能的实现代码 | | tests | 单元测试脚本及其相关资源 | | .gitignore | 版本控制系统忽略的文件类型列表 | | LICENCE | 项目的授权许可证文件 | | MANIFEST.in | 分发时需包括的文件清单 | | README.md | 项目说明文档 | | pyproject.toml | Python 包构建工具配置文件 | | setup.py | Python 包的设置和构建脚本 |

启动文件介绍

主要入口点

LovelyPlots 的主要运行依赖于其内部的 lovelyplots 模块。用户通常不需要直接运行某个特定文件来初始化项目环境；而是通过导入该模块并调用其中的功能进行绘图。

对于基本的样式设定与应用，您可以通过执行以下Python命令开始：

import lovelyplots as lp
lp.utils.set_retina()

此段代码特别适用于 IPython 笔记本环境中，它将启用高分辨率（Retina）显示支持，以确保高质量的图像呈现。

配置文件介绍

样式配置

样式设置是通过调用 Matplotlib 的风格文件来完成的，具体而言，通过如下方式激活默认样式：

plt.style.use('ipynb')

但要注意，在版本 1.0.0 及以上版本中，为了兼容最新更改，应在设置风格前先进行 lovelyplots 模块的导入。这意味着您的配置步骤应该像这样：

import lovelyplots
plt.style.reload_library()   # 重新加载样式库
plt.style.use('ipynb')      # 使用 'ipynb' 样式

这些Matplotlib风格文件被放置在 lovelyplots 模块下相应的路径里，并随着软件安装过程自动移至matplotlib的配置目录中，确保每次运行时都能正确识别和应用。

此外，若想在 Google Colab 环境中使用，额外的配置步骤也是必要的，这包括对 pip 和 lovelyplots 模块本身的更新以及风格的激活。

pip install lovelyplots       # 在Colab中安装
import lovelyplots            # 导入模块
plt.style.reload_library()    # 刷新样式库
plt.style.use('ipynb')        # 应用样式

综上所述，LovelyPlots 项目不仅提供了多种预定义的绘图风格，而且也允许用户自定义配置，使得科研人员能够在撰写论文、制作报告时轻松达到可视化需求的标准。

LovelyPlotsMatplotlib style sheets to nicely format figures for scientific papers, thesis and presentations while keeping them fully editable in Adobe Illustrator.项目地址:https://gitcode.com/gh_mirrors/lo/LovelyPlots