Two-dimensional Surfaces

Data Structures
struct	F5Vertices_and_Connectivity

Typedefs
typedef struct F5Vertices_and_Connectivity	F5Vertices_and_Connectivity_t

Functions
F5_API void	F5closeVC (F5Vertices_and_Connectivity_t *)
F5_API F5Path *	F5write_triangular_surface (hid_t file_id, double time, const char *name, const F5_point3f_t *Coords, int nCoords, const F5_triangle32_t *Triangles, int nTriangles)
F5_API F5Path *	F5Cwrite_triangular_surface (hid_t file_id, double time, const char *name, const F5_point3f_t *Coords, int nCoords, const F5_triangle32_t *Triangles, int nTriangles, const char *coordinate_system)
F5_API F5Path *	F5Flink_triangular_surface (F5Path *target, double time, const char *gridname, const F5_point3f_t *Coords, int nCoords, const F5_triangle_t *Triangles, int nTriangles, const char *coordinate_system)
F5_API void	F5write_triangular_surface_vertex_vectors (hid_t file_id, double time, const char *name, const F5_point3f_t *Coords, int nCoords, const F5_triangle_t *Triangles, int nTriangles, const char *fieldname, const F5_vec3_float_t *VertexNormals)
F5_API void	F5write_triangular_surface_cell_vectors (hid_t file_id, double time, const char *name, const F5_vec3_point_t *Coords, int nCoords, const F5_triangle_t *Triangles, int nTriangles, const char *fieldname, const F5_vec3_float_t *CellNormals)
F5_API void	F5write_regular_surface (hid_t file_id, double time, const char *name, const F5_vec3_point_t *Coords, int Xdims, int Ydims)
F5_API void	F5write_regular_surface_vertex_field_rgb (hid_t file_id, double time, const char *name, const F5_vec3_point_t *Coords, int Xdims, int Ydims, const char *fieldname, F5_rgb_t *data)
F5_API void	F5Cwrite_regular_surface (hid_t file_id, double time, const char *name, const F5_vec3_point_t *Coords, int Xdims, int Ydims, const char *coordinate_system)
F5_API void	F5write_quad_surface (hid_t file_id, double time, const char *name, const F5_vec3_point_t *Coords, int nCoords, const F5_quad_t *Quads, int nQuads)
F5_API void	F5Cwrite_quad_surface (hid_t file_id, double time, const char *name, const F5_vec3_point_t *Coords, int nCoords, const F5_quad_t *Quads, int nQuads, const char *coordinate_system)
F5_API void	F5write_irregular_surface (hid_t file_id, double time, const char *name, const F5_vec3_point_t *Coords, int nCells, const int *CellSizes, const int **CellVertices)

Detailed Description

Typedef Documentation

F5Vertices_and_Connectivity_t

typedef struct F5Vertices_and_Connectivity F5Vertices_and_Connectivity_t

Examples

ObjtoF5.c.

Definition at line 35 of file F5surface.h.

Function Documentation

F5closeVC()

F5_API void F5closeVC

(

F5Vertices_and_Connectivity_t *

VC

)

Close whatever can be closed here.

Definition at line 9 of file F5surface.c.

{
        if (VC)
        {
                F5Fclose( VC->Vertices );
                VC->Vertices = NULL;
 
                F5Fclose( VC->Cells );
                VC->Cells = NULL;
        }
}

References F5Vertices_and_Connectivity::Cells, F5Fclose(), and F5Vertices_and_Connectivity::Vertices.

F5Cwrite_quad_surface()

F5_API void F5Cwrite_quad_surface	(	hid_t	file_id,
		double	time,
		const char *	name,
		const F5_vec3_point_t *	Coords,
		int	nCoords,
		const F5_quad_t *	Quads,
		int	nQuads,
		const char *	coordinate_system )

Write a surface constructed by cells with four points (quads). Similar to F5write_quad_surface(), but allow specification of non-standard cartesian coordinate system.

