.. _chap_installation:

安装
====


为了快速上手并获得良好的学习体验，我们需要搭建一个包含 Python、Jupyter
Notebook 和相关依赖库的运行环境来执行本书中的代码示例。

安装环境
--------

首先安装依赖Python
3.x的Miniconda。访问\ `Miniconda <https://docs.anaconda.com/miniconda/install/>`__\ 官网下载并安装。

接下来创建一个名为funrec的conda环境，并安装Python 3.10。

.. raw:: latex

   \diilbookstyleinputcell

.. code:: bash

   conda create --name funrec python=3.10

激活环境：

.. raw:: latex

   \diilbookstyleinputcell

.. code:: bash

   conda activate funrec

安装funrec库及其依赖
--------------------

我们的下一步是安装funrec库及其依赖。
在\ ``pyproject.toml``\ 同级目录下执行：

.. raw:: latex

   \diilbookstyleinputcell

.. code:: bash

   pip install -e .

从\ `数据链接 <https://drive.google.com/file/d/1NAsN1Bqf88Ag2KYmGhTKDiX0Uty2dDw3>`__\ 下载数据，并解压到相应目录，记录数据路径。

先复制.env.example文件为.env文件：

.. raw:: latex

   \diilbookstyleinputcell

.. code:: bash

   cp .env.example .env

然后修改.env文件，添加数据路径:

-  ``FUNREC_RAW_DATA_PATH``\ ：原始数据路径，即下载的数据路径。如果设置为空，则使用默认路径为当前路径下的\ ``data``\ 文件夹。
-  ``FUNREC_PROCESSED_DATA_PATH``\ ：处理后的数据的缓存路径，自由设置。如果设置为空，则使用默认路径为当前路径下的\ ``tmp``\ 文件夹。

下载FunRec Notebook
-------------------

接下来，需要下载这本书的代码。 可以点击本书HTML页面顶部的“Jupyter
记事本”选项下载后解压代码。

安装完成后我们可以通过运行Jupyter
Notebook并且将运行环境指向之前配置的funrec环境来运行本书中的代码。