跳转至

环境配置

文档作者:孙冰洁

布置 Windows 环境

安装 VS Code

1、官网下载安装包:https://code.visualstudio.com/

2、在 VS Code 里安装 Python 插件、配置 Python 解释器、成功运行 Python 程序。

安装 Anaconda

  1. 官网下载安装包:https://www.anaconda.com/download

本部分步骤可以参考视频教程:

VScode + anaconda环境的配置方法

准备 SHARPy 环境

下载安装 Git

1、官网下载(推荐):https://git-scm.com/downloads/win,下载 64-bit Git for Windows Setup。

2、一路点击 Next 即可,但有几个地方建议按下面设置。

Git 安装时选择组件

Git 安装时选择 VS Code 作为默认编辑器

GIT 的安装及环境配置见下方教程:

给傻子的Git教程

如何在 Windows 11 上启用虚拟化

安装 WSL2+Ubuntu

可以参考这个视频教程,提到了两种安装方式:命令行安装(看网速)或手动安装。

Windows11安装WSL2

若是启动 Ubuntu 出现以下报错:这意味着 WSL 已经安装好了,但是你的电脑没有开启 CPU 虚拟化(Virtualization),或者 Windows 的虚拟机平台没有完全启用。

WSL 虚拟化未启用时报错

如果 CPU 虚拟化没有开启,如下图所示,需要进入 BIOS 开启虚拟化。步骤如下,(不同品牌电脑进入 BIOS 方法不同,以 Lenovo 拯救者 Y7000 为例):

任务管理器中虚拟化未启用

  1. 完全关机。

  2. 开机时连续按 F2,进入 BIOS 。

  3. 进入 BIOS 后,一般是蓝色或灰色界面。进入 Configuration,找到 Intel Virtual Technology,将 Disabled 改为 Enabled,保存,电脑会自动重启。

    重启后,CPU 中虚拟化以启用,Ubuntu 就能启动了。

任务管理器中虚拟化已启用

更新 Ubuntu

这一步开始,所有环境搭建全部通过命令行下载安装,国内安装需要挂梯子。

  1. 进入 Linux 终端,执行

    sudo apt update
    
  2. 输入 Ubuntu 用户 Ubuntu 用户密码。

  3. 执行升级命令

    sudo apt upgrade -y
    

    最后出现了 done,说明成功了。

    Ubuntu 更新完成后的终端输出

安装 Miniforge

1、在 Ubuntu 中输入:

wget https://github.com/conda-forge/miniforge/releases/latest/download/Miniforge3-Linux-x86_64.sh

下载成功会出现下图:

Miniforge 下载完成后的终端输出

2、下载完成以后,再执行:

bash Miniforge3-Linux-x86_64.sh

安装过程中,它会问:

Do you accept the license terms?

输入:yes

然后一直 Enter(默认安装到你的 home 目录即可)。

最后它会问:

Do you wish to initialize Miniforge?

输入:yes

安装完成后执行:

source ~/.bashrc

然后验证:

conda --version

如果看到类似下面的输出,说明 Miniforge 安装成功。

conda 25.x.x

Miniforge 安装完成后的终端输出

3、确认 Miniforge 完全生效

执行以下 3 行命令:

source ~/.bashrc
conda --version
mamba --version

出现下图输出说明 Miniforge 完全生效。

Miniforge 中 conda 和 mamba 的版本检查

配置 SHARPy Conda 环境

执行这一条命令:

mamba create -n sharpy python=3.10

如果中间提示如下,输入 y:

Proceed ([y]/n)?

SHARPy 环境创建成功:

SHARPy conda 环境创建完成

下面进入 SHARPy 环境,在同一个 Ubuntu 终端输入:

mamba activate sharpy

终端就会变成 SHARPy 环境。

(sharpy) sunbingjie@FQ-ETOJQVRYJLRE:~$

安装 SHARPy

获取 SHARPy 源码

输入:

mkdir -p ~/Software

输入:

cd ~/Software

可以输入:pwd,如果显示下面的输出,说明进入成功。

pwd
/home/sunbingjie/Software

输入:

git clone --recursive https://github.com/ImperialCollegeLondon/sharpy.git

第一次下载大概需要几分钟。结束以后应该看到类似:

Receiving objects...
Resolving deltas...
Submodule ...
done.

输入:

cd sharpy

然后输入:pwd。

pwd

应该显示:

/home/sunbingjie/Software/sharpy

执行安装 SHARPy

输入:

pip install .

等待安装过程(安装需要挂梯子),安装成功后如下图。

SHARPy pip 安装过程

常见报错:缺少编译工具

系统找不到 make、C 编译器和 C++ 编译器。

CMAKE_MAKE_PROGRAM is not set
CMAKE_C_COMPILER not set
CMAKE_CXX_COMPILER not set

在 Ubuntu 终端,仍然保持 (sharpy) 环境,执行:

sudo apt install -y build-essential cmake g++ gfortran libblas-dev liblapack-dev libeigen3-dev

安装完成后,检查一下:

gcc --version
g++ --version
cmake --version
make --version

都能显示版本号后,再回到 SHARPy 源码目录:

cd ~/Software/sharpy
pip install .

编译器安装成功后如下图(安装需要挂梯子)。

编译工具安装完成后的终端输出

验证安装

现在仍然保持在 (sharpy) 环境下,在 Ubuntu 终端输入:

sharpy --version

显示下面的输出表示安装成功。

Running SHARPy version 2.4