10 releases (breaking)
new 0.8.2 | Nov 1, 2024 |
---|---|
0.8.1 | Jun 5, 2024 |
0.8.0 | Apr 21, 2023 |
0.7.0 | Feb 6, 2023 |
0.5.0 | Nov 27, 2022 |
#11 in Science
1,800 downloads per month
Used in 9 crates
(3 directly)
735KB
25K
SLoC
Mendeleev
Mendeleev is a crate containing all known chemical elements as an enum and as a list, as well as methods that return some properties for each of them.
Example
Get data on a specific element
use mendeleev::Element;
let element = Element::Si;
assert_eq!(element.atomic_number(), 14);
assert_eq!(element.name(), "Silicon");
assert_eq!(format!("{}", element.electronic_configuration()), "[Ne] 3s² 3p²");
Example
Search the list of elements
use mendeleev::{Element, Kelvin};
// Find the element with the highest value for a given property
let highest_melting_point = Element::iter().reduce(|acc, e| {
core::cmp::max_by(acc, e, |e1, e2| {
e1.melting_point()
.unwrap_or(Kelvin(0.0))
.total_cmp(&e2.melting_point().unwrap_or(Kelvin(0.0)))
})
});
assert_eq!(highest_melting_point, Some(Element::C));
// Iterate through the elements with no known year of discovery
let mut ancient_elements = Element::iter()
.filter(|e| matches!(e.year_discovered(), mendeleev::YearDiscovered::Ancient));
assert_eq!(ancient_elements.next(), Some(Element::C));
assert_eq!(ancient_elements.next(), Some(Element::Al));
// Find an element by name
let iron = Element::iter().find(|e| e.name().eq_ignore_ascii_case("iron"));
assert_eq!(iron, Some(Element::Fe));
It also contains most of the known isotopes for each element (naturally occurring, synthetic, or theoretical), accessible via a similar API as the elements themselves.
Available data
Elements
- Symbol
- Name (in American English)
- Atomic number
- Atomic radius
- Atomic weight
- RGB color in the CPK and Jmol conventions
- Position in the periodic table (period and group)
- Melting and boiling point
- Heat of fusion and evaporation
- Electronic configuration
- Discovery data (year, location, discoverers)
Isotopes
- Corresponding element
- Relative natural abundance on Earth
- Mass number
- Neutron number
Features
- No unsafe code
- No required dependencies
- Optional support for
serde
- All properties are
const
or'static
- Compatible with no-std
- Most types implement
Display
- No
build.rs
file. All the data is directly in the code - Each of the available properties has its own file that can be excluded from the build with a feature flag, to reduce binary size and compilation time when not all properties are needed
- Numeric properties are accompanied by constants providing the range of values they can take
- Documentation, tests, and examples
Data sources
The data available in this crate comes from the following sources:
-
Density, electron affinity, and ionization energy:
- National Center for Biotechnology Information (2023). Periodic Table of Elements. Retrieved April 15, 2023 from https://pubchem.ncbi.nlm.nih.gov/periodic-table/.
-
Other properties:
- PyPI package mendeleev, version 0.18.1. https://pypi.org/project/mendeleev/0.18.1/.
For the data sources used by the PyPI package, see https://mendeleev.readthedocs.io/en/latest/data.html
Note that this crate is not maintained by the same authors as the PyPI package.
Contributing
Unless you explicitly state otherwise, any contribution intentionally submitted for inclusion in the work by you, as defined in the Apache-2.0 license, shall be dual licensed as below, without any additional terms or conditions.
License
Licensed under either of
- Apache License, Version 2.0, (LICENSE-APACHE or https://www.apache.org/licenses/LICENSE-2.0)
- MIT license (LICENSE-MIT or https://opensource.org/licenses/MIT)
at your option.