diff options
Diffstat (limited to 'doc')
| -rw-r--r-- | doc/html/TechNotes/TestReview/H5Tget_native_type.html | 522 |
1 files changed, 522 insertions, 0 deletions
diff --git a/doc/html/TechNotes/TestReview/H5Tget_native_type.html b/doc/html/TechNotes/TestReview/H5Tget_native_type.html new file mode 100644 index 0000000..1c6409d --- /dev/null +++ b/doc/html/TechNotes/TestReview/H5Tget_native_type.html @@ -0,0 +1,522 @@ +<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN"> +<HTML> +<HEAD> + <TITLE>H5Dget_native_type Test Review</TITLE> + <META http-equiv="content-type" content="text/html; charset=ISO-8859-1"> + <META name="author" content="Quincey Koziol"> +</HEAD> +<body text="#000000" bgcolor="#FFFFFF"> +<STYLE type="text/css"> +OL.loweralpha { list-style-type: lower-alpha } +OL.upperroman { list-style-type: upper-roman } +</STYLE> + +<CENTER><H1>H5Dget_native_type Test Review</H1></CENTER> + +<OL class="upperroman"> + +<LI><H3><U>Purpose:</U></H3> +<P>This document describes the API test review results for <a href="../../RM_H5T.html#Datatype-GetNativeType">H5Dget_native_type</a>(). +</P> + +<LI><H3><U>Serial Review:</U></H3> +<TABLE border="1"> +<TR> +<TH>Test case +</TH> + +<TH>Test source file +</TH> + +<TH>Test method +</TH> + +<TH>Expected test results +</TH> + +<TH>Notes +</TH> + +<TR> +<TD>Native int datatype +</TD> + +<TD>native.c +</TD> + +<TD> +<OL> +<LI>Create dataset with I32BE datatype +<LI>Query dataset's datatype +<LI>Create native datatype from dataset datatype +<LI>Compare order, class & size of native datatype to known results +</OL> +</TD> + +<TD>Check that type's size, order and class are correct. +</TD> + +<TD> +<P>Data is written & read back in for this test. +</P> +<P>It would be convenient to have a function in the test module for choosing +the correct atomic datatype based on the particular platform settings. This +should use the H5_SIZEOF_<foo> macros. +</P> +</TD> + +</TR> + +<TR> +<TD>Native long long datatype +</TD> + +<TD>native.c +</TD> + +<TD> +<OL> +<LI>Create dataset with I64LE datatype +<LI>Query dataset's datatype +<LI>Create native datatype from dataset datatype +<LI>Compare order, class & size of native datatype to known results +</OL> +</TD> + +<TD>Check that type's size, order and class are correct. +</TD> + +<TD> +<P>Data is NOT written & read back in for this test. +</P> +</TD> + +</TR> + +<TR> +<TD>Native char datatype +</TD> + +<TD>native.c +</TD> + +<TD> +<OL> +<LI>Create dataset with I8LE datatype +<LI>Query dataset's datatype +<LI>Create native datatype from dataset datatype +<LI>Compare order, class & size of native datatype to known results +</OL> +</TD> + +<TD>Check that type's size, order and class are correct. +</TD> + +<TD> +<P>Data is NOT written & read back in for this test. +</P> +</TD> + +</TR> + +<TR> +<TD>Native float datatype +</TD> + +<TD>native.c +</TD> + +<TD> +<OL> +<LI>Create dataset with F32BE datatype +<LI>Query dataset's datatype +<LI>Create native datatype from dataset datatype +<LI>Compare order, class & size of native datatype to known results +</OL> +</TD> + +<TD>Check that type's size, order and class are correct. +</TD> + +<TD> +<P>Data is NOT written & read back in for this test. +</P> +<P>Need test for native double datatype (stored as 32-bit floating-point +datatype in file). This will probably require using an "epsilon" if the data +is compared for this test. +</P> +</TD> + +</TR> + +<TR> +<TD>Compound datatype with atomic fields +</TD> + +<TD>native.c +</TD> + +<TD> +<OL> +<LI>Create datatype describing native (unpacked) struct in memory +<LI>Create datatype describing packed struct for disk +<LI>Create dataset with "packed" compound datatype +<LI>Query dataset's datatype +<LI>Get native datatype from dataset's datatype +<LI>Use H5Tequal to verify that the native datatype is the same as the native, +unpacked datatype. +</OL> +</TD> + +<TD>Check that native and unpacked datatypes are equal. +</TD> + +<TD> +<P>Data is written & read back in for this test. +</P> +</TD> + +</TR> + +<TR> +<TD>Compound datatype with one compound field +</TD> + +<TD>native.c +</TD> + +<TD> +<OL> +<LI>Create datatype describing nested native (unpacked) structs in memory +<LI>Create datatype describing nested packed structs for disk +<LI>Create dataset with "packed" compound datatype +<LI>Query dataset's datatype +<LI>Get native datatype from dataset's datatype +<LI>Use H5Tequal to verify that the native datatype is the same as the native, +unpacked datatype. +</OL> +</TD> + +<TD>Check that native and unpacked datatypes are equal. +</TD> + +<TD> +<P>Data is written & read back in for this test. +</P> +<P>Could use test for compound datatype with multiple compound fields. +</P> +<P>Could use test for 3 or more nested deep compound datatype. +</P> +</TD> + +</TR> + +<TR> +<TD>Enum datatype +</TD> + +<TD>native.c +</TD> + +<TD> +<OL> +<LI>Create enum datatype +<LI>Create dataset with enum datatype +<LI>Query dataset's datatype +<LI>Get native datatype from dataset's datatype +<LI>Use H5Tequal to verify that the native datatype is the same as the original +enum datatype. +</OL> +</TD> + +<TD>Check that native and original datatypes are equal. +</TD> + +<TD> +<P>Data is written & read back in for this test. +</P> +</TD> + +</TR> + +<TR> +<TD>Array datatype +</TD> + +<TD>native.c +</TD> + +<TD> +<OL> +<LI>Create array datatype +<LI>Create dataset with array datatype +<LI>Query dataset's datatype +<LI>Get native datatype from dataset's datatype +<LI>Use H5Tequal to verify that the native datatype is the same as the original +array datatype. +</OL> +</TD> + +<TD>Check that native and original datatypes are equal. +</TD> + +<TD> +<P><EM>This is not tested currently.</EM> +</P> +</TD> + +</TR> + +<TR> +<TD>Array of compound datatype +</TD> + +<TD>native.c +</TD> + +<TD> +<OL> +<LI>Create array of compound datatype +<LI>Create dataset with array of compound datatype +<LI>Query dataset's datatype +<LI>Get native datatype from dataset's datatype +<LI>Use H5Tequal to verify that the native datatype is the same as the original +array of compound datatype. +</OL> +</TD> + +<TD>Check that native and original datatypes are equal. +</TD> + +<TD> +<P>Data is written & read back in for this test. +</P> +</TD> + +</TR> + +<TR> +<TD>Compound datatype with array field +</TD> + +<TD>native.c +</TD> + +<TD> +<OL> +<LI>Create compound datatype with array field +<LI>Create dataset with compound datatype +<LI>Query dataset's datatype +<LI>Get native datatype from dataset's datatype +<LI>Use H5Tequal to verify that the native datatype is the same as the original +compound datatype. +</OL> +</TD> + +<TD>Check that native and original datatypes are equal. +</TD> + +<TD> +<P><EM>This is not tested currently.</EM> +</P> +</TD> + +</TR> + +<TR> +<TD>VL datatype with atomic base type +</TD> + +<TD>native.c +</TD> + +<TD> +<OL> +<LI>Create VL datatype +<LI>Create dataset with VL datatype +<LI>Query dataset's datatype +<LI>Get native datatype from dataset's datatype +<LI>Use H5Tequal to verify that the native datatype is the same as the original +VL datatype. +</OL> +</TD> + +<TD>Check that native and original datatypes are equal. +</TD> + +<TD> +<P>Data is written & read back in for this test. +</P> +<P><EM>Combinations with VL datatypes in other composite types and with other +datatypes for the base type of the VL datatype are not tested.</EM> +</P> +</TD> + +</TR> + +<TR> +<TD>VL string datatype +</TD> + +<TD>native.c +</TD> + +<TD> +<OL> +<LI>Create VL string datatype +<LI>Create dataset with VL string datatype +<LI>Query dataset's datatype +<LI>Get native datatype from dataset's datatype +<LI>Use H5Tequal to verify that the native datatype is the same as the original +VL string datatype. +</OL> +</TD> + +<TD>Check that native and original datatypes are equal. +</TD> + +<TD> +<P>Data is written & read back in for this test. +</P> +<P><EM>Combinations with VL string datatypes in composite types +are not tested.</EM> +</P> +</TD> + +</TR> + +<TR> +<TD>Reference datatype +</TD> + +<TD>native.c +</TD> + +<TD> +<OL> +<LI>Create reference datatype +<LI>Create dataset with reference datatype +<LI>Query dataset's datatype +<LI>Get native datatype from dataset's datatype +<LI>Use H5Tequal to verify that the native datatype is the same as the original +reference datatype. +</OL> +</TD> + +<TD>Check that native and original datatypes are equal. +</TD> + +<TD> +<P>Data is written & read back in for this test. +</P> +<P><EM>Combinations with reference datatypes in composite types +are not tested.</EM> +</P> +</TD> + +</TR> + +<TR> +<TD>Opaque datatype +</TD> + +<TD>native.c +</TD> + +<TD> +<OL> +<LI>Create opaque datatype +<LI>Create dataset with opaque datatype +<LI>Query dataset's datatype +<LI>Get native datatype from dataset's datatype +<LI>Use H5Tequal to verify that the native datatype is the same as the original +opaque datatype. +</OL> +</TD> + +<TD>Check that native and original datatypes are equal. +</TD> + +<TD> +<P>Data is written & read back in for this test. +</P> +<P><EM>Combinations with opaque datatypes in composite types +are not tested.</EM> +</P> +</TD> + +</TR> + +<TR> +<TD>Bitfield datatype +</TD> + +<TD>native.c +</TD> + +<TD> +<OL> +<LI>Create bitfield datatype +<LI>Create dataset with bitfield datatype +<LI>Query dataset's datatype +<LI>Get native datatype from dataset's datatype +<LI>Use H5Tequal to verify that the native datatype is the same as the original +bitfield datatype. +</OL> +</TD> + +<TD>Check that native and original datatypes are equal. +</TD> + +<TD> +<P>Data is written & read back in for this test. +</P> +<P><EM>Combinations with bitfield datatypes in composite types +are not tested.</EM> +</P> +</TD> + +</TR> + +<TR> +<TD>Time datatype +</TD> + +<TD>native.c +</TD> + +<TD> +<OL> +<LI>Create time datatype +<LI>Create dataset with time datatype +<LI>Query dataset's datatype +<LI>Get native datatype from dataset's datatype +<LI>Use H5Tequal to verify that the native datatype is the same as the original +time datatype. +</OL> +</TD> + +<TD>Check that native and original datatypes are equal. +</TD> + +<TD> +<P><EM>This is not tested currently.</EM> +</P> +</TD> + +</TR> + +</TABLE> +<BR> + +<LI><H3><U>Parallel Review:</U></H3> +<P>The H5Dget_native_type() function is not tested in parallel. Currently, +there does not appear to be a need for this. +</P> + + +</OL> + +</BODY> +</HTML> + |