References F5_API, and name.

F5Cwrite_regular_surface()

F5_API void F5Cwrite_regular_surface	(	hid_t	file_id,
		double	time,
		const char *	name,
		const F5_vec3_point_t *	Coords,
		int	Xdims,
		int	Ydims,
		const char *	coordinate_system )

Write a regular surface. Similar to F5write_regular_surface(), but allow specification of non-standard cartesian coordinate system.

Todo

merge with F5Cwrite_regular_surface

Definition at line 167 of file F5surface.c.

{
F5Path*f = F5Rcreate_cartesian_nD(File_id, time, gridname, 2, coordinate_system);
 
        /* write the data into the dataset */
        {
        /* write points for the regular
           TODO: --- Use F5Fwrite() here ---!!
         */
 
        hsize_t dims[2];
                dims[0] = Ydims;  /* (or vice versa, check!) */
                dims[1] = Xdims;
        {
        hid_t coord_ds = H5Screate_simple(2, dims, NULL);
        hid_t creator_hid = H5Pcreate(H5P_DATASET_CREATE);
        hid_t   id = F5Dappend(f->Representation_hid, FIBER_HDF5_POSITIONS_STRING,
                               f->FileIDs->SinglePrecision.Point_hid_t, coord_ds, creator_hid);
                H5Dwrite(id, f->FileIDs->SinglePrecision.Point_hid_t, H5S_ALL, H5S_ALL, H5P_DEFAULT, Coords);
                H5Dclose(id);
                H5Sclose(coord_ds);
                H5Pclose(creator_hid);
        }}
 
        F5I_add_field(f, FIBER_HDF5_POSITIONS_STRING);
 
        F5close(f);
}

References F5close(), F5Dappend(), F5I_add_field(), F5Rcreate_cartesian_nD(), FIBER_HDF5_POSITIONS_STRING, F5Path::FileIDs, _F5_ChartPrecisionTypes::Point_hid_t, F5Path::Representation_hid, and ChartDomain_IDs::SinglePrecision.

Referenced by F5write_regular_surface().

F5Cwrite_triangular_surface()

F5_API F5Path * F5Cwrite_triangular_surface	(	hid_t	file_id,
		double	time,
		const char *	name,
		const F5_point3f_t *	Coords,
		int	nCoords,
		const F5_triangle32_t *	Triangles,
		int	nTriangles,
		const char *	coordinate_system )

Write a triangular surface. Similar to F5write_triangular_surface(), but allow specification of non-standard cartesian coordinate system.

Todo

merge with F5write_triangular_surface

Definition at line 49 of file F5surface.c.

{
F5Vertices_and_Connectivity_t
        VC = F5Cwrite_triangular_surface_vc(File_id, time,
                                            gridname,
                                            Coords, nCoords,
                                            Triangles, nTriangles,
                                            coordinate_system);
 
        F5Fclose( VC.Cells );
 
        return  VC.Vertices;
}

References F5Vertices_and_Connectivity::Cells, F5Cwrite_triangular_surface_vc(), F5Fclose(), and F5Vertices_and_Connectivity::Vertices.

Referenced by F5write_triangular_surface().

F5Flink_triangular_surface()

F5_API F5Path * F5Flink_triangular_surface	(	F5Path *	target,
		double	time,
		const char *	gridname,
		const F5_point3f_t *	Coords,
		int	nCoords,
		const F5_triangle_t *	Triangles,
		int	nTriangles,
		const char *	coordinate_system )

Similar to F5write_triangular_surface(), but instead of writing the vertices and triangles as its own dataset, it references those of another surface object. The vertices and triangles are then shared (in HDF5: symbolic links to the target surface).

Parameters

Coords	The vertices of this surface; if none are given, re-use the vertices from the target surface.
Triangles	The triangles of this surfaces; if none are given, reuse the triangles from the target surface.

Note

