安装

使用 pip

您可以通过运行以下命令使用 pip 包管理器进行安装：

    pip install -U ydata-profiling

如果您在笔记本中（本地、LambdaLabs、Google Colab 或 Kaggle），您可以运行：

    import sys
    !{sys.executable} -m pip install -U ydata-profiling[notebook]
    !pip install jupyter-contrib-nbextensions

之后，您可以运行以下命令

    !jupyter nbextension enable --py widgetsnbextension

您可能需要重启内核或运行时才能使包正常工作。

使用 conda

通过 Conda 安装 ydata-profiling

可以通过以下方式创建包含该模块的新 conda 环境：

    conda env create -n ydata-profiling
    conda activate ydata-profiling
    conda install -c conda-forge ydata-profiling

提示

不要忘记指定 ``conda-forge`` 频道。
省略它**不会**导致错误，因为 ``main`` 频道上有一个过时的包将被安装。详情请参阅 :doc:`../support_contrib/common_issues`。

Jupyter Notebook/Lab 中的小部件

为了使 Jupyter 小部件扩展（用于进度条和基于交互式小部件的报告）正常工作，您可能需要安装并激活相应的小部件扩展。 这可以通过 pip 完成：

  pip install ydata-profiling[notebook]
  jupyter nbextension enable --py widgetsnbextension

或者通过 conda：

  conda install -c conda-forge ipywidgets

在大多数情况下，这也会自动配置 Jupyter Notebook 和 Jupyter Lab（>=3.0）。对于较旧的版本或在更复杂的环境配置中，请参阅 官方 ipywidgets 文档。

从源码安装

通过克隆仓库或点击 下载 ZIP 下载源代码。 通过导航到解压缩的目录并运行以下命令进行安装：

   python setup.py install

这也可以通过以下一行命令完成：

  pip install https://github.com/ydataai/ydata-profiling/archive/master.zip

额外功能

该包声明了一些“额外”功能，即额外的依赖项集合。

• [notebook]: 支持在 Jupyter 笔记本小部件中渲染报告。
• [unicode]: 支持更详细的 Unicode 分析，但会占用额外的磁盘空间。
• [pyspark]: 支持使用 pyspark 引擎对大数据集进行分析。

可以通过以下方式安装这些额外功能：

  pip install -U ydata-profiling[notebook,unicode, pyspark]