|
0 Q1 ~$ N: L: S. h) \9 { 2021.10.24更新:两个小Tips:1️⃣这个包我现在不用了,毕竟主力平台还是Win,现在推荐使用ProPlot来画图(ProPlot — ProPlot documentation),真的很好用(导师看了都直呼内行,开个玩笑)!2️⃣文中提到的EOF的代码就别看了(属于是早年的腊鸡代码),现在推荐直接使用eofs(Package description — eofs 1.4.0 documentation (ajdawson.github.io))来完成EOF的计算。
" e; E+ n; A& p, m2 P 2021.01.31更新:
: k k/ p E4 g9 r 创建新环境时请将Python版本指定为3.6,否则会冲突导致无法安装。 6 d6 S' j H1 K9 |& j5 Z
一点感想:PyNgl和PyNio也不再更新了,美帝又去更新自己的Geocat包了,可惜啊Geocat我自己初次尝试,连安装都很大困难,还是学学人家cartopy吧,要不是cartopy画图太丑。
8 n- s6 q0 f$ ?' R 更新: & u( W' H0 S, `1 W6 `" H* C
conda create --name pyncl --channel conda-forge/label/cf201901 pynio pyngl netcdf4 xarray ncl scipy
- s+ l% M; Q0 m$ [: M2 I 此安装代码不建议在使用,速度慢,容易掉线。 ! O" R" i& b0 C9 I
输入命令:vi ~/.condarc N- O; E8 } m0 T
讲最后一行的 -default 直接删除(前提是已经增加了清华或中科大源)
7 ~2 s# S: r! p7 G* b4 N 然后在新环境下使用conda install xxx 依次安装pynio pyngl netcdf4 xarray ncl scipy即可快速安装
. I9 |1 m5 C4 @# u: s 如果换源之后还是不行
0 Y# V6 L* h1 G/ b' y* x: n/ v 数据可视化的软件和库有很多,但是对于大气和海洋数据的可视化,因为涉及到投影、海岸线的绘制,支持的还非常少。
9 I2 C" a) f C9 N1 O 主要的有:
, X7 M2 w( h, k D# U; @ ①Grads:易用性很差,常常是数据处理计算出来再由Grads读取来绘制。同时语法也比较奇怪。对Win10的支持也不是很好。 , W1 t; U( Y2 I3 T' Y/ F: }; ?
②NCL:NCL(The NCAR Command Language)是一种专门为大气海洋科学数据处理以及数据可视化设计的高级语言。其实是PyNgl和PyNio的前代产品。
" M. }# h+ v% `) x ③MATLAB:很好用但是主攻方向不在地球科学,绘制出来的图片稍微欠缺没敢。(个人感觉) 0 D! f4 P/ @' {
④Cartopy:Python下的一个库,由英国气象局开发,Basemap的继承产品(Basemap在2020年不再维护),主要基于matplotlib实现可视化。目前还不是很完善,容易出现奇奇怪怪的问题。
* Y1 n! o* v8 W, ?) H# U6 J ⑤PyNgl:NCL的续作由NCAR负责开发。绘制美观,功能强大,绘图时允许高度自定义。放一张官网扒的图 4 H8 J/ v( o0 p2 [
; }1 h% `. D L* c. x
还是挺美观的。
9 T; Y2 n5 y& N+ L9 x3 T' W y 为什么选择Python?因为 人生苦短,我用Python!!! 它语法简单高效,一般来说上手三天即可(但是精通永无止境),学习曲线很平滑。
- ?; o3 z w) b2 n5 B 既然PyNgl是Python下面的一个库,那么直接用conda安装不就完了吗,理论上来说是的,但是关键在于: ; y- E5 t2 }; Q" }! z, A: M$ _
它不支持Win10!!! % ?: T% ^. h: g; b+ D
它不支持Win10!!!
" q, F( ~* E( \/ l 它不支持Win10!!!
1 \2 K$ V# b# G: X' E9 |/ p5 S4 ? 这对于不常用Linux的科学工作者或者学生来说是很麻烦的事情,大多数人的主力系统都是Win10,当然macos系统也不需要参考此教程,可以直接利用conda安装。
2 @3 w, {9 H* C5 Q 幸运的是微软家有一个很好用的东西:子系统(WSL),Windows Subsystem for Linux(简称 WSL)是一个为在 Windows 10 上能够原生运行 Linux 二进制可执行文件(ELF 格式)的兼容层。它是由微软与 Canonical 公司合作开发,目标是使纯正的 Ubuntu 14.04 “Trusty Tahr”映像能下载和解压到用户的本地计算机,并且映像内的工具和实用工具能在此子系统上原生运行。
1 [, N, [: a- g- e 相比于 VMware 等虚拟机,WSL 占用内存和 CPU 资源更少,在 WSL 上运行软件的消耗和直接在 Windows 上差不多。而且,Windows 下可以直接访问 WSL 的环境。 : C# Q' J8 e Z
安装子系统步骤:
1 d$ {4 L5 B" X M ①开启 WSL 可选特性 & t. {1 r( B5 |! G. c: F! [ J6 c
在控制面板的“启动或关闭 Windows 功能”中勾选“适用于 Linux 的 Windows 子系统”。 5 G9 R5 G6 J6 S+ g
r7 w5 o+ _, l
或在 PowerShell 中运行下述代码: 7 x5 h- X6 T& b) |4 _/ [: y- v9 S
Enable-WindowsOptionalFeature -Online -FeatureName Microsoft-Windows-Subsystem-Linux 8 S7 w# @) U0 m/ o8 R2 d: F+ x
②下载安装 ; ?7 T3 B9 y- g
打开 Microsoft Store,搜索 Linux,就会显示 Ubuntu、suse 等几个发行版,点击进行安装即可。这里选择了 Ubuntu(第一个)。 9 C3 G7 _2 O8 q, y
. K" e+ {. k7 ]) i8 q 下载之后启动菜单里就会出现Ubuntu的图标了。让我们启动它,按照上面的提示等待几分钟,就可以进入初次登陆设置账号的界面。
3 d+ o$ O. F3 w5 f# t7 H 图片来自https://wu-kan.cn/_posts/2018-12-14-Windows-Subsystem-for-Linux/设置账号密码就完成了安装
: U3 L; ^9 H* Z, l5 E 图片来自https://wu-kan.cn/_posts/2018-12-14-Windows-Subsystem-for-Linux/关于Linux的命令可以自行查阅,只需要会cd,ls,pwd等简单命令即可。 + a# x H$ j% k; p8 l* [0 L
需要注意:如无必要不要输入下面命令,因为更新后貌似会有些问题,导致PyNgl无法使用。 4 I: y; L% i: J+ Q. D+ w0 j& a
sudo apt update -y$ S9 O2 m n0 g- ^1 O
sudo apt upgrade -y 1 q% b$ N6 K. _2 ]" y
子系统下anaconda的安装: + X# Y1 ^: q# c% @
①首先从清华镜像Tsinghua Open Source Mirror下载ananconda在linux下的镜像,并放到Win10系统的任意位置(这里假设是D盘)
2 S- D3 v/ F: ~3 V3 q- ^/ K* V+ W, @
! h% g7 ^9 Q) J2 `, T! [, | 接着在子系统中输入下面命令 : J3 R& ]" j. z; H) ^) _
bash /mnt/d/Anaconda3-2020.02-Linux-x86_64.sh#mnt其实是挂载到了本地的硬盘 ' g0 N1 Y; {" o# @" q3 H$ o8 e
一路回车,注意在正式安装前会弹出安装地址,记下这个位置。然后他会开始安装,等就行。
; b; l4 R- N$ n! \- _+ w3 P ②环境变量的设置(保证在子系统的任意位置均可使用Python和conda命令)
+ V6 H/ R4 A# l" { 1,输入 vi ~/.bashrc (打开了一个编辑器)
& m ^( o- h% y1 q 2,按一下i键,进入编辑模式
5 ]0 ^3 [' I7 h T 3,在最后输入export PATH=/home/lishanliao/anaconda3/bin PATH 要换成你自己的目录,如果你是一路回车安装的一般只要把lishanliao换成你自己的用户名即可
3 Q* M5 l3 n, T8 p 4,按下shift+ i旁边那个冒号键),输入wq 保存并退出。 * G0 n( I0 N( z; O ^" A" x& G
5,输入source ~/.bashrc 重新加载环境变量 ! ?9 A6 h, u+ k+ i* I; s# o) h
6,如果你害怕不会用这个编辑器,可以直接在命令行中输入下面命令,在执行5即可
- l. l& ?% t T. R2 U# t echo export PATH ="/home/liang_yu/anaconda3/bin  PATH" >> ~/.bashrc#还是要换成你自己的路径
6 w3 W) d6 _, R3 t. p: z ③conda下载源更换(加快库的下载速度) , L. u$ o8 l, o8 S9 L0 x# M
直接在linux命令行中输入下面命令(复制粘贴即可) $ u% Z- A5 P4 h
conda config --add channels https://mirrors.ustc.edu.cn/anaconda/pkgs/main/- m# ~8 l& F3 P( I% i
conda config --add channels https://mirrors.ustc.edu.cn/anaconda/pkgs/free/1 h# i$ D8 J( `5 E& \
conda config --add channels https://mirrors.ustc.edu.cn/anaconda/cloud/conda-forge/
# q, [% X, I( m- d/ z7 O( j3 W conda config --add channels https://mirrors.ustc.edu.cn/anaconda/cloud/msys2/2 `$ E, M" y" ^: l- U+ m
conda config --add channels https://mirrors.ustc.edu.cn/anaconda/cloud/bioconda/ M; l! j1 L. ^
conda config --add channels https://mirrors.ustc.edu.cn/anaconda/cloud/menpo/
) s. ~8 P* L8 G/ C2 e7 ? conda config --set show_channel_urls yes
8 @, ?& Z% C8 ^ ④PyNgl的安装
3 s& c. V* d- x! z9 l' h 在linux命令行中输入下面命令,他会自行安装,可能会出现网络错误,要么多试几遍要么挂梯子 5 n. j! j$ C9 T4 I
conda create --name pyncl --channel conda-forge/label/cf201901 pynio pyngl netcdf4 xarray ncl scipy
7 v$ q6 V; [0 M2 [ 我并没把库安装在base环境下,而是创建了一个新的环境叫pyncl,因为好像有某些冲突。
' i0 a. C: G. Q! q 安装完成后,输入python,在输入 import Ngl,如果没有报错就是成功了。
- B( F, v. g: {* S/ |, @8 w ⑤接下来就可以画图啦
) T5 A9 F: Z( \' i 现在win10下写好代码,保存成.py文件
* R' D" D/ y) k# R' e, U 首先激活环境,输入下面命令
- ~% t! p" W) m$ x, Y# Y conda activate pyncl
$ q: O& I( B2 H) W 接着输入,它会自动执行。
$ T5 K6 ]4 y! w; d' t# g W python /mnt/d/file.py
6 W0 t' J- e1 q 最后展示一下示例图和代码 ! b9 {- r9 V! h. `; d- m, ]
1 ` \& f& z2 ?8 ^4 q! {$ y, ~ 代码示例(前半部分是EOF的计算,可以不看) K3 M, g( w4 _: v
"""实现了自由调整子图的位置,没有使用panel的面板绘图,使用了新的地图投影"""
' i# B; |' G5 c3 z' M0 @0 A import Ngl6 x1 R1 _. v& V
import numpy as np- y6 n6 r% d, Q# Q
import math
4 }7 ?( W# R0 D8 S import netCDF4 as nc) D' w k$ C& \; o/ K; f
def EOF_3d(data_3d,lat,lon,K):* ^8 V. o7 ]: [$ B3 G# l) `5 i7 e
"""data_3d表示三维数据
2 A/ |! p) r1 Y. z) J 例如某一时间段,某一区域范围
! G3 a% I! P! M3 ?; x 的SST数据,需先做拉直运算
7 h: u. M7 M& @ K是int表示去前K个模态
q$ r' r, w0 ^5 L! `9 d 同时考虑到时空转换K不能大于n. {$ b4 U. Y2 i; p+ p) V7 _3 q
因为L_Q的形状为[n,n],看表达式就可以看出来"""$ E: g6 o$ G" _5 f! I' C" l
lat_n,lon_n,time=data_3d.shape
$ Z. X3 L, ~: I; c% d# c m=lat_n*lon_n;n=time#m为个点数,n为观测次数/ B: p7 K8 r6 `/ c8 |9 J9 O0 M
m=m-np.count_nonzero(data_3d[:,:,0]!=data_3d[:,:,0]). K/ g7 Q0 v% h# \8 Q2 M' T3 u
X=np.empty((m,n))- D- s- w( {! [( ]
k=0
) T: w+ ^7 k' P for i in range(lat_n):) y: y3 n- k* W; @/ }* ^
for j in range(lon_n):4 K% i0 Z% Q- t8 y( E7 b$ ]
if (np.isnan(data_3d[i,j,0])):#考虑陆地( @& i/ H) b ?# n
print (land)
. a" e# [) d3 e$ d: t5 A else:2 k* w$ X1 L# E7 C9 V
#考虑地球因素乘于cos(纬度)
# g, T8 C$ V4 E3 ? X[k,:]=data_3d[i,j,:]*(math.cos(math.pi*lat[i]/180))**0.5
' F6 Z' C# Q: Y3 P. A# v- Z9 r k=k+1
. c' S: e( b; Q V X_mean=X.mean(axis=1).reshape((m,1))3 b0 l! P8 A! p3 r
X_d=X-X_mean#利用距平阵计算: j1 F+ W7 q3 y1 [. U q: J+ A. `
if (m<=n):#不使用时空转换6 v% ?# R' Q# w, F- e8 I8 E
S=np.dot(X_d,X_d.T)/n
+ m7 u" a, m# [1 {( H; M! I lambda_,L=np.linalg.eig(S)) ^/ P: {6 P5 V( _, ~
else:
; F9 m( f3 c( g7 | S_Q=np.dot(X_d.T,X_d)/m
# [9 h9 x& \, A$ { lambda_Q,L_Q=np.linalg.eig(S_Q)#注意L_Q的形状/ ?& A$ a* L @9 _- n! l
lambda_=lambda_Q*(m/n)
; O) p4 k) P6 N; L% V' K/ t9 g9 {1 b L=np.empty((m,K))/ K3 w4 w Q$ G' G# R, Z" y
for i in range(K):" y0 L: A5 l& x; \9 ~$ R- \/ U
l_Q=L_Q.real[:,i], i2 [& `/ f' x, N' N b
L[:,i]=np.dot(X_d,l_Q.T)/(m*lambda_Q[i])**0.5
+ D) o l8 O- o& _3 R% S% ` lambda_=lambda_.real[0:K];L=L.real[:,0:K]#避免复数的问题
; A5 s% s, x) [1 R: S2 x Y=np.dot(L.T,X_d)
6 U$ k. w) F) D p=np.empty((K,n))
/ N7 ?# J5 T, l# ^ e=np.empty((m,K))
0 x& B1 h8 A) N. h" L for i in range(K):1 @$ ^$ c: Y5 P: ]
e[:,i]=lambda_[i]**0.5*L[:,i]" W6 x6 X+ v1 G2 A4 h! h* p
p[i,:]=Y[i,:]/lambda_[i]**0.5% b+ D: v8 d# Q7 D4 `+ h
#将e恢复为空间性# P2 x2 C4 S4 f2 \/ y
e_2d=np.empty((lat_n,lon_n,K))9 S( b6 Z8 ^+ k' T0 f; O
for m in range(K):
. x/ }2 d, e% \ k=0
( e! Z0 |6 S% \+ I! [. V; ^ for i in range(lat_n):
. i. d: p/ \" I: J for j in range(lon_n):& L+ [! o" x) Y: ? d' ?- |$ r
if (np.isnan(data_3d[i,j,0])):
. d9 A7 M: u# ~4 C* p1 S e_2d[i,j,m]=np.nan5 S$ H. j5 N6 o- h. S; Z
else:- ?+ R5 U% t$ y$ ?" X9 C) u
e_2d[i,j,m]=e[k,m]/(math.cos(math.pi*lat[i]/180))**0.5
. T% Y( Z2 t5 i. ?; A k=k+1
$ k* ^, A( q3 e% |7 |3 J& s return lambda_,e_2d,p,Y
' i; ~/ n" g+ E U$ {8 G v #------------------
% S# Z, \; P5 _& M #时间:2000-2018年每年1月(624开始19个月)
6 f7 k2 s- x. K2 d G9 ~/ v- Z #区域:0-85,120-245- {$ m+ }6 H! N! i$ G
#lat[2:37] 35
5 }# k, W& E; ^5 U- t b7 _ #lon[48:99] 51
+ W6 z b" T' p- D/ T7 Z file="/mnt/c/Users/59799/Desktop/slp.mon.mean.nc"
: G4 _" Q3 I5 q+ ]: j #file=rC:\Users\59799\Desktop\slp.mon.mean.nc
; e( I3 ~/ `4 e data = nc.Dataset(file)
- w: n5 o+ v# M lat = np.array(data.variables[lat])
6 ]5 U. E4 Y6 \0 Z' l: [3 W lon = np.array(data.variables[lon])
( A, R0 g* Q/ e( ?7 p5 [6 ~6 J time = np.array(data.variables[time])% O' a0 p0 ^) H) @6 k
slp = np.array(data.variables[slp])9 |4 t2 p- x. d c
data_3d=np.empty((35,51,19))
* W5 X( ~* Q$ b4 x$ j& K time=624/ k; u% H% I3 H! g4 H
for k in range(19):; A. Q' u( U! l
for i in range(35):" x6 B3 q8 F& @- D l; @6 E `* x
for j in range(51):& _' t' d. P) C
data_3d[i,j,k]=slp[time,2+i,48+j]
3 U3 ~9 J( U- r. Q. t" C time=time+12
( F! r* `: S, g) b; [/ D7 H, P lad,e_2d,p_t,y=EOF_3d(data_3d,lat[2:37],lon[48:99],10)
6 R- U: \4 H& W) B' v: I
/ f) E) T( u5 o* h2 o; t: o# t #绘图 o# J0 H) G. R5 S
#BlueWhiteOrangeRed
& ~9 q8 h* @. n6 q8 N V plot=[]7 d' C5 l4 P ]$ B( b2 |% \
wks_type = "png"#子系统没有可视化模块,输出成png图片在打开来看+ H8 U* k' }: M4 t3 a2 a/ @& L8 E
wks = Ngl.open_wks(wks_type,"/mnt/c/Users/59799/Desktop/EOF_first_model")#图片保存到本地的桌面) }2 L& M7 _4 ]' f0 Q' H
cnres = Ngl.Resources()" r3 B; I" Q; J% u! m# _8 x6 Y
cnres = Ngl.Resources()+ ^7 j7 e$ R, ~* L7 W0 F) |9 u
cnres.nglDraw = False#因为要绘制叠加图先阻止画图& q, i3 j, k! I7 ?6 g
cnres.nglFrame = False#关闭框架与上一条搭配使用% q* `3 v8 U# B0 ?3 r
cmap = Ngl.read_colormap_file("BlueWhiteOrangeRed")#读取colorbar,官网可查啊/ T+ e4 Y3 O" ^7 c1 ` F n3 l
cnres.cnFillPalette = cmap[:,:]#不完整使用整个色图,只是用颜色定义值的第五行开始
9 \3 ?+ {$ B/ a2 W7 W! w9 O1 S cnres.cnFillOn = True #等值线填充* N3 o% k$ y1 q* M- e {
cnres.cnLinesOn = False#不画等值线
$ ^( _4 S0 A8 o& c$ m- M y+ x3 ?1 Q cnres.cnLineLabelsOn = False#不画等值线标签(等值线数值)
& _; v7 M* U. t2 D. S; Q cnres.lbOrientation = "horizontal"#水平放置colorbar3 L- m `- w, ~8 z3 V6 U
cnres.mpProjection = "Orthographic"2 `3 e3 d+ o" F# X$ o
cnres.sfXArray = lon[48:99]#经度对应为x轴
6 ]& U: P8 H' x) \# c cnres.sfYArray = lat[2:37]#纬度对应为y轴$ `8 f+ H9 ~/ |. P9 _/ n$ O' R
cnres.mpCenterLonF = lon[48:99].mean()
$ c$ |1 j! O8 O cnres.mpCenterLatF = lat[2:37].mean()3 k" ` c$ q' K0 D x( u5 n
#cnres.mpLimitMode = "LatLon"#规定经纬度范围时需要使用,否则规定无效/ P* ]( Z( I& B) ?) t
#cnres.mpMinLonF = lon[48:99].min()#不加范围限制则图片为所规定中心纬度经度显示的全球视角(数据只在规定范围有的话会出现无数据的空白区域(海岸线依旧存在))1 D$ q! x! `! _2 b: z0 ]8 _3 z7 U5 _
#cnres.mpMaxLonF = lon[48:99].max()#不加范围限制则图片为所规定中心纬度经度显示的全球视角(数据只在规定范围有的话会出现无数据的空白区域)( {3 k; k, k, z; ?6 Q
#cnres.mpMinLatF = lat[2:37].min()#不加范围限制则图片为所规定中心纬度经度显示的全球视角(数据只在规定范围有的话会出现无数据的空白区域)+ d T& J( ]5 w
#cnres.mpMaxLatF = lat[2:37].max()#不加范围限制则图片为所规定中心纬度经度显示的全球视角(数据只在规定范围有的话会出现无数据的空白区域)/ R0 {4 b& @0 m. r
cnres.nglMaximize = False#必须关闭最大化绘图不然下面的调整plot box的参数是无效的1 ` v" p3 ~& k
cnres.vpXF = 0.08 # The left side of the box+ \& u+ ]" C) k! U K& m
cnres.vpYF = 0.75 # The top side of the plot box
4 E5 I& z5 K5 Y: L cnres.vpWidthF = 0.4 # The Width of the plot box1 e+ D2 h& l% M) Z
cnres.vpHeightF = 0.5 # The height of the plot box
9 t" J8 j8 B1 O, ]) @5 H cnres.mpGeophysicalLineThicknessF =3.3 #海岸线宽度(粗细程度) 默认的太小了
, y* i6 U0 }7 \, \ cnres.mpFillOn = False#不开启地图填充,关于陆地海洋内陆水的填充自然不需要
1 l5 H; Q6 K; z7 u5 c7 L: F cnres.tiMainString = "e_first_model" J0 O- y. Q- Z( i5 y
p1= Ngl.contour_map(wks,e_2d[:,:,0],cnres)
" V5 y% B' g/ c4 X _7 f3 G% h8 ]/ S! ^5 g% X
xyres = Ngl.Resources()+ l' L4 O7 Q3 x* y: v, s9 Z$ _
xyres.nglDraw = False#因为要绘制叠加图先阻止画图
* P( O( B0 N, \1 ? xyres.nglFrame = False#关闭框架与上一条搭配使用
& @; @8 ^$ N/ q% s5 R5 Q3 u' | xyres.nglMaximize = False#必须关闭最大化绘图不然下面的调整plot box的参数是无效的
: [5 b; U& g6 e, t$ t xyres.vpXF = 0.59 # The left side of the box( f0 [! p. S) H$ J6 E7 l a: S7 g
xyres.vpYF = 0.645 # The top side of the plot box
0 W3 p7 U4 r; _& V+ n xyres.vpWidthF = 0.4 # The Width of the plot box
. A3 o# ?( j, Y- _) \$ o xyres.vpHeightF = 0.32 # The height of the plot box
/ H6 B+ e* _6 B5 t* p' B) W xyres.tiXAxisString = "Jan of Each Year"
) s8 @% `3 j% V5 A xyres.tmXBMode = "Explicit" # Define your own tick mark labels.8 @3 g4 j! L' e. s' p$ p
xyres.tmXBValues = list(range(1,20,1))# Values from 1 to 19.' v' m4 q: q5 H0 z% c% O
xyres.tmXBLabels = ["00","01","02","03","04","05","06","07","08","09","10","11","12","13","14","15","16","17","18"]
8 f( z4 F: g& y2 H xyres.tiMainString = "p_first_model"" g& w/ V m' s2 Q' q
x=np.arange(1,21,1)
/ G; z. s3 D; k, b* o4 F p2 = Ngl.xy(wks,x,p_t[0],xyres)
0 d9 Z* m2 |4 ^# V% @; q" U
, ^' t, d; o. E A* n3 w
1 ]- s: I& G: }/ s" d D Ngl.draw(p1)* d4 R5 J" h5 t/ R: n
Ngl.draw(p2)
) Y1 X& D8 O# B* T( q Ngl.frame(wks)& K4 L' }8 E$ s: r( t' l) k9 n
Ngl.end() , W5 e9 C7 w1 |) X8 R: `
: b' y; i5 E* d! g. I- {* e1 G7 C3 L
0 F7 T5 i6 E. c2 `! g; Q- J1 ]- _0 U K: k7 k* _$ S* m
5 g8 t6 A2 u( z2 Y) f
|