Only the Vertex coordinates and Triangle connectivity are shared, all other fields remain separate.

Todo

make F5Flink_triangular_surface() failsafe. Extend the concept of linking datasets for sharing available for other grid types as well.

Definition at line 100 of file F5surface.c.

{
F5Path*Cells=0;
F5Path*Vertices = F5Rcreate_cartesian_nD(target->File_hid, time, gridname, 2, coordinate_system);
        if (!Vertices)
                return Vertices;
 
        if (!Coords)
        {
                H5Glink2( target->Representation_hid,  FIBER_HDF5_POSITIONS_STRING,
                          H5G_LINK_HARD,
                          Vertices->Representation_hid,  FIBER_HDF5_POSITIONS_STRING );
        }
        else
        {
                /* write points for the Triangles */
                F5Fwrite_1D(Vertices, FIBER_HDF5_POSITIONS_STRING, nCoords,
                            Vertices->FileIDs->SinglePrecision.Point_hid_t, F5T_COORD3_FLOAT,
                            Coords, F5P_DEFAULT);
        }
 
        Cells = F5Rcreate_triangles_as_vertices_topology(target->File_hid, time, gridname);
 
        if (!Triangles)
        {
                /* TODO: check for errors here! The target ID might not
                   exist at all, and this might indicate that the target
                   is not a triangular surface at all, and that we must not
                   do what we're doing here anyway!! */
 
        hid_t Connectivity = H5Gopen2( target->Grid_hid, FIBER_HDF5_FACES, H5P_DEFAULT );
        hid_t AsVertices = H5Gopen2( Connectivity, FIBER_HDF5_POINTS, H5P_DEFAULT );
                H5Glink2( AsVertices,  FIBER_HDF5_POSITIONS_STRING,
                          H5G_LINK_HARD,
                          Cells->Representation_hid,  FIBER_HDF5_POSITIONS_STRING );
        }
        else
        {
                F5Fwrite_1D(Cells, FIBER_HDF5_POSITIONS_STRING, nTriangles,
                           F5T_TRIANGLE32, F5T_TRIANGLE32,
                           Triangles, F5P_DEFAULT);
        }
 
        F5Fclose( Cells );
 
        return Vertices;
}

References F5Fclose(), F5Fwrite_1D(), F5P_DEFAULT, F5Rcreate_cartesian_nD(), F5Rcreate_triangles_as_vertices_topology(), F5T_COORD3_FLOAT, F5T_TRIANGLE32, FIBER_HDF5_FACES, FIBER_HDF5_POINTS, FIBER_HDF5_POSITIONS_STRING, F5Path::File_hid, F5Path::FileIDs, F5Path::Grid_hid, _F5_ChartPrecisionTypes::Point_hid_t, F5Path::Representation_hid, and ChartDomain_IDs::SinglePrecision.

F5write_irregular_surface()

F5_API void F5write_irregular_surface	(	hid_t	file_id,
		double	time,
		const char *	name,
		const F5_vec3_point_t *	Coords,
		int	nCells,
		const int *	CellSizes,
		const int **	CellVertices )

A surface with changing number of vertices per cell.

References F5_API, and name.

F5write_quad_surface()

F5_API void F5write_quad_surface	(	hid_t	file_id,
		double	time,
		const char *	name,
		const F5_vec3_point_t *	Coords,
		int	nCoords,
		const F5_quad_t *	Quads,
		int	nQuads )

A surface constructed by cells with four points (quads)

References F5_API, and name.

F5write_regular_surface()

F5_API void F5write_regular_surface	(	hid_t	file_id,
		double	time,
		const char *	name,
		const F5_vec3_point_t *	Coords,
		int	Xdims,
		int	Ydims )

Write a regular surface.

Parameters

