{"id":23421,"library":"chemicals","title":"chemicals","description":"Chemical properties component of the Chemical Engineering Design Library (ChEDL). Provides pure component and mixture properties, phase equilibria, transport properties, and reaction stoichiometry. Current version 1.5.1, released regularly.","status":"active","version":"1.5.1","language":"python","source_language":"en","source_url":"https://github.com/CalebBell/chemicals","tags":["chemical-engineering","thermodynamics","physical-properties","property-estimation"],"install":[{"cmd":"pip install chemicals","lang":"bash","label":"Install from PyPI"}],"dependencies":[{"reason":"Used for fluid dynamics calculations; version >= 1.0.26 required since chemicals 1.2.0","package":"fluids","optional":false},{"reason":"Array computations","package":"numpy","optional":false},{"reason":"Interpolation and optimization","package":"scipy","optional":false}],"imports":[{"wrong":"from chemicals import Chemical","symbol":"Chemical","correct":"from chemicals import Chemical"}],"quickstart":{"code":"from chemicals import Chemical\nfrom chemicals.reaction import balance_stoichiometry\n\n# Create a chemical object for water\nH2O = Chemical('water')\nprint(f\"Molecular weight: {H2O.MW} g/mol\")\nprint(f\"Critical temperature: {H2O.Tc} K\")\n\n# Balance a simple reaction\nrxn = balance_stoichiometry(['H2', 'O2'], ['H2O'])\nprint(f\"Balanced: {rxn}\")","lang":"python","description":"Basic usage: instantiate a Chemical and compute properties."},"warnings":[{"fix":"Always specify a unique CAS number if possible, e.g., Chemical(CAS='64-17-5').","message":"Chemical names can be ambiguous. Use CAS numbers or exact names to avoid picking the wrong isomer. e.g., 'ethanol' vs 'ethyl alcohol' both work, but 'propanol' raises an error due to multiple isomers.","severity":"gotcha","affected_versions":"all"},{"fix":"Upgrade chemicals to 1.3.0+ or pin numpy<2.0. For chemicals 1.2.0, ensure numpy 2.0 and scipy 1.14 compatibility is acceptable.","message":"In version 1.2.0, numpy 2.0 and scipy 1.14 compatibility introduced breaking changes for some internal routines. Old code relying on numpy <2.0 may break.","severity":"breaking","affected_versions":">=1.2.0,<1.3.0"},{"fix":"Run pip install 'chemicals' which auto-installs correct fluids version.","message":"The 'chemicals' package uses the 'fluids' library as a dependency. If you installed it via pip, fluids is included, but if you manually install chemicals from source, ensure fluids >= 1.0.26 (since chemicals 1.2.0).","severity":"gotcha","affected_versions":">=1.2.0"},{"fix":"Use method as integer or use the new VaporPressure class directly.","message":"The function 'VaporPressure.from_method' using deprecated argument 'method' with string names might be removed. Use integer or method handle instead.","severity":"deprecated","affected_versions":">=1.4.0"}],"env_vars":null,"search_vec":"'1.5.1':27 'chedl':11 'chemic':1,2,7,31 'chemical-engin':30 'compon':4,14 'current':25 'design':9 'engin':8,32 'equilibria':19 'estim':39 'librari':10 'mixtur':16 'phase':18 'physic':35 'physical-properti':34 'properti':3,17,21,36,38 'property-estim':37 'provid':12 'pure':13 'reaction':23 'regular':29 'releas':28 'stoichiometri':24 'thermodynam':33 'transport':20 'version':26","created_at":"2026-05-01T08:07:41.591046+00:00","updated_at":"2026-05-01T08:07:41.591046+00:00","problems":{"verify_error":"Traceback (most recent call last):\n  File \"<string>\", line 1, in <module>\nImportError: cannot import name 'Chemical' from 'chemicals' (/tmp/tmp7u1zn8o5/venv/lib/python3.12/site-packages/chemicals/__init__.py)"},"ecosystem":"pypi","meta_description":null,"install_score":null,"quickstart_score":null,"quickstart_tag":null,"pypi_latest":"1.5.2","cli_name":"","cli_version":null,"type":"library","homepage":null,"github":"https://github.com/CalebBell/chemicals","docs":null,"changelog":null,"pypi":"https://pypi.org/project/chemicals/","npm":null,"openapi_spec":null,"status_page":null,"smithery":null,"categories":["data","ai-ml"],"base_url":null,"auth_type":null,"provenance":{"verified_status":"import_fail","verified_at":"2026-07-03","last_verified":"2026-07-03","next_check":"2026-07-10","install_tag":null}}