一把瑞士军刀用来制造氢紊乱的冰结构。
GenIce的Python项目详细描述
精灵
一把瑞士军刀,用来制造氢紊乱的冰结构。
版本1.0rc5
要求
- 网络x>;=2
- 计数环>;=0.1.4
- pairlist=0.2.3
- YaplotLib=0.1
- 努比
安装
genice注册到pypi(python包索引)。 与PIP3一起安装。
pip3 install genice
卸载
pip3 uninstall genice
用法
usage: genice [-h] [--version] [--rep REP REP REP] [--dens DENS]
[--add_noise percent] [--seed SEED] [--format gmeqdypoc]
[--water model] [--guest D=empty] [--Guest 13=me]
[--Group 13=bu-:0] [--anion 3=Cl] [--cation 3=Na]
[--visual visual] [--nodep] [--asis] [--debug] [--quiet]
Type
GenIce is a swiss army knife to generate hydrogen-disordered ice structures.
(version 1.0rc5)
positional arguments:
Type Crystal type (1c,1h,etc. See
https://github.com/vitroid/GenIce for available ice
structures.)
optional arguments:
-h, --help show this help message and exit
--version, -V show program's version number and exit
--rep REP REP REP, -r REP REP REP
Repeat the unit cell in x,y, and z directions. [1,1,1]
--dens DENS, -d DENS Specify the ice density in g/cm3
--add_noise percent Add a Gauss noise with given width (SD) to the
molecular positions of water. The value 1 corresponds
to 1 percent of the molecular diameter of water.
--seed SEED, -s SEED Random seed [1000]
--format gmeqdypoc, -f gmeqdypoc
Specify file format [g(romacs)|m(dview)|e(uler)|q(uate
rnion)|d(igraph)|y(aplot)|p(ython
module)|o(penScad)|c(entersofmass)|r(elative com)]
[gromacs]
--water model, -w model
Specify water model. (tip3p, tip4p, etc.) [tip3p]
--guest D=empty, -g D=empty
Specify guest(s) in the cage type. (D=empty,
T=co2*0.5+me*0.3, etc.)
--Guest 13=me, -G 13=me
Specify guest in the specific cage. (13=me, 32=co2,
etc.)
--Group 13=bu-:0, -H 13=bu-:0
Specify the group. (-H 13=bu-:0, etc.)
--anion 3=Cl, -a 3=Cl
Specify a monatomic anion that replaces a water
molecule. (3=Cl, 39=F, etc.)
--cation 3=Na, -c 3=Na
Specify a monatomic cation that replaces a water
molecule. (3=Na, 39=NH4, etc.)
--visual visual Specify the yaplot file to store the depolarization
paths. [""]
--nodep No depolarization.
--asis Assumes all given HB pairs to be fixed. No shuffle and
no depolarization.
--debug, -D Output debugging info.
--quiet, -q Do not output progress messages.
如果要在不安装的情况下使用genice,请使用/genice.x而不是
genice
。
示例
在格罗马克中制备3x3x3单位氢无序冰iv(4)的tip4p水 .gro格式:
genice --water tip4p --rep 3 3 3 4 > ice4.gro
制备2x2x4单元的cs2包合物tip4p水的水合物结构 在格罗马克的大笼子里的thf(具有虚拟位置的联合原子) .gro格式:
genice -g 16=uathf6 --water tip4p --rep 2 2 4 CS2 > cs2-224.gro
基本知识
程序生成了各种质子无序、无缺陷的冰晶格。总偶极矩始终设置为零(指定--nodep
选项的情况除外)。由于周期性边界条件下很难处理微小晶格的氢键网络拓扑结构,所以具有--rep 1 1选项的最小结构并不总是晶格的单元。请注意,根据势能,生成的结构不是最优的。
要获得xyz格式的ICE IH的大量重复,
genice --rep 8 8 8 1h --format xyz > 1hx888.xyz
要以CIF格式获得不同氢阶的ICE V晶格,请使用
-s
选项指定随机种子。genice 5 -s 1024 --format cif > 5-1024.cif
要获得具有不同密度且采用Gromacs格式的Tip4p水模型的冰vi晶格,请使用
--dens x
选项以g cm-3为单位指定密度。genice 6 --dens 1.00 --format g --water tip4p > 6d1.00.gro
Genice是一个模块化程序;它从Lattices文件夹中定义的Lattice插件读取单元单元数据,使用分子/文件夹中定义的分子插件放置水和客分子,并使用格式/文件夹中定义的格式插件以各种格式输出。您可以编写自己的插件来扩展genice。有些插件也接受选项。
包合水合物
对于包合物水合物,可以制备部分由各种客体分子占据的笼状晶格。
合成含co2的tip4p水的cs1包合水合物结构 .gro格式:(60%的小笼子充满二氧化碳,40%是甲烷)
genice -g 12=co2*0.6+me*0.4 -g 14=co2 --water tip4p CS1 > cs1.gro
要在一个大笼子中使含有thf分子的tip5p水的cs2包合水合物结构,而只有一个笼子充满甲烷分子,首先只需运行genice而不需要客户规范:
0pip3 install genice
笼子列表将输出如下:
1pip3 install genice
这表明有两种类型的笼子命名为
12
和16
。用四氢呋喃填充16
笼,并将甲烷分子放入0
第12类笼中,如下所示:
2pip3 install genice
虽然只有少数几种客体分子是预先设定的,你可以很容易地准备新的客体分子作为一个模块。下面是环氧乙烷分子的一个例子。
eo.py
pip3 install genice
3
用eo.py编写代码。在当前工作目录中创建一个名为"分子"的文件夹并将其放入。
注意:未实现多人入住。如果需要,可以用包含多个分子的虚拟分子制作一个模块。
掺杂离子
小离子可以取代宿主分子。在这种情况下,您可以使用-a
和-c
用阴离子和阳离子替换指定水分子的选项。
下面的示例用钠离子替换第n个水分子(在复制晶格中),用氯离子替换第1个水分子。离子周围的氢键被适当地组织起来。
pip3 install genice
4
注1:阳离子和阴离子的数量必须相同。否则,ICE规则永远无法满足,程序也不会停止。
注2:还需要选项--nodep
,因为不可能使含有离子的结构去极化。
注3:质子缺陷(h3o+和oh-)尚未实现。
半lathrate水合物
四丁基铵离子的放置
假设水分子的id被tba的氮所取代为零。将氮气作为阳离子,并用反离子br替换水2。
pip3 install genice
5
然后您将看到以下信息。
pip3 install genice
6
这表明氮被ID为9、2、28和7的笼子包围。这些笼子的类型也可以在信息中找到。然后,我们将bu-基团(负数不代表离子)放在这些笼中,相邻的掺杂剂是0。
pip3 install genice
7
在这里,选项-h
指定分组依据-h(cage id)=(组名称):(根)
,根是由-c
(阳离子)选项指定的氮。
在晶格模块中放置tbab
正在准备中
如果半lathrate水合物的晶格预先在适当的位置含有分子离子,则更为方便。在这里,我们将解释如何制作组装体专用模块。 肛交是精灵的变种。analice读取gromacs文件,不修改分子取向或氢键网络拓扑。分析准备用于结构分析。 例如,如果要查看给定 如果要将水模型从原来的三站点一(描述为ow、hw1和hw2)替换为tip4p-like-four-site模型,请尝试 所有输出格式也可用于分析。 从一组.gro文件中每10帧加载一次,并在单独的文件中输出环统计信息。 从给定的一组.gro文件中创建V形结构(去除水的快速平动)。 它们通常用于 您可以准备自己的文件格式。在当前工作目录中创建名为 在内部,有七个阶段产生冰结构。 在格式插件中,定义在处理每个阶段后调用的挂钩函数。 带有双引号的ICE名称未经实验验证。 你可以准备你自己的冰结构。在当前工作目录并将插件放入其中。genice 1.0不再引用 cif2ice是检索
沸石的cif文件来自iza结构数据库,并准备一个晶格
上述路径中的模块。 注意:不同框架中的某些结构是相同的。 FI:填充冰;CH:包合水合物;FK:Frank Kasper Duals;Zeo:沸石。 -:无对应关系;*:非FK类型。 请让vitroid@gmail.com添加新的冰结构。 可以使用 你可以准备自己的客体分子。在当前工作目录中创建一个名为 (v1.0中的新功能) 一些额外的插件可以使用pip命令通过python包索引获得。 例如,可以通过以下命令安装rdf插件, 并将其用作输出格式以获得径向分布函数。 分析插件是一种输出插件(用-f选项指定)。它们对分析命令很有用。 输入插件(又称点阵插件)按需构造晶体结构。 我们在最近的论文中解释了制造去极化氢无序冰的算法: M.Masakazu,T.Yagasaki和H.Tanaka,"精灵:氢紊乱"
制冰机",J.Comput.化学。3961-64(2017年)。doi:10.1002/jcc.25077 从2015年起,Genice作为一个开源软件在GitHub(https://github.com/vitroid/genice/" rel="nofollow">https://github.com/vitroid/genice/)提供服务。我们衷心感谢您的反馈、改进和扩展建议以及错误修复。也欢迎开发人员和测试用户。请告诉我们是否有已发布但不在genice中的ice。分析命令
.gro
文件的环统计信息,请按如下方式使用:
8
pip3 install genice
9
pip3 install genice
更多示例
0
pip3 uninstall genice
1
pip3 uninstall genice
使用
分析
2
pip3 uninstall genice
输出格式
genice
和analice
< /广告><正文>名称 应用程序
扩展名 水 溶质
备注
`到岸价,CIF2 CIF .cif
原子位置 原子位置 无 实验性 g
,gromacs
gromacs .gro
原子位置 原子位置 无 默认格式。 m
,mdview
mdview .mdv
原子位置 原子位置 自动 mdv_au
mdview .mdv
原子位置 原子位置 自动 原子单位。 o
,openscad
openscad .scad
质心 无 O 有关用法,请参阅测试/art/openscad。 povray
波夫雷 .pov
原子位置 原子位置 O towhee
托希 .coords
(?)原子位置 原子位置 无
XYZ xyz
.xyz
原子位置 原子位置 无 实验性 exyz
扩展xyz .xyz
原子位置 原子位置 无 open babel中定义的扩展xyz格式 exyz2
扩展xyz .xyz
原子位置 原子位置 无 quip中定义的扩展xyz格式 y
,yaplot
yaplot .yap
原子位置 原子位置 O 它渲染(1)hb路径以减少网络极化。(2)结构中的环。(3)分子构型和hb网络。 e
,euler
欧拉角 .nx3A
刚性转子 无 无 q
,四元数
四元数 .nx4a
刚性转子 无 无 d
,有向图
有向图 .ngph
无 无 O 图形
图表 .ngph
无 无 O 实验性。 c
,com
质量中心 .ar3a
质心 无 无 r
,rcom
相对COM .ar3r
质心 无 无 在分数坐标系中。 p
,python
,重塑
python模块 .py
质心 无 无 正在开发中。 \u ringstat
环相统计 统计测试套件1:检查环相的出现频率,作为对中程紊乱的测试。 铃声
环统计 环数。 \u千克
柯克伍德G(R) 统计测试套件2:计算g(r)以检查分子取向中的长程无序。 formats
的文件夹,并将插件放入其中。genice 1.0不再引用~/.genice
文件夹中的文件。冰结构
<表><广告> < /广告><正文>符号 说明
1H、ICE1H、IH 最受欢迎的冰i(六边形) 1C,ICE1C,集成电路 立方型冰i < / TR>2,ICE2,II 氢有序冰ii 二维,ICE2D 假设氢无序冰II。[Nakamura 2015] 3、ICE3、III 常规高压ICE III.【Lobban 1998】 4、ICE4、IV 亚稳态高压冰IV.【Lobban 1998】 4R 具有正交单元的ICE IV。(测试) 5,冰5,v 单斜冰v(试验)。 5R 具有正交单元的冰v。(测试) 6、ICE6、VI 常规高压冰vi.【Lobban 1998】 6H 半格冰iv. 7、ICE7、VII 常规高压ICE VII.【Lobban 1998】 8、ICE8、VIII ICE VIII,ICE VII的氢有序对应物。[kuhs 1998] 9、ICE9、IX ICE IX,ICE III的氢有序对应物。[伦敦,1993年] 12、ICE12、XII 亚稳态高压ICE XII.【Lobban 1998】 13,ICE13,十三 ICE XIII,ICE V的氢有序对应物[Salzmann 2006] 16,ICE16,十六 负压冰十六【Falenty 2014】 17、ICE17、XVII 负压冰十七【德尔罗索2016】 0,冰0 假设冰"0"。[俄罗斯统计局2014年] < 假想冰"我"。=BCT沸石。[芬内尔,2005年] A、ICEA 假设氢有序ICES"A"和"B"。[贝兹1998年] b,冰山 假设氢有序ICES"A"和"B"。[贝兹1998年] C0,C0-II 充冰C0(别名17)。[Smirnov 2013] C1 充冰C1(别名2)。[伦敦,1988年] <
充冰C2(别名1C)。[VOS 1993] 初夜 装满冰块的"ST"。[斯米尔诺夫2013年] cs1,cs2,cs4,ts1,hs1,hs2,hs3 包合水合物,Kosyakov的命名法。[科索沃1999年] Si、SiI、SiII、SiV、SV、SVII、SH 包合水合物,杰弗里的命名法。[杰弗里1984年] < TH> Rho 假设为负压冰"SIII"。[黄2016] FAU 假想的负压冰"siv"。[黄2017] 假设有一个大洞的冰。[Liu 2019] DOH、MEP、MTN、SOD 分别为hs3、cs1、cs2和cs4的别名。 crn1、crn2、crn3 四坐标连续随机网络[Mousseau 2005] 结构01..结构84 空间富勒烯[Dutour Sikiric 2010] A15、西格玛、HCOMP、KCOMP、Z、MU、ZRA-D、FK9层、FK6层、C36、C15、C14、Delta、PSIGMA 空间富勒烯,结构的别名?系列。他们的名字见数据源。[Dutour Sikiric 2010年] 空间富勒烯T型,【Dutour Sikiric 2010】II+IVA。[Karttunen 2011年] xfau[2]、xfau[4]、xfau[16]、… Aeroices,即扩展FAU。[松井2017年] xfau2[2],xfau2[4],xfau2[16],… Aeroices,即扩展FAU。[Matsui 2017年](氢键取向被修改) 制冰机 部分塑料冰R【Mochizuki 2014】。 ICET 部分塑料冰T【平田2017】。 ICET2 部分塑料冰T2【Yagasaki 2018】。 DTC 含圆柱孔的超低密度冰。[松井2019年] 棱镜[4],棱镜[5],棱镜[6],… 冰纳米管。[Koga 2001]。 ~/.genice
文件夹中的文件。 < /广告><正文>ch/fi Si/Td> CS1 - SII CS2 C15 MTN SIII TS1 - 西格玛 - SIV HS1 - Z - SV HS2 - * - SVII CS4 - * SOD SH <
- * doh < /td> C0 - * - C1 - * - <
- 1C * - 水模型
--water
选项选择水模型。 < /广告><正文>符号 键入 3站点
,tip3p
3站点tip3p(默认) 4站点
,tip4p
4站点tip4p ice
tip4p/ice 5site
,tip5p
5站点tip5p 6站点
,nvde
6站点nvde 客体分子
<表><广告> < /广告><正文>符号 键入 二氧化碳
co2 me
联合原子单原子甲烷 uatff
联合原子5位thf g12
,g14
,g15
,g16
单原子假位点 空
保持笼子空着。 molecules
的文件夹,并将插件放入其中。genice 1.0不再引用~/.genice
文件夹中的文件。附加插件
3
pip3 uninstall genice
4
pip3 uninstall genice
输出和分析插件
< /广告><正文>PIP名称 精灵选项
说明
输出格式
要求
genice rdf
-f RDF
径向分布函数。 文本 genice svg
-f svg
-f png
SVG格式的二维图形。
…PNG格式。svg
pngsvgwrite
genice vpython
-f vpython
使用vpython在浏览器中显示结构。 (无) vpython
genice twist
-f扭曲
计算扭曲顺序参数(并可视化)[Matsumoto 2019] 文本
svg
png
yaplottwist op
,genice svg
输入插件
< /广告><正文>PIP名称 精灵用法
说明
要求
genice到岸价
Genice到岸价[到岸价]
Genice沸石[到岸价]读取本地CIF文件作为ICE结构。
从沸石DB读取结构。cif2ice
参考资料
算法和引用方法。
如何贡献
推荐PyPI第三方库