Core split
core_split
Core and mantle split of a bulk element inventory at one equilibration point.
The metal of mass M_metal equilibrates with a silicate of mass M_silicate at
(P_eq, T_eq, dIW). For a mass-basis D_i the silicate mass fraction is
w_i = M_i / (M_silicate + D_i M_metal), the core holds D_i M_metal w_i and the
mantle M_silicate w_i. D_i depends on the metal and melt composition (interaction
terms, mole bases), so the split is a fixed point on the metal composition. The laws come
from :func:calliope.metal.get_law by name (:data:DEFAULT_LAWS) or as entries. dIW
is the one redox input: a law with an FeO term (the S law) takes the melt FeO mole fraction
X_FeO = x'_Fe 10^(dIW/2) of ideal mixing from the metal of the pass, and the melt
oxides set only the silicate units of the mole bases.
A law outside its (P, T, dIW) range is evaluated at the given point, not clamped, and
flagged with its distance per axis. O and Si are not split: their bulk is the O and Si of
the rock, which CALLIOPE does not hold; their metal mass fractions enter as w_fixed.
The exchange-K_D split of O and Si is not part of this module.
split_core_mantle(bulk_kg, M_metal, M_silicate, *, dIW, P_eq=P_EQ_GPA, T_eq=T_EQ_K, laws=None, w_fixed=None, oxides=KLB1, nbo_t=2.6)
Split the bulk mass of each element between core and mantle.
Parameters:
| Name | Type | Description | Default |
|---|---|---|---|
bulk_kg
|
dict
|
Bulk mass [kg] of each element to split, H, C, N or S (or any element of
:data: |
required |
M_metal
|
float
|
Mass of the equilibrating metal [kg], >= 0; 0 evaluates no law and returns the bulk as mantle. |
required |
M_silicate
|
float
|
Mass of the equilibrating silicate [kg], > 0. |
required |
dIW
|
float
|
Oxygen fugacity of the equilibrium relative to the iron-wustite buffer [log10]. |
required |
P_eq
|
float
|
Equilibration pressure [GPa] and temperature [K], > 0. |
P_EQ_GPA
|
T_eq
|
float
|
Equilibration pressure [GPa] and temperature [K], > 0. |
P_EQ_GPA
|
laws
|
dict or None
|
Law per element, a name for :func: |
None
|
w_fixed
|
dict or None
|
Metal mass fractions of elements that are not split (O, Si), each in [0, 1) with a sum below 1. |
None
|
oxides
|
dict
|
Silicate composition in oxide wt%: the silicate units of the mole bases and the
melt a callable law gets (the FeO of a law with an FeO term comes from |
KLB1
|
nbo_t
|
float
|
NBO/T of the silicate. |
2.6
|
Returns:
| Name | Type | Description |
|---|---|---|
core_kg, mantle_kg : dict
|
Core and mantle mass [kg] of each element of |
|
flags |
dict
|
Per element: |
Raises:
| Type | Description |
|---|---|
ValueError
|
An input outside its domain (named), O or Si in |
PartitionTableError
|
A law name that is not held, or a law in |
RuntimeError
|
A metal composition that settles neither in :data: |
Source code in src/calliope/core_split.py
250 251 252 253 254 255 256 257 258 259 260 261 262 263 264 265 266 267 268 269 270 271 272 273 274 275 276 277 278 279 280 281 282 283 284 285 286 287 288 289 290 291 292 293 294 295 296 297 298 299 300 301 302 303 304 305 306 307 308 309 310 311 312 313 314 315 316 317 318 319 320 321 322 323 324 325 326 327 328 329 330 331 332 333 334 335 336 337 338 339 340 341 342 343 344 345 346 347 348 349 350 351 352 353 354 355 356 357 358 359 360 361 362 363 364 365 366 367 368 369 370 371 372 373 374 375 376 377 378 379 380 381 382 383 384 385 386 387 388 389 390 391 392 393 394 395 396 397 398 399 400 401 402 403 404 405 406 407 408 409 410 411 412 413 414 415 416 417 418 419 420 421 | |