Two audiences, one page. The first half is for anyone using the database through the browser. The second half is for anyone wiring KiwiChem into another application — which is what it was built for: it is a parameter source that happens to have an interface, not the other way round.
两类读者,一个页面。前半部分写给通过浏览器使用数据库的人。后半部分写给要把 KiwiChem 接入其他应用的人——这正是它的设计初衷:它是一个碰巧带有界面的参数来源,而不是反过来。
1Getting started入门
Open index.html. No server, no build step, no network. The data are plain <script> tags rather than fetch() calls precisely so that the database works from a USB stick on a site visit with no signal.
打开 index.html。不需要服务器,不需要构建步骤,也不需要网络。数据以普通的 <script> 标签而不是 fetch() 调用加载,正是为了让数据库在没有信号的现场考察中也能从 U 盘运行。
Thirteen tabs. Everything KiwiChem holds on a chemical used to arrive in one Results tab, eleven sections deep, with the soil guideline values and the food limits in the same scroll; each dataset now has its own destination and Overview is the way in.
共有十三个选项卡。KiwiChem 关于一种化学物质的全部内容,过去都集中在一个“结果”选项卡里,往下有十一个部分,土壤指导值和食品限量挤在同一屏滚动中;现在每个数据集都有自己的去处,“概览”是入口。
- Inputs
- The periodic table, the compound classes, and every parameter that shapes what the rest of the tabs report.
- Overview
- What the chemical is, the screening assessment if you have entered a concentration, and one line from each dataset with a button through to it.
- Background
- What is in New Zealand soil before anyone put anything there: nationally, by region and by parent material.
- Soil guidelines
- One row per jurisdiction and land-use scenario. The badge on the tab is how many.
- Drinking water
- Standards, guideline values and screening levels from nine instruments.
- Food
- Maximum levels by food group, and the health-based guidance values they derive from.
- Plants
- Leaf-tissue interpretation ranges, transfer factors, phytotoxic soil concentrations and hyperaccumulation thresholds.
- Kd & mobility
- How strongly the soil holds it, by soil type and by condition, and what that implies for leaching — see section 4b.
- Fate & toxicity
- Half-life, physicochemical constants, reference doses and slope factors.
- Cycle
- Where the selection comes from, what it turns into and where it goes, under conditions you set. Modelled, not looked up — see section 5.
- Orbitals
- Why the element bonds the way it does: the molecular orbital diagram of it and one thing it might be bound to. Also a construction — see section 6.
- Compare
- Up to eight chemicals side by side on the same twenty-three quantities.
- Sources
- The jurisdiction keys, the food group definitions, every correction this application has made to a published value, the instrument notes in full, and the reference list. Read this before comparing a value from one jurisdiction with a value from another.
- 输入
- 元素周期表、化合物类别,以及决定其余各选项卡报告内容的所有参数。
- 概览
- 这种化学物质是什么;如果你输入了浓度,还有筛查评估;以及每个数据集的一行摘要,附有跳转按钮。
- 本底
- 在任何人往新西兰土壤里加入任何东西之前,土壤中原本含有的量:全国、按地区和按母质。
- 土壤指导值
- 每个管辖区和土地利用情景各一行。选项卡上的徽标显示行数。
- 饮用水
- 来自九部法规文件的标准、指导值和筛查水平。
- 食品
- 按食品类别列出的最高限量,以及它们所依据的健康指导值。
- 植物
- 叶片组织诊断范围、转移系数、植物毒性土壤浓度和超富集阈值。
- Kd 与迁移性
- 土壤对它的吸持有多强,按土壤类型和条件区分,以及这对淋溶意味着什么——见第 4b 节。
- 归趋与毒性
- 半衰期、物理化学常数、参考剂量和斜率因子。
- 循环
- 所选对象从哪里来、转化成什么、去往哪里,条件由你设定。这是模拟出来的,而不是查表得到的——见第 5 节。
- 轨道
- 该元素为何以这种方式成键:它与一个可能与之结合的对象所构成的分子轨道图。同样是一种构建——见第 6 节。
- 比较
- 最多八种化学物质并排,对比同样的二十三个量。
- 来源
- 管辖区代码、食品类别定义、本应用对已发表数值所做的每一处更正、法规文件说明全文,以及参考文献列表。在把一个管辖区的数值与另一个管辖区的数值作比较之前,请先读这里。
2Picking a chemical选择化学物质
Three ways, all equivalent.
有三种方式,完全等效。
- The periodic table. Click any element. A cell with a heavier border and a red dot has guideline values of its own; a green bar along the foot means the element has a curated biogeochemical cycle; a plain cell has background and plant data but no guideline anywhere in the world. Greyed cells hold nothing. A cell is live if it has any of the four — which is how carbon gets in: it holds no guideline value, no background distribution and no plant concentration anywhere in this database, and it still has the most consequential cycle in it, since every organic Kd in this database is derived from soil organic carbon.
- The class lists. Everything that is not an element, grouped by chemical class — PAHs, BTEX and VOCs, chlorinated solvents, TPH fractions, phenols, PCBs and dioxins, PFAS, organochlorine pesticides, current-use pesticides, and the odds and ends.
- Search. The box in the sidebar takes a name, a CAS number or an element symbol.
Cd,cadmiumand7440-43-9all land in the same place.
- 元素周期表。点击任一元素。边框加粗并带红点的单元格有其自身的指导值;底部有绿色横条表示该元素有经过整理的生物地球化学循环;普通单元格有本底和植物数据,但在世界任何地方都没有指导值。灰色单元格没有任何数据。一个单元格只要具备这四者中的任何一项就可以点选——碳正是这样进来的:在本数据库中,它没有任何指导值、本底分布或植物浓度,却拥有库中影响最为深远的循环,因为本数据库中每一个有机物的 Kd 都是由土壤有机碳推算的。
- 类别列表。所有不是元素的物质,按化学类别分组——多环芳烃、BTEX 与挥发性有机物、氯代溶剂、总石油烃馏分、酚类、多氯联苯与二噁英、PFAS、有机氯农药、现用农药,以及其他零散物质。
- 搜索。侧边栏中的搜索框接受名称、CAS 号或元素符号。
Cd、cadmium和7440-43-9都会指向同一处。
Hold Shift, Ctrl or Cmd while clicking to add a chemical to the comparison set instead of replacing the selection. The chips under the heading show what is selected; the first is the one every data tab reports on, and clicking another chip promotes it.
点击时按住 Shift、Ctrl 或 Cmd,可以把化学物质加入比较集,而不是替换当前选择。标题下方的标签显示已选内容;第一个是所有数据选项卡报告的对象,点击另一个标签会把它提到首位。
3The inputs, and what each changes输入项及其各自的影响
| Input | What it changes |
|---|---|
| Measured soil concentration | Turns on the whole screening section: hazard quotients against every guideline value, position in the background distribution, implied porewater, indicative plant concentration. Leave it blank and none of that is shown, because there is nothing to screen. |
| New Zealand region | Which background distribution the comparison uses. The full regional table is shown either way. |
| Land use scenario | Which soil guideline value the exported parameter bundle picks. If the chemical has no value under that scenario, the bundle falls back to the most protective value in the dataset and says so. |
| Restrict to jurisdiction | Filters the soil, water and food tables and the screening assessment. |
| Protection basis | Human health, ecological, or both. A human-health value protects the people on the site; an ecological value protects the soil biota, plants and stock. |
| Soil organic carbon | Sets Kd for an organic compound through Kd = Koc × foc. Does nothing for a metal, and the application says so rather than pretending otherwise. |
| Soil pH | The Kd reported on the Kd & mobility tab, for the twelve metals with a pH-specific value published, and the pH the Cycle tab runs at. The same number drives both, so a soil set up on one tab is the soil on the other. |
| Bulk density, water content | The solid–solution split, the retardation factor and the porewater concentration. |
| 输入项 | 影响什么 |
|---|---|
| 实测土壤浓度 | 开启整个筛查部分:相对于每个指导值的危害商、在本底分布中的位置、推算的孔隙水浓度、指示性植物浓度。留空则这些都不显示,因为没有可筛查的对象。 |
| 新西兰地区 | 比较时采用哪个本底分布。无论选择与否,都会显示完整的地区表。 |
| 土地利用情景 | 导出的参数包选用哪个土壤指导值。如果该化学物质在这一情景下没有数值,参数包会退而采用数据集中保护性最强的数值,并注明这一点。 |
| 限定管辖区 | 筛选土壤、水和食品表格以及筛查评估。 |
| 保护依据 | 人体健康、生态,或两者兼有。人体健康数值保护场地上的人;生态数值保护土壤生物、植物和牲畜。 |
| 土壤有机碳 | 通过 Kd = Koc × foc 设定有机化合物的 Kd。对金属不起作用,应用会如实说明,而不是装作有作用。 |
| 土壤 pH | 对于已发表 pH 特定数值的十二种金属,决定“Kd 与迁移性”选项卡上报告的 Kd;同时也是“循环”选项卡运行时的 pH。两者由同一个数字驱动,所以在一个选项卡上设定的土壤,就是另一个选项卡上的土壤。 |
| 容重、含水量 | 固液分配、阻滞因子和孔隙水浓度。 |
4Reading the results解读结果
Two conventions run through every table.
所有表格都遵循两条约定。
An empty cell means no value is published. It never means zero. Nothing in KiwiChem falls back to a default when a value is missing.
空单元格表示没有已发表的数值。它从不表示零。KiwiChem 中没有任何地方会在数值缺失时退而使用默认值。
Every value carries its confidence, and there are four states. cited was read from the instrument named in the source column when the workbook was compiled. verify was compiled from the literature and not checked cell by cell. checked was compared with the instrument itself in September 2026 and agreed. corrected did not agree, and the value shown is the instrument's; hover it for the value the workbook had and the document it was read from. The Sources tab lists all 85 corrections to the soil guideline values and all 17 to the drinking-water standards.
每个数值都附有其可信度,共有四种状态。已引用表示编制工作簿时从来源列所列的法规文件中读取。待核实表示根据文献编制,未逐格核对。已核对表示已于 2026 年 9 月与法规文件本身比对,结果一致。已更正表示比对不一致,显示的是法规文件中的数值;将鼠标悬停其上,可以看到工作簿原有的数值以及读取它所依据的文件。“来源”选项卡列出了对土壤指导值的全部 85 处更正和对饮用水标准的全部 17 处更正。
A note sits on a row only if it is about that row. The source workbooks carry one note per guideline set and repeat it on every row, which is how the cadmium rows came to be annotated with chromium and BTEX. Each row now keeps the part of the note that names its own chemical, or names nothing; the whole note is on the Sources tab, once per instrument.
注释只有在与某一行相关时才放在该行上。源工作簿每套指导值只有一条注释,却在每一行上重复,镉的那些行就是这样被注上了关于铬和 BTEX 的内容。现在每一行只保留注释中提到其自身化学物质的部分,或不提任何物质的部分;完整的注释在“来源”选项卡上,每部法规文件列一次。
4bThe Kd & mobility tab“Kd 与迁移性”选项卡
Kd is the ratio of what is on the solid to what is in the soil solution, in litres per kilogram. It is the hinge of every leaching question, and for a metal it is not a property of the element at all: cadmium's runs from about 15 L/kg in an acid mineral soil to 4300 at pH 8, and higher again in a peat. A single number for it is a placeholder for a soil you have not described.
Kd 是固相上的量与土壤溶液中的量之比,单位为升每千克。它是所有淋溶问题的关键所在,而对金属来说,它根本不是元素本身的属性:镉的 Kd 从酸性矿质土壤中的约 15 L/kg 到 pH 8 时的 4300,在泥炭中还要更高。给它一个单一数字,只是为一种你尚未描述的土壤占个位置。
So the tab reports the distribution, in four parts:
因此,该选项卡分四部分报告它的分布:
- At the soil you have set. Kd at the pH from the Inputs tab where a pH-specific value is published, with the retardation factor and the fraction on the solid phase that follow from it at your bulk density and water content.
- By soil type and condition. Every value the five compilations hold, plotted on a log axis and tabulated underneath: sand, loam, clay and organic soils; pH classes; cation exchange capacity for strontium; extractable iron for Cr(VI); and five soils from pH 4.5 to 8.2 measured the same way for seventy elements.
- What it implies for leaching. The soil concentration that would hold the most stringent drinking-water value in its porewater, worked out for each of those soils in turn, and compared with the New Zealand standard. This used to be a single line computed from a single Kd; the spread down the column is the honest answer.
- Every element. One row per element with a compiled Kd, the soil groups it is lowest and highest in, and what controls it. The noble gases are in it too, saying that nothing is sorbed — which is an answer, not a gap.
- 在你设定的土壤中。凡有已发表的 pH 特定数值,就给出“输入”选项卡所设 pH 下的 Kd,以及据此在你的容重和含水量下得出的阻滞因子和固相所占比例。
- 按土壤类型和条件。五部汇编收录的每一个数值,绘制在对数轴上并在下方列表:砂土、壤土、黏土和有机土壤;pH 等级;锶对应的阳离子交换量;Cr(VI) 对应的可提取铁;以及 pH 4.5 至 8.2 的五种土壤,以同一方法测定了七十种元素。
- 对淋溶意味着什么。使孔隙水恰好达到最严格饮用水数值的土壤浓度,对上述每种土壤依次计算,并与新西兰标准比较。过去这是由单一 Kd 算出的一行;这一列数值的离散范围才是诚实的答案。
- 每种元素。每种有汇编 Kd 的元素一行,列出其数值最低和最高的土壤组别,以及控制它的因素。惰性气体也在其中,表明没有任何吸附——这是一个答案,而不是空缺。
For an organic compound none of this applies: sorption really is to organic carbon, so the tab gives Kd = Koc × foc across the range of organic carbon a soil might have, with your own value marked.
对有机化合物来说,这些都不适用:它确实是吸附在有机碳上的,因此该选项卡在土壤可能具有的有机碳范围内给出 Kd = Koc × foc,并标出你自己的数值。
5The Cycle tab“循环”选项卡
Select any element or compound and the Cycle tab shows where it comes from, what it turns into, and where it goes, in the water–soil–plant–atmosphere system. Five sliders set the soil it is doing that in: pH, redox potential, electrical conductivity, temperature and water flux. Every arrow is scaled to the size of its flux, so the diagram is a statement about magnitude and not only about direction, and the arrows redraw as you drag.
选择任一元素或化合物,“循环”选项卡就会显示它在水–土壤–植物–大气系统中从哪里来、转化成什么、去往哪里。五个滑块设定它所处的土壤:pH、氧化还原电位、电导率、温度和水通量。每个箭头都按其通量大小缩放,因此这张图表达的是量级,而不仅仅是方向;拖动滑块时,箭头会随之重绘。
Reading the boxes解读方框
Each box is a chemical species: not “the solid phase” but Zn–SOM, ZnS, exchangeable Zn. They are coloured by phase — in solution, exchangeable, sorbed, mineral, organic, living biomass — because whether a species is in solution decides whether it leaches, and whether it is a mineral decides whether it is coming back. Hover a box for what the pool is and why it matters; the same notes are in the species table under the diagram.
每个方框代表一种化学形态:不是“固相”,而是 Zn–SOM、ZnS、可交换态 Zn。方框按相态着色——溶液态、可交换态、吸附态、矿物态、有机态、活体生物量——因为一种形态是否处于溶液中,决定了它是否会淋溶;而它是否是矿物,决定了它是否还会重新释放出来。将鼠标悬停在方框上,可以查看该库是什么以及它为何重要;图下方的形态表中有同样的说明。
The boxes are not sized to how much is in them. The model does not solve the equilibrium system and makes no claim about the split. Only the arrows carry magnitude.
方框的大小并不反映其中的量。模型不求解平衡体系,也不对各部分之间的分配作任何断言。只有箭头表示量级。
Reading the arrows解读箭头
There are two scales on the diagram and the legend names both.
图上有两种标度,图例中两者都有标明。
Solid arrows are mass fluxes in g/ha/yr, computed from a database value through a formula printed further down the page, and drawn on one common scale — so a leaching arrow and an uptake arrow can be compared with each other directly by eye. Leaching, plant uptake, litter return and harvest removal are quantified whenever the underlying Kd or transfer factor exists.
实线箭头是质量通量,单位为 g/ha/yr,由数据库中的数值通过本页下方列出的公式计算,并绘制在同一个共同标度上——因此淋溶箭头和吸收箭头可以直接用肉眼相互比较。只要相应的 Kd 或转移系数存在,淋溶、植物吸收、凋落物归还和收获移出都会被量化。
Translucent, dashed arrows are relative indices in which the reference soil is ×1. They say which way a flux moves and roughly how far, and they are not rates. The inputs, the transformations and volatilisation are all indices.
半透明的虚线箭头是相对指数,以参比土壤为 ×1。它们表明通量朝哪个方向变化、大致变化多少,而不是速率。输入、转化和挥发都是指数。
Width is logarithmic in both cases: each doubling of width is roughly a tenfold flux. The fluxes on one diagram routinely differ by four orders of magnitude, and a linear scale would draw all but one of them as a hairline.
两种情况下宽度都按对数取值:宽度每增加一倍,大致相当于通量增加十倍。同一张图上的通量常常相差四个数量级,线性标度会把除一个以外的所有箭头都画成细线。
Arrows are coloured by what drives the reaction: physicochemical, microbial, plant, gaseous loss and leaching. That is the distinction worth having, because it says which slider to reach for — a microbial reaction responds to temperature, a sorption reaction to pH.
箭头按驱动反应的因素着色:物理化学、微生物、植物、气态损失和淋溶。这个区分值得保留,因为它告诉你该去调哪个滑块——微生物反应对温度有响应,吸附反应对 pH 有响应。
A reaction running at under a tenth of its reference rate keeps its arrow but loses its label. Methanogenesis in a well-drained soil, or sulphide precipitation at +450 mV, is a real pathway that is not currently doing anything, and naming it would crowd out the reactions that are. Drag the redox slider down and the labels appear as the reactions start.
运行速率不到其参比速率十分之一的反应保留箭头,但不显示标签。排水良好土壤中的产甲烷作用,或 +450 mV 下的硫化物沉淀,都是真实存在、但目前没有在起作用的途径;给它们标名会挤掉正在起作用的反应。把氧化还原滑块往下拖,随着反应启动,标签就会出现。
Where the mass fluxes get their concentration质量通量所用的浓度从哪里来
From the measured soil concentration on the Inputs tab if you have entered one. If you have not, from the New Zealand background median for that element — regional if you have chosen a region. The flag above the diagram always says which, and a cycle computed from a background median is a different statement from one computed from your own sample.
如果你在“输入”选项卡上输入了实测土壤浓度,就用它。如果没有,就用该元素的新西兰本底中位数——如果你选择了地区,则用该地区的中位数。图上方的标志始终注明用的是哪一种;由本底中位数算出的循环,与由你自己的样品算出的循环,是两种不同的陈述。
Carbon and nitrogen are not in the background survey, so both are tied to the organic-carbon fraction on the Inputs tab: carbon straight from it, nitrogen from it at a C:N ratio of 12. Change the organic carbon and the whole budget follows. If a chemical has no concentration from any route, the diagram still draws but every arrow becomes an index.
碳和氮不在本底调查之列,因此两者都与“输入”选项卡上的有机碳比例挂钩:碳直接取自它,氮则按 12 的 C:N 比由它推得。改变有机碳,整个收支随之变化。如果一种化学物质无法从任何途径得到浓度,图仍会绘制,但每个箭头都变成指数。
The presets预设
Five soils are worth looking at before you start dragging: well-drained pasture, limed, acid and unlimed, flooded, and saline irrigation. They exist because the interesting behaviour is at the ends of the ranges and it is easy to miss. Watch what flooding does to arsenic, what liming does to cadmium and to molybdenum in opposite directions, and what salinity does to cadmium through chloride complexation.
在开始拖动滑块之前,有五种土壤值得一看:排水良好的牧场、施过石灰、酸性且未施石灰、淹水,以及咸水灌溉。设置它们是因为有趣的行为出现在取值范围的两端,很容易错过。看看淹水对砷有什么影响,施石灰对镉和钼产生方向相反的什么影响,以及盐度如何通过氯离子络合作用影响镉。
What is on the page under the diagram图下方的页面内容
- The form it is in. The dominant species at the pH and Eh set, with the other forms it takes and the conditions that produce them.
- The species, and where each one sits: every box on the diagram, its phase, and what the pool actually is.
- Every flux, with its magnitude, which sliders move it, and what it physically is.
- How the numbers are produced: the reference soil, the shift applied to Kd, each formula, the system assumptions, and an explicit account of what the model does not do.
- 它所处的形态。在所设 pH 和 Eh 下的优势形态,以及它可能呈现的其他形态和产生这些形态的条件。
- 各形态及其所处位置:图上的每个方框、其相态,以及该库实际是什么。
- 每项通量:其大小、哪些滑块会改变它,以及它在物理上是什么。
- 数字是如何得出的:参比土壤、施加于 Kd 的偏移、每个公式、体系假设,以及对模型不做什么的明确说明。
6The Orbitals tab“轨道”选项卡
Every other tab answers where an element goes. This one answers why. Pick an element on the Inputs tab, choose something for it to be bound to from the dropdown, and the tab draws the molecular orbital diagram of that pair: the valence orbitals of each atom on the left and the right, the molecular orbitals they combine into down the middle, and the electrons in them.
其他每个选项卡回答的都是元素去往哪里。这个选项卡回答的是为什么。在“输入”选项卡上选一个元素,从下拉列表中选择与之结合的对象,该选项卡就会绘制这一对的分子轨道图:两侧是各原子的价轨道,中间是它们组合成的分子轨道,以及其中的电子。
What it is doing它在做什么
A two-centre extended Hückel calculation. Each valence orbital contributes its valence orbital ionisation energy on the diagonal; every pair of orbitals on different atoms contributes a Wolfsberg–Helmholz off-diagonal term; and the generalised eigenproblem is solved once for each symmetry species about the line between the two nuclei — σ from s, pz and dz2; π from px and dxz; δ from dxy. Orbitals of different symmetry about that axis cannot mix, so nothing is lost by splitting it up, and solving the whole σ block at once is what puts s–p mixing in.
双中心扩展 Hückel 计算。每个价轨道在对角线上贡献其价轨道电离能;不同原子上的每一对轨道贡献一个 Wolfsberg–Helmholz 非对角项;并且针对两核连线的每一个对称类各求解一次广义本征值问题——σ 来自 s、pz 和 dz2;π 来自 px 和 dxz;δ 来自 dxy。关于该轴对称性不同的轨道不能混合,因此分开求解并无损失;而一次求解整个 σ 块,正是引入 s–p 混合的方式。
The interaction parameters are not overlap integrals of a real geometry — there is no bond length in the calculation. They were fitted so that the construction reproduces the second-row homonuclear diatomics B2, C2, N2, O2 and F2 in all three respects at once: bond order, unpaired electrons, and the switch in level ordering between N2, where the π pair lies below the σ, and O2, where it does not. That is the only claim they support, and you can check it yourself: run KiwiChem.orbitalSelfTest() in the browser console.
相互作用参数并不是真实几何构型下的重叠积分——计算中没有键长。它们经过拟合,使这一构建能在三个方面同时重现第二周期同核双原子分子 B2、C2、N2、O2 和 F2:键级、未成对电子,以及能级顺序在 N2(π 对位于 σ 之下)与 O2(并非如此)之间的翻转。这是它们所能支持的唯一结论,你可以自己检验:在浏览器控制台中运行 KiwiChem.orbitalSelfTest()。
The two bond orders两种键级
The tab reports both, because one will not do. The formal count is what every textbook teaches: bonding electrons less antibonding, halved. It is exact for a homonuclear pair, where every orbital is shared evenly between the two atoms. It over-counts a polar bond, because an orbital that has all but collapsed onto one atom — a lone pair in everything but name — still shows a trace of positive overlap and gets counted as a whole bond. The bond order proper is the same count with each orbital weighted by how far it is actually shared. The two agree wherever the formal number means anything, and the weighted one is the one to read for a polar pair. Where the bonding electrons have collapsed onto one atom altogether the tab says so outright: that is an ion pair, not a bond with an order.
该选项卡两者都报告,因为只有一个不够。形式计数是每本教科书都教的:成键电子数减去反键电子数,再除以二。对同核原子对,它是精确的,因为每个轨道都在两个原子之间均匀共享。对极性键,它会高估,因为一个几乎完全塌缩到一个原子上的轨道——除了名称之外就是一对孤对电子——仍会显示出一丝正的重叠,并被算作一整个键。真正的键级是同样的计数,但每个轨道按其实际被共享的程度加权。凡是形式数值有意义的地方,两者都一致;对极性原子对,应读加权的那一个。如果成键电子已完全塌缩到一个原子上,该选项卡会直接说明:那是离子对,而不是有键级的键。
What it is good for它有什么用
The comparison, mostly, and one comparison in particular. Draw cadmium against oxygen and then against sulphur: the bond order rises from 1.34 to 1.72 and the sharing of the occupied bonding orbitals — the number the ionic-versus-covalent flag is read off — from 0.34 to 0.43. Now do the same for calcium, and it barely moves: 0.17 against oxygen, 0.20 against sulphur, and both flagged ionic. Zinc, mercury, lead and copper all behave like cadmium, and copper most of all, its bonding electrons going from 28% on the metal against oxygen to 49% against sulphur. That is the soft-acid preference for a soft base, arrived at from orbital energies rather than asserted, and it is the shortest honest answer to why the chalcophile metals end up in sulphides under reducing conditions while calcium ends up in a carbonate. It is also why this tab is in a database of soil contaminants at all.
主要用于比较,尤其是某一种比较。先画镉对氧,再画镉对硫:键级从 1.34 升到 1.72,已占据成键轨道的共享程度——离子性与共价性标志正是据此读出的——从 0.34 升到 0.43。再对钙做同样的事,它几乎不变:对氧为 0.17,对硫为 0.20,两者都被标为离子性。锌、汞、铅和铜的表现都与镉类似,铜最为突出,其成键电子在金属上的比例从对氧时的 28% 变为对硫时的 49%。这就是软酸对软碱的偏好,由轨道能量推出,而不是直接断言;它也是对以下问题最简短的诚实回答:为什么亲硫金属在还原条件下最终形成硫化物,而钙最终形成碳酸盐。这也正是这个选项卡之所以出现在一个土壤污染物数据库中的原因。
What does not carry over is the geometry. This is two atoms in the gas phase; in a soil the same element is six-coordinate, hydrated and sitting on a surface, and the honest picture there is a ligand-field one. Trust the ordering of the levels, the sign of every interaction, which orbital is the HOMO, and the polarisation. Treat the energies in electronvolts as indicative. Do not read a bond energy, a bond length or a transition energy off it: none of the three is computed.
不能照搬过去的是几何构型。这里是气相中的两个原子;在土壤中,同一元素是六配位的、水合的,并且位于某个表面上,那里诚实的图景是配体场图景。可以相信能级的顺序、每个相互作用的符号、哪个轨道是 HOMO,以及极化。以电子伏特表示的能量只作参考。不要从中读取键能、键长或跃迁能:这三者都没有计算。
Which elements it covers它涵盖哪些元素
Those with a tabulated set of valence orbital energies — 41 of the 71 the periodic table offers, covering the s-, p- and d-block elements that matter most in a soil. The f-block is excluded on purpose: bonding through f orbitals is not a two-centre σ–π–δ problem and drawing it as one would be wrong rather than merely rough. The rest are simply not held, and rather than estimate them the tab says so and draws nothing.
有成套价轨道能量列表的元素——元素周期表所提供的 71 种中的 41 种,涵盖土壤中最重要的 s 区、p 区和 d 区元素。f 区被有意排除:通过 f 轨道成键不是一个双中心 σ–π–δ 问题,把它当作这样的问题来画是错误的,而不只是粗略。其余元素只是没有收录;该选项卡不去估算它们,而是如实说明,并且什么都不画。
Which pairs it offers它提供哪些配对
Only pairs that bond. The construction will draw a diagram for any two atoms it has parameters for, and for most pairs that diagram would be a fiction, so the second dropdown lists only elements the first one forms a known compound with, and names the compound where a short one exists — S — Sulfur · CdS, greenockite. Four rules decide it, and each is a claim about chemistry rather than about the model:
只提供能成键的配对。只要有参数,这一构建可以为任意两个原子画图,而对大多数配对来说,那张图会是虚构的;因此第二个下拉列表只列出与第一个元素能形成已知化合物的元素,并在有简短化合物时注明——S — 硫 · CdS,硫镉矿。由四条规则决定,每一条都是关于化学而不是关于模型的论断:
- Helium bonds to nothing, so it offers no partners at all and says why. Neither does any pair whose only compound is unknown — mercury and antimony, thallium and phosphorus, sulphur and iodine.
- Two metals are never offered. Brass and bronze are held together by electrons delocalised over the whole lattice, not by a bond between one pair of atoms, and a two-centre diagram of an alloy would say something false.
- An element pairs with itself only where the neutral diatomic is really bound. Be₂, Mg₂, Zn₂, Cd₂ and Hg₂ are van der Waals pairs with a bond order of zero; the Hg–Hg bond is real only in the mercury(I) ion Hg₂²⁺, which is not the neutral pair.
- A metal with a non-metal is offered unless no binary compound or characterised molecule of the two is known. The exceptions are listed in
js/orbitals.js, each one checkable.
- 氦不与任何元素成键,因此它不提供任何配对对象,并说明原因。凡是没有已知化合物的配对也同样不提供——汞与锑、铊与磷、硫与碘。
- 从不提供两种金属的配对。黄铜和青铜靠离域于整个晶格的电子结合在一起,而不是靠一对原子之间的键;合金的双中心图会给出错误的说法。
- 元素与自身配对,仅限于中性双原子分子确实成键的情况。Be₂、Mg₂、Zn₂、Cd₂ 和 Hg₂ 是键级为零的范德华对;Hg–Hg 键只在汞(I)离子 Hg₂²⁺ 中才真实存在,而那不是中性的原子对。
- 金属与非金属的配对会被提供,除非这两者没有任何已知的二元化合物或已表征的分子。例外情况列在
js/orbitals.js中,每一项都可以核查。
Change the element and a partner it cannot bond to gives way to oxygen, which bonds to everything that bonds at all.
更换元素后,若原配对对象无法与之成键,就会改为氧——凡是能成键的元素,都能与氧成键。
7Getting the data out导出数据
Export JSON writes the current selection, the inputs, the full parameter bundle for the primary chemical, a bundle for each chemical in the comparison set, the screening result if a concentration was entered, and the complete underlying record. That file is the same structure the API returns, so anything that reads one reads the other.
导出 JSON 会写出当前选择、输入项、主要化学物质的完整参数包、比较集中每种化学物质的参数包、筛查结果(如果输入了浓度),以及完整的底层记录。该文件与 API 返回的结构相同,因此能读其中一个的程序也能读另一个。
Copy link puts the whole state in the URL. Everything the application knows lives in the fragment, so a link reopens the same chemical, the same region and the same inputs on someone else's machine:
复制链接把全部状态放进 URL。应用所知道的一切都存放在片段标识中,因此一个链接能在别人的电脑上重新打开同一种化学物质、同一个地区和同样的输入项:
index.html#chemical=cadmium®ion=Waikato&conc=1.5&foc=0.03
Multiple chemicals are comma-separated, and any of region, landUse, jurisdiction, basis, foc, bulkDensity, waterContent and conc may be given. A query string works as well as a fragment, which is what another application should use when linking in.
多种化学物质用逗号分隔,region、landUse、jurisdiction、basis、foc、bulkDensity、waterContent 和 conc 中的任何一项都可以给出。查询字符串与片段标识同样可用,其他应用链接进来时应使用查询字符串。
The Cycle tab's five conditions travel in the same link, so a soil you have set up can be sent to someone else exactly as you left it:
“循环”选项卡的五个条件也随同一个链接传递,因此你设定好的土壤可以原样发给别人:
index.html#chemical=arsenic&pH=6.5&eh=-150&ec=0.3&temp=15&water=1200
pH, eh (mV), ec (dS/m), temp (°C) and water (mm/yr) are omitted from the link when they are at their defaults.
pH、eh(mV)、ec(dS/m)、temp(°C)和 water(mm/yr)处于默认值时,不会写入链接。
Print lays every tab out on the page at once, including the ones not currently open, so the printed record is complete.
打印会把所有选项卡同时排在页面上,包括当前未打开的选项卡,因此打印出的记录是完整的。
8Using KiwiChem from another application在其他应用中使用 KiwiChem
Load the data files, js/lookup.js and js/api.js. You do not need app.js, the stylesheets or any of the HTML: the interface depends on the data layer and nothing depends on the interface.
加载数据文件、js/lookup.js 和 js/api.js。你不需要 app.js、样式表或任何 HTML:界面依赖于数据层,而没有任何东西依赖于界面。
<script src="KiwiChem/data/elements.js"></script> <script src="KiwiChem/data/contaminants.js"></script> <script src="KiwiChem/data/properties.js"></script> <script src="KiwiChem/data/toxicity.js"></script> <script src="KiwiChem/data/plants.js"></script> <script src="KiwiChem/data/background.js"></script> <script src="KiwiChem/data/kd.js"></script> <script src="KiwiChem/data/geology.js"></script> <script src="KiwiChem/data/soil.js"></script> <script src="KiwiChem/data/water.js"></script> <script src="KiwiChem/data/food.js"></script> <script src="KiwiChem/data/sources.js"></script> <script src="KiwiChem/js/lookup.js"></script> <script src="KiwiChem/js/api.js"></script>
Everything is then on window.KiwiChem. Names, CAS numbers, element symbols and internal ids are all accepted wherever a chemical is asked for.
之后,一切都在 window.KiwiChem 上。凡是需要指定化学物质的地方,名称、CAS 号、元素符号和内部 id 都可以接受。
The parameter bundle参数包
The call most host applications want. It returns a flat object in which every field carries its value, its unit and its provenance — a parameter without provenance is not usable in a report.
这是大多数宿主应用需要的调用。它返回一个扁平对象,其中每个字段都带有数值、单位和数据出处——没有出处的参数不能用于报告。
var cd = KiwiChem.parameters("cadmium", {
foc: 0.04, // fraction organic carbon
bulkDensity: 1.1, // g/cm3
waterContent: 0.35, // cm3/cm3
region: "Waikato", // for the background distribution
landUse: "NZ-RURRES", // which soil guideline to pick
jurisdiction: "New Zealand"
});
cd.kd.value // 790 L/kg, the whole-soil median
cd.kd.kind // "total" — see kdProfile for the sorption end
cd.kdProfile.sorption.gm // 150 L/kg, geometric mean across soils (IAEA TRS-472)
cd.kdProfile.sorption.low // { kd: 15, label: "pH < 6.5" }
cd.kdProfile.sorption.high // { kd: 650, label: "Organic" }
cd.kdProfile.controls // why it moves: pH, organic matter, chloride, sulphide
cd.background.median // 0.37 mg/kg, Waikato topsoil
cd.background.p95 // 1.21
cd.soilGuideline.value // 0.8 mg/kg
cd.soilGuideline.note // "Most protective value matching the filter"
cd.plant.transferFactor // 1.0
cd.rfd.value // 0.001 mg/kg bw/day
cd.iarc // "1"Screening筛查
var s = KiwiChem.screen("cadmium", 1.5, { region: "Waikato" });
s.exceedances // 6
s.evaluated // 49
s.worst.row.jurisdiction // "Denmark"
s.worst.quotient // 3.0
s.background.band // "p95"
s.porewater.porewaterUgL // 2.99The rest of the surface接口的其余部分
| Call | Returns |
|---|---|
list(group?) | Every chemical, or every chemical in one class. |
groups() | The classes, in display order, with counts. |
elements() | The periodic table, with grid positions and abundances. |
regions() | The New Zealand regions the background is broken down by. |
search(text, limit?) | Names, CAS numbers, classes and symbols. |
resolve(query) | Any of those to the canonical id. |
get(query) | The whole joined record. |
element(symbol) | The same for an element, listed contaminant or not. |
kd(query, foc?, opts?) | Kd with its basis and kind. opts.pH gives the pH-specific sorption value where one is tabulated; opts.kind is "sorption" or "total". |
kdProfile(query) | Everything held for that element: by soil group, by condition, the field compilation, five measured soils, and what controls it. |
kdRows(query, opts?) | The same flattened to one row per condition, each saying which kind of Kd it is and where it came from. |
kdAtPH(symbol, pH, species?) | Sorption Kd at a soil pH, interpolated on log Kd (12 metals, pH 4.9 to 8.0). |
partition(query, opts) | Solid–solution split, retardation, porewater. |
decay(query, fraction?) | Time to a remaining fraction, from the DT50. |
background(symbol, conc?, region?) | The distribution, or a position in it. |
leachingScreen(query, opts) | Soil concentration in equilibrium with the drinking-water standard. |
soilGuidelines(query, opts) | Filtered rows: jurisdiction, scenario key, basis. |
waterStandards(query, opts) | The same for drinking water. |
foodStandards(query, opts) | The same for food, with a food-group filter. |
plant(symbol) | The plant interpretation ranges. |
properties(query), toxicity(query) | The compiled tables. |
jurisdiction(key) | What a scenario code such as NZ-RES means. |
landUses() | Every scenario key, for building a picker. |
reference(key) | A source key to its full citation and URL. |
data | The raw datasets, for anything the helpers do not cover. |
orbitals(a, b), orbitalElements() | The molecular orbital construction, and the elements it can be drawn for. |
selfTest(), orbitalSelfTest() | Counts and referential integrity across every table; and the five diatomics the orbital parameters were fitted to. |
| 调用 | 返回 |
|---|---|
list(group?) | 所有化学物质,或某一类别中的所有化学物质。 |
groups() | 各类别,按显示顺序排列,附数量。 |
elements() | 元素周期表,附网格位置和丰度。 |
regions() | 本底数据所细分的新西兰各地区。 |
search(text, limit?) | 名称、CAS 号、类别和符号。 |
resolve(query) | 把上述任一项解析为规范 id。 |
get(query) | 完整的联合记录。 |
element(symbol) | 元素的同类记录,无论是否列为污染物。 |
kd(query, foc?, opts?) | Kd 及其依据和类型。opts.pH 在有列表数值时给出 pH 特定的吸附值;opts.kind 为 "sorption" 或 "total"。 |
kdProfile(query) | 该元素所收录的全部内容:按土壤组别、按条件、野外汇编、五种实测土壤,以及控制它的因素。 |
kdRows(query, opts?) | 同样的内容展平为每个条件一行,每行注明它是哪一种 Kd 以及来源。 |
kdAtPH(symbol, pH, species?) | 某一土壤 pH 下的吸附 Kd,在 log Kd 上插值(12 种金属,pH 4.9 至 8.0)。 |
partition(query, opts) | 固液分配、阻滞、孔隙水。 |
decay(query, fraction?) | 根据 DT50 计算降至某一剩余比例所需的时间。 |
background(symbol, conc?, region?) | 分布,或在分布中的位置。 |
leachingScreen(query, opts) | 与饮用水标准达到平衡的土壤浓度。 |
soilGuidelines(query, opts) | 经筛选的行:管辖区、情景代码、依据。 |
waterStandards(query, opts) | 饮用水的同类结果。 |
foodStandards(query, opts) | 食品的同类结果,附食品类别筛选。 |
plant(symbol) | 植物诊断范围。 |
properties(query), toxicity(query) | 汇编的表格。 |
jurisdiction(key) | 诸如 NZ-RES 之类的情景代码的含义。 |
landUses() | 所有情景代码,用于构建选择器。 |
reference(key) | 把来源代码解析为完整引文和 URL。 |
data | 原始数据集,用于辅助函数未涵盖的任何用途。 |
orbitals(a, b), orbitalElements() | 分子轨道构建,以及可以为其绘图的元素。 |
selfTest(), orbitalSelfTest() | 所有表格的数量统计和引用完整性;以及轨道参数据以拟合的五个双原子分子。 |
Embedding in an iframe嵌入 iframe
A host page that does not want to load the data files itself can put the application in an iframe and ask it questions. The reply carries whatever requestId was sent, so several requests can be in flight at once.
不想自己加载数据文件的宿主页面,可以把应用放进 iframe 并向它提问。回复会带回发送时的 requestId,因此可以同时有多个请求在进行。
var frame = document.querySelector("iframe"); // src="KiwiChem/index.html"
window.addEventListener("message", function (e) {
var m = e.data;
if (m && m.kiwichemReply && m.requestId === 1) console.log(m.result);
});
frame.contentWindow.postMessage({
kiwichem: "parameters",
chemical: "cadmium",
requestId: 1,
options: { foc: 0.04, region: "Waikato" }
}, "*");The requests understood are parameters, get, screen, list and search, taking the same arguments as the direct calls. A reply carries kiwichemReply: true, the requestId it answers, and either result or error. Match on kiwichemReply rather than on kiwichem alone: the reply repeats the request name, so a handler that only checks the name will see its own replies.
可识别的请求有 parameters、get、screen、list 和 search,参数与直接调用相同。回复带有 kiwichemReply: true、它所回答的 requestId,以及 result 或 error 二者之一。应匹配 kiwichemReply,而不是只匹配 kiwichem:回复会重复请求名称,所以只检查名称的处理函数会收到自己发出的回复。
KiwiChem/index.html?chemical=cadmium®ion=Waikato&conc=1.5. The application opens on the Overview tab with that selection already made.KiwiChem/index.html?chemical=cadmium®ion=Waikato&conc=1.5。应用会在“概览”选项卡上打开,并已选好该化学物质。A subset of the data files is enough when only part of the API is used: a missing dataset reads as empty rather than failing. Leave out kd.js, though, only if no Kd is wanted: without it parameters() falls back to a coarser compiled Kd and kdProfile is missing, without any error.
只使用部分 API 时,加载部分数据文件就够了:缺失的数据集会被当作空数据,而不会导致失败。不过,只有在完全不需要 Kd 时才可省略 kd.js:没有它,parameters() 会退而使用较粗略的汇编 Kd,kdProfile 也会缺失,且不报任何错误。
On this site the API is used by three tools, each loading only the files it needs as <script> tags, and only when first wanted: KiwiSpec fills a trace metal's soil content from the New Zealand background and compares its computed Kd with the published range; KiwiFert's Contaminants tab takes cadmium's background and soil guideline values; and KiwiPest shows drinking-water standards, soil guideline values and fate data in the details of the 24 pesticides both hold. Each pesticide's page here links back to it with Assess in KiwiPest.
在本网站上,有三个工具使用该 API,每个都只以 <script> 标签加载自己需要的文件,并且只在首次需要时才加载:KiwiSpec 用新西兰本底值填入微量金属的土壤含量,并把计算出的 Kd 与已发表范围进行比较;KiwiFert 的“污染物”选项卡采用镉的本底值和土壤指导值;KiwiPest 在两者共有的 24 种农药的详情中显示饮用水标准、土壤指导值和归趋数据。这里每种农药的页面都以在 KiwiPest 中评估链接回 KiwiPest。
9Questions this raises由此引出的问题
- Why do twelve jurisdictions disagree by two orders of magnitude about the same element?
- Because they are answering different questions. Some values are screening levels set at a 1-in-a-million cancer risk with no site knowledge at all; some are investigation triggers; some are remediation standards negotiated against what is achievable. The Sources tab says which is which for every one of them, and the spread column on the source workbooks' comparison sheets is there to make the disagreement visible rather than hide it.
- My soil is above the guideline value. What now?
- Nothing that this application can tell you. Exceeding a screening level means the screening assumptions no longer suffice, not that harm is occurring — that is the point at which a site-specific assessment starts. In New Zealand, whether the NES-CS applies at all turns on the land use and the HAIL activity history, not on the concentration alone.
- Why is there no value for my compound?
- Most likely nobody has set one. Of the 273 contaminants here, 214 have no food limit in any of the eight jurisdictions covered, and glyphosate has no numeric soil guideline value anywhere in the twelve. An empty table is a finding.
- Can I use the background concentrations as a cleanup target?
- The 95th percentile of the relevant distribution is the usual upper limit of background, and section 5(9) of the NES-CS turns on whether contaminants are at or below background. Use the geology-based figure rather than the regional one where the element is covered: that is the comparison the Eco-SGVs are built on.
- How do I keep it current?
- Edit the workbooks in
archive/and re-runscripts/extract.py. The files indata/are generated and should never be hand-edited — every one of them says so at the top.
- 为什么十二个管辖区对同一种元素的规定会相差两个数量级?
- 因为它们回答的是不同的问题。有些数值是在完全不了解场地的情况下、按百万分之一致癌风险设定的筛查水平;有些是启动调查的触发值;有些是根据可实现程度协商得出的修复标准。来源选项卡为其中每一个注明了属于哪一类,而源工作簿比较表中的离散度一列,正是为了让分歧显露出来,而不是掩盖它。
- 我的土壤超过了指导值。接下来怎么办?
- 本应用无法告诉你任何事。超过筛查水平意味着筛查假设已不再足够,而不是说危害正在发生——这正是场地特定评估开始的地方。在新西兰,NES-CS 是否适用,取决于土地利用和 HAIL 活动历史,而不仅仅取决于浓度。
- 为什么我的化合物没有数值?
- 最可能的原因是没有人设定过。这里的 273 种污染物中,有 214 种在所涵盖的八个管辖区中都没有任何食品限量;草甘膦在这十二个管辖区中的任何一个都没有数值型土壤指导值。空表本身就是一项发现。
- 我能把本底浓度用作清理目标吗?
- 相关分布的第 95 百分位数是本底的通常上限,而 NES-CS 第 5(9) 条的关键在于污染物是否处于或低于本底水平。在该元素有覆盖的情况下,应使用基于地质的数值,而不是地区数值:Eco-SGVs 正是建立在这种比较之上的。
- 如何保持数据更新?
- 编辑
archive/中的工作簿,然后重新运行scripts/extract.py。data/中的文件是自动生成的,绝不应手工编辑——每个文件开头都写明了这一点。