mirror of
https://github.com/HDFGroup/hdf5.git
synced 2024-11-27 02:10:55 +08:00
[svn-r6127] Purpose:
Added description of API testing for H5Tget_native_type().
This commit is contained in:
Quincey Koziol
parent
71d1ebea7a
commit
6d83499230
522
doc/html/TechNotes/TestReview/H5Tget_native_type.html
Normal file
522
doc/html/TechNotes/TestReview/H5Tget_native_type.html
Normal file
@ -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>
|
||||
|
||||
Loading…
Reference in New Issue
Block a user