file_id	Some HDF5 id corresponding to some already opened HDF5 file.
time	The physical time for this data set.
name	Some textual description of this surface; should be simple (avoid spaces, special characters and extensively long names). It is used to identify surfaces over multiple timesteps, so must be identical for subsequent calls on evolving surfaces.
Coords	The cartesian coordinates of the points
Xdims	Extension in first dimension
Ydims	Extension in first dimension

Definition at line 154 of file F5surface.c.

{
        F5Cwrite_regular_surface(file_id, time,
                                 name,
                                 Coords, Xdims, Ydims,
                                 FIBER_HDF5_DEFAULT_CHART);
 
}

References F5Cwrite_regular_surface(), FIBER_HDF5_DEFAULT_CHART, and name.

F5write_regular_surface_vertex_field_rgb()

F5_API void F5write_regular_surface_vertex_field_rgb	(	hid_t	file_id,
		double	time,
		const char *	name,
		const F5_vec3_point_t *	Coords,
		int	Xdims,
		int	Ydims,
		const char *	fieldname,
		F5_rgb_t *	data )

A regular surface with a data field on the vertices.

Note

Put data into the `Rep_hid' */ F5_API void F5write_regular_surface_vertex_field_dbl(hid_t file_id, double time, const char*name, const F5_vec3_point_t*Coords, int Xdims, int Ydims, const char*fieldname, double*data);

/** A regular surface with a data field on the cells.

Note

Put data into the `Cell_Rep_hid'

Todo

use newer field interface */ F5_API void F5write_regular_surface_cell_field_dbl(hid_t file_id, double time, const char*name, const F5_vec3_point_t*Coords, int Xdims, int Ydims, const char*fieldname, double*data);

/** A field of colors given on the vertices.

Todo

use newer field interface

References F5_API, and name.

F5write_triangular_surface()

F5_API F5Path * F5write_triangular_surface	(	hid_t	file_id,
		double	time,
		const char *	name,
		const F5_point3f_t *	Coords,
		int	nCoords,
		const F5_triangle32_t *	Triangles,
		int	nTriangles )

Write a triangular surface.

Parameters

file_id	Some HDF5 id corresponding to some already opened HDF5 file.
time	The physical time for this data set.
name	Some textual description of this surface; should be simple (avoid spaces, special characters and extensively long names). It is used to identify surfaces over multiple timesteps, so must be identical for subsequent calls on evolving surfaces.
Coords	The cartesian coordinates of the points
nCoords	How many points are there
Triangles	The connectivity of the triangles, ie. which points belong to each triangle
nTriangles	How many triangles are there

Todo

Use the new Field interface from uniform grids

Note

This version saves data in SINGLE PRECISION, both for coordinates as well as triangle indices. If you need another precision, inspect the source of this function and do it manually.

Definition at line 23 of file F5surface.c.

{
        return  F5Cwrite_triangular_surface(file_id, time,
                                            name,
                                            Coords, nCoords,
                                            Triangles, nTriangles,
                                            FIBER_HDF5_DEFAULT_CHART);
}

References F5Cwrite_triangular_surface(), FIBER_HDF5_DEFAULT_CHART, and name.

F5write_triangular_surface_cell_vectors()

F5_API void F5write_triangular_surface_cell_vectors	(	hid_t	file_id,
		double	time,
		const char *	name,
		const F5_vec3_point_t *	Coords,
		int	nCoords,
		const F5_triangle_t *	Triangles,
		int	nTriangles,
		const char *	fieldname,
		const F5_vec3_float_t *	CellNormals )

CellNormals to be added to the Cell_Rep_hid_t

References F5_API, and name.

F5write_triangular_surface_vertex_vectors()

F5_API void F5write_triangular_surface_vertex_vectors	(	hid_t	file_id,
		double	time,
		const char *	name,
		const F5_point3f_t *	Coords,
		int	nCoords,
		const F5_triangle_t *	Triangles,
		int	nTriangles,
		const char *	fieldname,
		const F5_vec3_float_t *	VertexNormals )

VertexNormals to be added to the Rep_hid_t

References F5_API, and name.