Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Export average surface temperature #949

Open
wants to merge 70 commits into
base: fenicsx
Choose a base branch
from

Conversation

kaelyndunnell
Copy link
Contributor

Proposed changes

Adds export for average surface temperature.

Types of changes

What types of changes does your code introduce to FESTIM?

  • Bugfix (non-breaking change which fixes an issue)
  • New feature (non-breaking change which adds functionality)
  • Breaking change (fix or feature that would cause existing functionality to not work as expected)
  • Code refactoring
  • Documentation Update (if none of the other choices apply)
  • New tests

Checklist

  • Black formatted
  • Unit tests pass locally with my changes
  • I have added tests that prove my fix is effective or that my feature works
  • I have added necessary documentation (if appropriate)

Further comments

If this is a relatively large or complex change, kick off the discussion by explaining why you chose the solution you did and what alternatives you considered, etc...

Copy link
Collaborator

@RemDelaporteMathurin RemDelaporteMathurin left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Hi @kaelyndunnell thanks for this, this is very much needed!

However I think it should be implemented differently:

  • It doesn't make sense to ask users to provide temperature_field as an argument of SurfaceTemperature since they don't have access to the fenics object (fem.Constant or fem.Temperature) before calling initialise and since exports are defined before calling initialise. Instead, I believe the class should not have this argument at all, and temperature_field is set as an attribute only inside HTransportProblem
for export in self.exports:
    if isinstance(export, SurfaceTemperature):
        export.temperature_field = self.temperature_fenics
  • SurfaceTemperature shares a lot of functionality with SurfaceQuantity: it should inherit from it
  • I'm thinking by looking at this we should revisit the design of these quantities @JonathanGSDUFOUR , I'll open an issue to describe my idea but here's the rough pitch
class SurfaceQuantity:
    def __init__(self, surface, filename):
        self.surface = surface
        self.filename = filename

        self.field = None   # this is no longer a user argument but only an attribute
     
    ...

class AverageSurfaceConcentration(SurfaceQuantity):
    def __init__(self, species, surface, filename):
        self.species = species
        super.__init__(surface, filename)

Inside HTransportProblem

def initialise_exports(self):
    for export in self.exports:
        if not hasattr(export, "species"):  # appropriate fenics functions are already stored in F.Species objects
            export.field = self.temperature_fenics 

Comment on lines 831 to 838
elif isinstance(export, exports.SurfaceTemperature):
export.compute(self.ds) # compute surface temp

export.t.append(float(self.t)) # update export time

# if filename given write export data to file
if export.filename is not None:
export.write(t=float(self.t))
Copy link
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

These lines are not tested. That's because by design, it's impossible to use SurfaceTemperature in combination with HTransportProblem

@RemDelaporteMathurin RemDelaporteMathurin added enhancement New feature or request fenicsx Issue that is related to the fenicsx support labels Feb 26, 2025
@@ -415,6 +418,9 @@ def initialise_exports(self):
export.D = D
export.D_expr = D_expr

if isinstance(export, exports.AverageSurfaceTemperature):
export.temperature_field = self.temperature_fenics
Copy link
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

This should be tested!

Copy link
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

See comment below about integration test

Comment on lines +93 to +191
def test_write_overwrite(tmp_path):
"""Test that the write method overwrites the file if it already exists"""
filename = os.path.join(tmp_path, "my_export.csv")
my_model = F.HydrogenTransportProblem(
mesh=F.Mesh1D(np.linspace(0, 6.0, 10000)), temperature=500
)
my_model.define_temperature()

my_export = F.AverageSurfaceTemperature(
filename=filename,
surface=F.SurfaceSubdomain1D(id=35, x=1),
)
my_export.value = 2.0
my_export.write(0)
my_export.write(1)

my_export2 = F.AverageSurfaceTemperature(
filename=filename,
surface=F.SurfaceSubdomain1D(id=1, x=1),
)
my_export2.value = 3.0
my_export2.write(1)
my_export2.write(2)
my_export2.write(3)

data = np.genfromtxt(filename, delimiter=",", names=True)
file_length = data.size
expected_length = 3

assert file_length == expected_length


def test_filename_setter_raises_TypeError():
"""Test that a TypeError is raised when the filename is not a string"""

with pytest.raises(TypeError, match="filename must be of type str"):
my_model = F.HydrogenTransportProblem(
mesh=F.Mesh1D(np.linspace(0, 6.0, 10000)), temperature=500
)
my_model.define_temperature()

F.AverageSurfaceTemperature(
filename=1,
surface=F.SurfaceSubdomain1D(id=1, x=1),
)


def test_filename_setter_raises_ValueError(tmp_path):
"""Test that a ValueError is raised when the filename does not end with .csv or .txt"""

with pytest.raises(ValueError):
my_model = F.HydrogenTransportProblem(
mesh=F.Mesh1D(np.linspace(0, 6.0, 10000)), temperature=500
)
my_model.define_temperature()

F.AverageSurfaceTemperature(
filename=os.path.join(tmp_path, "my_export.xdmf"),
surface=F.SurfaceSubdomain1D(id=1, x=1),
)


@pytest.mark.parametrize("value", ["my_export.csv", "my_export.txt"])
def test_writer(tmp_path, value):
"""Test that the writes values at each timestep to either a csv or txt file"""
my_model = F.HydrogenTransportProblem(
mesh=F.Mesh1D(np.linspace(0, 6.0, 10000)), temperature=500
)
my_model.define_temperature()

my_export = F.AverageSurfaceTemperature(
filename=os.path.join(tmp_path, f"{value}"),
surface=F.SurfaceSubdomain1D(id=1, x=0),
)
my_export.value = 2.0

for i in range(10):
my_export.write(i)
file_length = len(np.genfromtxt(my_export.filename, delimiter=","))

expected_length = i + 2

assert file_length == expected_length


def test_surface_setter_raises_TypeError():
"""Test that a TypeError is raised when the surface is not a
F.SurfaceSubdomain"""

with pytest.raises(
TypeError, match="surface should be an int or F.SurfaceSubdomain"
):
my_model = F.HydrogenTransportProblem(
mesh=F.Mesh1D(np.linspace(0, 6.0, 10000)), temperature=500
)
my_model.define_temperature()
F.AverageSurfaceTemperature(
surface="1",
)
Copy link
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

These tests aren't need as it tests the functionality in the parent class SurfaceQuantity

Comment on lines +49 to +51
my_export = F.AverageSurfaceTemperature(surface=dummy_surface)
my_export.temperature_field = my_model.temperature_fenics
my_export.compute(ds)
Copy link
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Good, but we also need to test the full integration with HydrogenTransportProblem ie. just do

my_model.exports = [....]
my_model.initialise()
my_model.run()

# test value of export after run

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
enhancement New feature or request fenicsx Issue that is related to the fenicsx support
Projects
None yet
Development

Successfully merging this pull request may close these issues.

2 participants