steer-materials 0.1.16__tar.gz → 0.1.17__tar.gz

{steer_materials-0.1.16 → steer_materials-0.1.17}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: steer-materials
-Version: 0.1.16
+Version: 0.1.17
 Summary: Modelling energy storage from cell to site - STEER OpenCell Design
 Author-email: Nicholas Siemons <nsiemons@stanford.edu>
 Maintainer-email: Nicholas Siemons <nsiemons@stanford.edu>

{steer_materials-0.1.16 → steer_materials-0.1.17}/steer_materials/Base.py

@@ -90,13 +90,32 @@ class _Material(
 
     @density.setter
     def density(self, density: float) -> None:
+
+        # validate input 
         self.validate_positive_float(density, "Density")
+
+        # convert and set
         self._density = density * G_TO_KG / CM_TO_M**3
 
+        # If this is a volumed material and volume is set, recalculate mass
+        if hasattr(self, '_volume') and self._volume is not None:
+            self._mass = self._volume * self._density
+            if hasattr(self, '_cost'):
+                self._cost = self._mass * self._specific_cost
+
     @specific_cost.setter
     def specific_cost(self, specific_cost: float) -> None:
+
+        # validate input
         self.validate_positive_float(specific_cost, "Specific Cost")
+        
+        # set value
         self._specific_cost = specific_cost
+        
+        # If this is a volumed material with mass, recalculate cost
+        if hasattr(self, '_mass') and self._mass is not None:
+            if hasattr(self, '_cost'):
+                self._cost = self._mass * self._specific_cost
 
     @name.setter
     def name(self, name: str) -> None:
@@ -117,3 +136,86 @@ class Solvent(_Material):
 
         super().__init__(name, density, specific_cost, color)
 
+
+class _VolumedMaterialMixin:
+    """
+    Mixin for materials that optionally track volume (cm^3) or mass (kg).
+    Cost ($) is always derived from mass and specific_cost.
+    """
+
+    def __init__(
+            self, 
+            *, 
+            volume=None, 
+            mass=None, 
+            **kwargs
+        ):
+
+        super().__init__(**kwargs)
+
+        # Check that only one of volume or mass is provided
+        provided = sum([volume is not None, mass is not None])
+        if provided > 1:
+            raise ValueError(
+                "Only one of 'volume' or 'mass' can be provided during initialization. "
+                f"Received: volume={volume}, mass={mass}"
+            )
+
+        self._volume = None
+        self._mass = None
+        self._cost = None
+
+        if volume is not None:
+            self.volume = volume
+        elif mass is not None:
+            self.mass = mass
+
+    @property
+    def volume(self):
+        if hasattr(self, '_volume') and self._volume is not None:
+            return round(self._volume * (M_TO_CM**3), 4)
+        else:
+            return None
+        
+    @property
+    def mass(self):
+        if hasattr(self, '_mass') and self._mass is not None:
+            return round(self._mass * KG_TO_G, 2)
+        else:
+            return None
+        
+    @property
+    def cost(self):
+        if hasattr(self, '_cost') and self._cost is not None:
+            return round(self._cost, 2)
+        else:
+            return None
+
+    
+    @volume.setter
+    def volume(self, value):
+        
+        if value is not None:
+            ValidationMixin.validate_positive_float(value, "Volume")
+            self._volume = value * CM_TO_M**3
+            self._mass = self._volume * self._density
+            self._cost = self._mass * self._specific_cost
+        else:
+            self._volume = None
+            self._mass = None
+            self._cost = None
+
+    @mass.setter
+    def mass(self, value):
+
+        if value is not None:
+            ValidationMixin.validate_positive_float(value, "Mass")
+            self._mass = value * G_TO_KG
+            self._volume = self._mass / self._density
+            self._cost = self._mass * self._specific_cost
+        else:
+            self._volume = None
+            self._mass = None
+            self._cost = None
+
+

steer_materials-0.1.17/steer_materials/__init__.py

@@ -0,0 +1,2 @@
+__version__ = "0.1.17"
+

{steer_materials-0.1.16 → steer_materials-0.1.17}/steer_materials.egg-info/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: steer-materials
-Version: 0.1.16
+Version: 0.1.17
 Summary: Modelling energy storage from cell to site - STEER OpenCell Design
 Author-email: Nicholas Siemons <nsiemons@stanford.edu>
 Maintainer-email: Nicholas Siemons <nsiemons@stanford.edu>

steer_materials-0.1.17/steer_materials.egg-info/SOURCES.txt

@@ -0,0 +1,13 @@
+README.md
+pyproject.toml
+./steer_materials/Base.py
+./steer_materials/__init__.py
+steer_materials/Base.py
+steer_materials/__init__.py
+steer_materials.egg-info/PKG-INFO
+steer_materials.egg-info/SOURCES.txt
+steer_materials.egg-info/dependency_links.txt
+steer_materials.egg-info/requires.txt
+steer_materials.egg-info/top_level.txt
+test/test_electrode_materials.py
+test/test_electrolyte.py

steer_materials-0.1.17/test/test_electrolyte.py

@@ -0,0 +1,39 @@
+import unittest
+
+from steer_materials.Electrolytes.Electrolytes import Electrolyte
+
+
+class TestElectrolyteVolumeMassCost(unittest.TestCase):
+
+    def setUp(self):
+        self.electrolyte = Electrolyte(
+            name="Test Electrolyte",
+            density=1.2,  # g/cm^3
+            specific_cost=15.0,  # $/kg
+            color="#abcdef",
+        )
+
+    def test_volume_setter_updates_mass_and_cost(self):
+        self.electrolyte.volume = 10.0
+
+        self.assertAlmostEqual(self.electrolyte.volume, 10.0, places=4)
+        self.assertAlmostEqual(self.electrolyte.mass, 12.0, places=2)
+        self.assertAlmostEqual(self.electrolyte.cost, 0.18, places=2)
+
+    def test_mass_setter_updates_volume_and_cost(self):
+        self.electrolyte.mass = 25.0
+
+        self.assertAlmostEqual(self.electrolyte.mass, 25.0, places=2)
+        self.assertAlmostEqual(self.electrolyte.volume, 20.8333, places=3)
+        self.assertAlmostEqual(self.electrolyte.cost, 0.38, places=2)
+
+    def test_cost_setter_updates_mass_and_volume(self):
+        self.electrolyte.cost = 5.0
+
+        self.assertAlmostEqual(self.electrolyte.cost, 5.0, places=2)
+        self.assertAlmostEqual(self.electrolyte.mass, 333.33, places=2)
+        self.assertAlmostEqual(self.electrolyte.volume, 277.7778, places=1)
+
+
+if __name__ == "__main__":
+    unittest.main()

steer_materials-0.1.16/steer_materials/CellMaterials/Base.py

@@ -1,278 +0,0 @@
-from steer_core.DataManager import DataManager
-from steer_core.Mixins.Serializer import SerializerMixin
-from steer_materials.Base import Metal, _Material
-
-
-class CurrentCollectorMaterial(Metal):
-    """
-    Materials from which current collectors are made.
-    """
-
-    def __init__(self, name: str, density: float, specific_cost: float, color: str):
-        """
-        Current collector material for encapsulation of the cell
-
-        Parameters
-        ----------
-        name : str
-            Name of the current collector material.
-        density : float
-            Density of the material in g/cm^3.
-        specific_cost : float
-            Specific cost of the material in $/kg.
-        color : str
-            Color of the material.
-        """
-        super().__init__(name, density, specific_cost, color)
-
-    @staticmethod
-    def from_database(name) -> "CurrentCollectorMaterial":
-        """
-        Pull object from the database.
-
-        Parameters
-        ----------
-        name : str
-            Name of the current collector material.
-
-        Returns
-        -------
-        CurrentCollectorMaterial: Instance of the class.
-
-        Raises
-        ------
-        ValueError: If the material is not found in the database.
-        """
-        database = DataManager()
-
-        available_materials = database.get_unique_values(
-            "current_collector_materials", "name"
-        )
-
-        if name not in available_materials:
-            raise ValueError(
-                f"Material '{name}' not found in the database. Available materials: {available_materials}"
-            )
-
-        data = database.get_current_collector_materials(most_recent=True).query(
-            f"name == '{name}'"
-        )
-
-        string_rep = data["object"].iloc[0]
-
-        material = SerializerMixin.deserialize(string_rep)
-
-        return material
-
-
-class InsulationMaterial(_Material):
-    """
-    Materials from which insulation is made.
-    """
-
-    def __init__(self, name: str, density: float, specific_cost: float, color: str):
-        """
-        Insulation material for encapsulation of the cell
-
-        Parameters
-        ----------
-        name : str
-            Name of the insulation material.
-        density : float
-            Density of the material in g/cm^3.
-        specific_cost : float
-            Specific cost of the material in $/kg.
-        color : str
-            Color of the material.
-        """
-        super().__init__(name, density, specific_cost, color)
-
-    @staticmethod
-    def from_database(name) -> "InsulationMaterial":
-        """
-        Pull object from the database.
-
-        Parameters
-        ----------
-        name : str
-            Name of the insulation material.
-
-        Returns
-        -------
-        InsulationMaterial: Instance of the class.
-
-        Raises
-        ------
-        ValueError: If the material is not found in the database.
-        """
-        database = DataManager()
-        available_materials = database.get_unique_values("insulation_materials", "name")
-
-        if name not in available_materials:
-            raise ValueError(
-                f"Material '{name}' not found in the database. Available materials: {available_materials}"
-            )
-
-        data = database.get_data(table_name="insulation_materials").query(
-            f"name == '{name}'"
-        )
-
-        string_data = data["object"].iloc[0]
-        material = SerializerMixin.deserialize(string_data)
-        return material
-
-
-class SeparatorMaterial(_Material):
-    """
-    Materials from which separators are made.
-    """
-
-    def __init__(
-        self,
-        name: str,
-        density: float,
-        specific_cost: float,
-        porosity: float,
-        color: str,
-    ):
-        """
-        Separator material for encapsulation of the cell
-
-        Parameters
-        ----------
-        name : str
-            Name of the separator material.
-        density : float
-            Density of the material in g/cm^3.
-        specific_cost : float
-            Specific cost of the material in $/kg.
-        porosity : float
-            Porosity of the separator material in %.
-        color : str
-            Color of the material.
-        """
-        super().__init__(
-            name, 
-            density, 
-            specific_cost, 
-            color
-        )
-
-        self.porosity = porosity
-
-    @property
-    def porosity(self):
-        return round(self._porosity * 100, 2)
-    
-    @property
-    def porosity_range(self):
-        return (0, 100)
-
-    @porosity.setter
-    def porosity(self, porosity: float) -> None:
-        self.validate_percentage(porosity, "Porosity")
-        self._porosity = porosity / 100.0
-
-    @staticmethod
-    def from_database(name) -> "SeparatorMaterial":
-        """
-        Pull object from the database.
-
-        Parameters
-        ----------
-        name : str
-            Name of the separator material.
-
-        Returns
-        -------
-        SeparatorMaterial: Instance of the class.
-
-        Raises
-        ------
-        ValueError: If the material is not found in the database.
-        """
-        database = DataManager()
-
-        available_materials = database.get_unique_values("separator_materials", "name")
-
-        if name not in available_materials:
-            raise ValueError(
-                f"Material '{name}' not found in the database. Available materials: {available_materials}"
-            )
-
-        data = database.get_data(table_name="separator_materials").query(
-            f"name == '{name}'"
-        )
-
-        string_data = data["object"].iloc[0]
-        material = SerializerMixin.deserialize(string_data)
-        return material
-
-
-
-class TapeMaterial(_Material):
-    """
-    Materials from which tapes are made.
-    """
-
-    def __init__(
-        self,
-        name: str,
-        density: float,
-        specific_cost: float,
-        color: str,
-    ):
-        """
-        Separator material for encapsulation of the cell
-
-        Parameters
-        ----------
-        name : str
-            Name of the tape material.
-        density : float
-            Density of the material in g/cm^3.
-        specific_cost : float
-            Specific cost of the material in $/kg.
-        color : str
-            Color of the material.
-        """
-        super().__init__(
-            name, 
-            density, 
-            specific_cost, 
-            color
-        )
-
-    @staticmethod
-    def from_database(name) -> "TapeMaterial":
-        """
-        Pull object from the database.
-
-        Parameters
-        ----------
-        name : str
-            Name of the tape material.
-
-        Returns
-        -------
-        TapeMaterial: Instance of the class.
-        Raises
-        ------
-        ValueError: If the material is not found in the database.
-        """
-        database = DataManager()
-
-        available_materials = database.get_unique_values("tape_materials", "name")
-
-        if name not in available_materials:
-            raise ValueError(
-                f"Material '{name}' not found in the database. Available materials: {available_materials}"
-            )
-
-        data = database.get_data(table_name="tape_materials").query(
-            f"name == '{name}'"
-        )
-
-        string_data = data["object"].iloc[0]
-        material = SerializerMixin.deserialize(string_data)
-        return material