Field data doc.

[ajain-work]

Added two set of APIs.

• APIs to get all field in single request.
• APIs to get one field per request

Following code demonstrate their usage:

import numpy as np
from ansys.fluent.core.services.field_data import SurfaceDataType
from ansys.fluent.core.session import Session

session1 = Session("localhost",  <port number>, cleanup_on_exit=False)

#Get field data object
field_data = session1.field_data

#Surface group-0 belong to ID 1 and 2 in Fluent

#APIs to get one field per request
vertices = field_data.get_surface_data("group-0", SurfaceDataType.Vertices)
face_normal = field_data.get_surface_data("group-0", SurfaceDataType.FacesNormal)
temperature = field_data.get_scalar_field_data("group-0", "temperature")
vector_field_data = field_data.get_vector_field_data("group-0")


#APIs to get multiple fields in a single request
field_data.add_get_surfaces_request(surface_ids=[1, 2], provide_vertices=True, provide_faces=False, provide_faces_normal=True)                                                                            
field_data.add_get_scalar_fields_request(surface_ids=[1,2], field_name="temperature")                                    
field_data.add_get_vector_fields_request(surface_ids=[1,2])
field_payload_data = field_data.get_fields()


#Data comparision
np.testing.assert_array_equal( vertices[1], field_payload_data[0][1]["vertices"])
np.testing.assert_array_equal( vertices[2], field_payload_data[0][2]["vertices"])

np.testing.assert_array_equal( face_normal[1], field_payload_data[0][1]["face-normal"])
np.testing.assert_array_equal( face_normal[2], field_payload_data[0][2]["face-normal"])

np.testing.assert_array_equal( temperature[1], field_payload_data[4][1]["temperature"])
np.testing.assert_array_equal( temperature[2], field_payload_data[4][2]["temperature"])


np.testing.assert_array_equal( vector_field_data[1][0], field_payload_data[0][1]["velocity"])
np.testing.assert_array_equal( vector_field_data[2][0], field_payload_data[0][2]["velocity"])


np.testing.assert_array_equal( vector_field_data[1][1], field_payload_data[0][1]["vector-scale"])
np.testing.assert_array_equal( vector_field_data[2][1], field_payload_data[0][2]["vector-scale"])