refactor v2 code

Author: karlnicholas

docs/read.md

@@ -1,24 +1,25 @@
-# Hdf5JavaLib: Read Capabilities (Version 0.2.1)
+# Hdf5JavaLib: Read Capabilities (Version 0.3.0)
 
-Hdf5JavaLib is a pure Java library for reading HDF5 files, released as version 0.2.1. This guide helps users read datasets in the root group using examples from the `org.hdf5javalib.examples.read` package. The library reads HDF5 files generated by the C++ HDF5 library, supporting compound datasets, multi-dimensional data, and various datatypes. New in version 0.2.1: enhanced sequential and parallel streaming, array flattening, slicing, reducing along axes, filtering with coordinate lists, and custom type converters for compound datasets.
+Hdf5JavaLib is a pure Java library for reading HDF5 files, released as version 0.3.0. This guide helps users read datasets in the root group using examples from the `org.hdf5javalib.examples.read` package. The library reads HDF5 files generated by the C++ HDF5 library, supporting compound datasets, multi-dimensional data, and various datatypes. Version 0.3.0 and higher should support all hdf5 files.
 
 ## Setup
 
 ### Add the Dependency
 
-Add Hdf5JavaLib to your project via [Maven Central](https://search.maven.org/artifact/org.hdf5javalib/hdf5javalib/0.2.1/jar):
+Add Hdf5JavaLib to your project via [Maven Central](https://search.maven.org/artifact/org.hdf5javalib/hdf5javalib/0.3.0/jar):
 
 ```xml
 <dependency>
     <groupId>org.hdf5javalib</groupId>
     <artifactId>hdf5javalib</artifactId>
-    <version>0.2.1</version>
+    <version>0.3.0</version>
 </dependency>
 ```
 
 ### Requirements
 - Java 17 or higher.
-- No external HDF5 dependencies.
+- Runtime support for org.slf4j, automatically included in springboot projects or link in slf4j-api and logback runtimes.
+- No external HDF5 dependencies required.
 
 ### Alternative: Build from Source
 1. Clone the repository:
@@ -38,7 +39,7 @@ Add Hdf5JavaLib to your project via [Maven Central](https://search.maven.org/art
 
 ## Read Capabilities
 
-Hdf5JavaLib supports reading datasets in the root group (`/`), including:
+Hdf5JavaLib supports full dataset and group paths, for example reading datasets in the root group (`/`) or subgroups ('/G1/DS1'), including:
 - **Compound Datasets**: Structured data with fields like integers, strings, floats, and nested compounds (e.g., `CompoundData` with `fixed_point`, `floating_point`). Supports mapping to custom Java classes or records with custom type converters.
 - **Scalar Datasets**: Single values (e.g., fixed-point, floating-point, strings).
 - **Vector Datasets**: 1D arrays (e.g., strings, integers).
@@ -60,6 +61,8 @@ Hdf5JavaLib supports reading datasets in the root group (`/`), including:
 - **Metadata**: Partial support for SNODs (symbol table nodes).
 - **Streaming**: Sequential and parallel streaming for efficient data processing, with Spliterators for all dataset types.
 - **Advanced Operations**: Array flattening, dimensional slicing, reduction along axes, and filtering with coordinate lists via `FlattenedArrayUtils`.
+- **V1** and **V2**: Version 1 and 2 hdf file structures.
+- **NASA**: Tested against at least 2 actual NASA datafiles, `ATL03_20250302235544_11742607_007_01.h5` and `ATL03_20250302235544_11742607_006_01.h5`, found at [https://nsidc.org/data/atl03/versions/5](https://nsidc.org/data/atl03/versions/5) 
 
 ## Usage
 

hdf5/notes.txt

@@ -1,5 +1,8 @@
 java -cp target\hdf5javalib-0.2.2-SNAPSHOT.jar;C:\Users\karln\.m2\repository\org\slf4j\log4j-over-slf4j\2.0.6\log4j-over-slf4j-2.0.6.jar;C:\Users\karln\.m2\repository\org\slf4j\slf4j-api\2.0.6\slf4j-api-2.0.6.jar;C:\Users\karln\.m2\repository\org\slf4j\slf4j-simple\2.0.6\slf4j-simple-2.0.6.jar org.hdf5javalib.examples.hdf5examples.HDF5Debug > ex.out
 
+java -cp target\hdf5javalib-0.2.2-SNAPSHOT.jar;C:\Users\karnicho\.m2\repository\org\slf4j\slf4j-api\2.0.17\slf4j-api-2.0.17.jar;C:\Users\karnicho\.m2\repository\ch\qos\logback\logback-classic\1.5.18\logback-classic-1.5.18.jar;C:\Users\karnicho\.m2\repository\ch\qos\logback\logback-core\1.5.18\logback-core-1.5.18.jar org.hdf5javalib.examples.hdf5examples.HDF5Debug > ex.out
+
+java -cp target\hdf5javalib-0.2.2-SNAPSHOT.jar;C:\Users\karnicho\.m2\repository\org\slf4j\slf4j-api\2.0.17\slf4j-api-2.0.17.jar org.hdf5javalib.examples.hdf5examples.HDF5Debug > ex.out
 
 The HDF5Examples repository (or directory in the HDF5 source distribution) contains code samples demonstrating how to use the HDF5 library across various programming languages. Below, I'll explain the purpose of the specified directories based on their structure and contents. Note that the examples are practical code snippets (e.g., .c files) that compile and run to illustrate specific HDF5 API features.
 

src/main/java/org/hdf5javalib/examples/hdf5examples/HDF5Debug.java

@@ -47,8 +47,8 @@ private void run() {
             // List all .h5 files in HDF5Examples resources directory
             // ATL03_20250302235544_11742607_006_01
 //            Path dirPath = Paths.get(Objects.requireNonNull(HDF5Debug.class.getClassLoader().getResource("HDF5Examples/h5ex_g_compact2.h5")).toURI());
-//            Path dirPath = Paths.get("c:/users/karln/Downloads/ATL03_20250302235544_11742607_007_01.h5");
-            Path dirPath = Paths.get("c:/users/karln/Downloads/ATL03_20250302235544_11742607_006_01.h5");
+//            Path dirPath = Paths.get("c:/users/karnicho/Downloads/ATL03_20250302235544_11742607_007_01.h5");
+            Path dirPath = Paths.get("c:/users/karnicho/Downloads/ATL03_20250302235544_11742607_006_01.h5");
             processFile(dirPath);
         } catch (Exception e) {
             throw new IllegalStateException(e);