Jupyter Lab的简洁安装与使用

目录

1. Jupyter Lab简洁安装

2. Jupyter快捷键

2-1. 编辑模式下

2-2. 命令模式下

2-3. 命令补全

3. 如何查看函数说明

4. Jupyter支持的导出格式

5. Juypter显示问题

5-1. 减少warning显示

5-2. 保证图像正常显示

6. 指定工作路径

7. 添加彩色记忆标签

---

1. Jupyter Lab简洁安装

Linux / Windows / MacOS相同，建议直接在conda环境中安装Jupyter Lab，便于未来进行多环境管理。具体操作步骤如下a-f。

a. 下载Miniconda（官网下载）。

b. 安装conda（User guide）在命令行界面or图形界面都可以。

Tip1: 请尝试静心阅读User guide的目录结构，只需1-5分钟，就能基本知道你该怎么做。不必漫天找教程，“User guide always the best”。

c. 进入当前任务/项目的conda环境（在Windows中，运行的是conda.exe）：

# 进入conda环境
conda activate environment_name

# 安装jupyter - 用conda
conda install jupyterlab 

# 安装jupyter - 用pip
pip install jupyterlab 


# 进入“根”工作路径
cd project_root_path/

# 启动jupyter
jupyter lab 

d. 在生成的一堆启动代码中，找到http地址（下图），复制，粘贴到browser的地址栏，回车打开。

这里注意几点：

• 如果Jupyter和browser安装在不同的计算机上（比如，你正在使用电脑的Shell远程连接Linux集群，或者，你正在使用某个供应商的云服务器），就不能复制 http://localhost:50002/ 了，ip地址改成了 http://127.0.0.1:50002/ 。
• 如果仍然打不开网页，需要重新启动Jupyter：

# 关闭当前jupyter 
ctrl + c 

# 重新启动jupyter 
jupyter lab --ip=0.0.0.0 --port=8888 

此时，在生成的一堆启动代码中，ip地址就改成了Jupyter所在计算机的节点名称 http://node_name:50002/ 。复制，粘贴到browser的地址栏，回车打开。

Tip2: 重新启动时添加参数，是因为没有设置jupyter_notebook_config.py，有空的可以去研究一下怎么设置（User Guide）。暂时没空的同学，先用--ip=0.0.0.0就可以建立远程连接了。

后续如果有需要，我再写一篇jupyter_notebook_config.py如何设置的文章。

e. 这样就进入了Jupyter Lab工作站。

这里注意几点：

• 记得工作过程中，不要关闭当前Shell，否则监听将被中断。
• 养成随时ctrl + s保存的习惯。
• 不要轻易在Jupyter中删除文件，难以追回。
• 可以刷新Jupyter Lab页面，只要Shell没中断 & Kernel没手动终止，就不会丢失Lab中的代码。
• 可以在多个Shell中同时启动Lab，但是不要同时打开一个文件，显然，这容易引起保存冲突。

2. Jupyter快捷键

全部快捷键，可以在Help - Keyboard Shortcuts找到：

Cell有两种模式：编辑模式、命令模式。上下键选中Cell后，Enter进入编辑模式，ESC进入命令模式。

2-1. 编辑模式下

• Tab：代码完成或缩进。
• Ctrl + Shift + –：拆分光标处的当前单元格。
• Ctrl + ]：缩进。
• Ctrl + [：缩进。
• Ctrl + A：全选。
• Ctrl + Z：撤消。
• Ctrl + Y：重做。
• Ctrl + Home：转到单元格开始。
• Ctrl + End：转到单元格末尾。

2-2. 命令模式下

• `A`：在当前单元格上方插入一个新单元格。
• `B`：在当前单元格下方插入一个新单元格。
• `C`：复制选定的单元格。
• `V`：将复制的单元格粘贴到当前单元格下方。
• `D`：删除选定的单元格。
• `Z`：撤消最后一个单元格操作。
• `L`：显示或隐藏行号。
• `M`：将所选单元格转换为降价单元格。
• `Y`：将所选单元格转换为代码单元格。
• `Shift` + `Arrow Up/Arrow Down`：选择多个单元格。
• `Ctrl` + `Shift` + `-` : 在光标处拆分当前单元格。
• `Ctrl` + `Shift` + `Minus` : 在光标处拆分当前单元格。
• `Shift` + `M`：合并选定的单元格。
• `Ctrl` + `Shift` + `P`：打开命令面板。
• `Shift` + `Enter` : 运行当前单元格并将光标移动到下一个单元格。
• `Ctrl` + `Enter` : 在不移动光标的情况下运行当前单元格。

2-3. 命令补全

a. 安装拓展包jupyter_contrib_nbextensions：

# 在当前conda环境下，安装插件
pip install jupyter_contrib_nbextensions

b. ctrl + c重启Jupyter Lab。

c. 使用Tab补全：

# 导入模块
import tensor
# 当记不起全称时，按Tab，稍等片刻，出现函数补全列表(下图)

3. 如何查看函数说明

查看函数的几种方式，请自行体会区别：

a. 光标停留在函数上，同时按Shift + Tab

 上图粉框中：^表示在分页器中显示帮助文档；+表示展开所有帮助文档信息。

b. 光标停留在函数上，按住Shift + 再按Tab

c. 光标停留在函数上，按住Shift + 连按4下Tab

d. help(function_name)

e. function_name? 调用文档

f. function_name?? 查看源

g. 查看子函数列表：

#### 方法1 #### 
matplotlib.pyplot. # 输入.后，按Tab，稍等片刻，出现子函数列表

#### 方法2 ####
dir(matplotlib.pyplot) # 查看函数中的所有子函数

h. 查看参数列表：

dir(function_name) # 查看函数中的所有参数

i. print(function_name.__doc__) 查看该函数的注释信息

j. 查看函数的源代码文件：

import inspect 
inspect.getsourcefile(sc.pl.violin) 

4. Jupyter支持的导出格式

可以将当前.ipynb文件，转为py、html、markdown、rest、latex、pdf文件。

5. Juypter显示问题

5-1. 减少warning显示

在Jupyter中预先运行以下命令，避免warning信息刷屏：

import warnings
warnings.filterwarnings("ignore")

5-2. 保证图像正常显示

a. 在Jupyter上显示图片：

%matplotlib inline 
# 如果不添加该行，每次绘图都需要用:
plt.show()
# 或 
plt.imshow(figure_object)

当使用plotly模块画图时：

import plotly 
fig = plotly .graph_objs.Figure() 
fig.write_image('name.png',engine='kaleido') 

b. 保存图片：

如果plt.savefig("fig_name.png")保存的是空白，尝试以下命令：

# 当前的图表，用plt.gcf() 获得，后保存。
# 当前的子图，用plt.gca() 获得，后保存。
fig=plt.gcf()
plt.imshow(figure_object)
fig.savefig("figure_name.jpg")

c. 读入图片

plt.imread("figure_name.jpg")

5-3. 记录Cell运行时间

%%time
# 写在Cell的第一行。

6. 指定工作路径

有两种方法：

a. 先在Shell中进入该路径，再启动Jupyter。（同1. c.）

cd D:/Users/who/project_root_path/ 
jupyter lab

b. 在配置文件中指定该路径：

# 生成配置文件
jupyter notebook --generate-config  

vim jupyter_notebook_config.py 
c.NotebookApp.notebook_dir = "D:/Users/who/project_root_path/"

7. 添加彩色记忆标签

给.ipynb文件添加一些醒目的Alerts，便于回顾、记忆。详细的使用方法在这里（Alerts）。