@earthyscience/netcdf4-wasm 0.1.3 → 0.2.0

package/dist/netcdf-getters.js

@@ -1,18 +1,21 @@
 import { NC_CONSTANTS, DATA_TYPE_SIZE, CONSTANT_DTYPE_MAP } from './constants.js';
-export function getVariables(module, ncid) {
+export function getGroupVariables(module, ncid, groupPath) {
+    const workingNcid = groupPath ? getGroupNCID(module, ncid, groupPath) : ncid;
     const variables = {};
-    const varCount = getVarCount(module, ncid);
-    const dimIds = getDimIDs(module, ncid);
+    const varCount = getVarCount(module, workingNcid);
     for (let varid = 0; varid < varCount; varid++) {
-        if (dimIds.includes(varid))
-            continue; //Don't include spatial Vars
-        const result = module.nc_inq_varname(ncid, varid);
-        if (result.result !== NC_CONSTANTS.NC_NOERR || !result.name) {
-            console.warn(`Failed to get variable name for varid ${varid} (error: ${result.result})`);
+        const nameResult = module.nc_inq_varname(workingNcid, varid);
+        if (nameResult.result !== NC_CONSTANTS.NC_NOERR || !nameResult.name) {
+            console.warn(`Failed to get variable name for varid ${varid} (error: ${nameResult.result})`);
             continue;
         }
-        variables[result.name] = {
-            id: varid
+        // A coordinate variable is one whose name matches a dimension.
+        const isCoordinate = findDimInHierarchy(module, workingNcid, nameResult.name);
+        if (isCoordinate)
+            continue;
+        variables[nameResult.name] = {
+            id: varid,
+            ncid: workingNcid // CRITICAL: Store the ncid where this variable lives!
         };
     }
     return variables;
@@ -31,73 +34,104 @@ export function getDimCount(module, ncid) {
     }
     return result.ndims || 0;
 }
-export function getDims(module, ncid) {
-    const dimIDs = getDimIDs(module, ncid);
+export function getDims(module, ncid, groupPath) {
+    const workingNcid = groupPath ? getGroupNCID(module, ncid, groupPath) : ncid;
+    const dimIDs = getDimIDs(module, workingNcid);
     const dims = {};
     for (const dimid of dimIDs) {
-        const dim = getDim(module, ncid, dimid);
+        const dim = getDim(module, workingNcid, dimid);
         dims[dim.name] = {
             size: dim.len,
-            units: dim.units,
+            units: dim.units ?? null,
             id: dim.id
         };
     }
     return dims;
 }
-export function getDimIDs(module, ncid) {
-    const result = module.nc_inq_dimids(ncid, 0);
+export function getDimIDs(module, ncid, includeParents = false) {
+    const result = module.nc_inq_dimids(ncid, includeParents ? 1 : 0);
     if (result.result !== NC_CONSTANTS.NC_NOERR) {
         throw new Error(`Failed to get dimension IDs (error: ${result.result})`);
     }
-    return result.dimids || [0];
+    return result.dimids ?? [];
+}
+function findCoordinateVariable(module, startNcid, name) {
+    let current = startNcid;
+    while (current !== null) {
+        const result = module.nc_inq_varid(current, name);
+        if (result.result === NC_CONSTANTS.NC_NOERR) {
+            return {
+                ncid: current,
+                varid: result.varid
+            };
+        }
+        current = getGroupParent(module, current);
+    }
+    return null;
 }
 export function getDim(module, ncid, dimid) {
     const result = module.nc_inq_dim(ncid, dimid);
     if (result.result !== NC_CONSTANTS.NC_NOERR) {
         throw new Error(`Failed to get dim (error: ${result.result})`);
     }
-    const varResult = module.nc_inq_varid(ncid, result.name);
-    const varID = varResult.varid;
-    const { result: output, ...dim } = result;
-    const unitResult = getAttributeValues(module, ncid, varID, "units");
-    return { ...dim, units: unitResult, id: varID };
+    const { result: _r, ...dim } = result;
+    let varID = null;
+    let units = null;
+    let coordNcid = null;
+    // Search upward for coordinate variable
+    const coord = findCoordinateVariable(module, ncid, dim.name);
+    if (coord) {
+        varID = coord.varid;
+        coordNcid = coord.ncid;
+        units = getAttributeValues(module, coordNcid, varID, "units");
+    }
+    return {
+        ...dim,
+        id: varID,
+        units,
+        coordNcid // useful for debugging
+    };
 }
 export function getAttributeValues(module, ncid, varid, attname) {
     const attInfo = module.nc_inq_att(ncid, varid, attname);
     if (attInfo.result !== NC_CONSTANTS.NC_NOERR) {
         console.warn(`Failed to get attribute info for ${attname} (error: ${attInfo.result})`);
-        return;
+        return null;
     }
     const attType = attInfo.type;
     if (!attType)
         throw new Error("Failed to allocate memory for attribute type.");
-    let attValue;
-    if (attType === 2)
-        attValue = module.nc_get_att_text(ncid, varid, attname, attInfo.len);
-    else if (attType === 3)
-        attValue = module.nc_get_att_short(ncid, varid, attname, attInfo.len);
-    else if (attType === 4)
-        attValue = module.nc_get_att_int(ncid, varid, attname, attInfo.len);
-    else if (attType === 5)
-        attValue = module.nc_get_att_float(ncid, varid, attname, attInfo.len);
-    else if (attType === 6)
-        attValue = module.nc_get_att_double(ncid, varid, attname, attInfo.len);
-    else if (attType === 10)
-        attValue = module.nc_get_att_longlong(ncid, varid, attname, attInfo.len);
-    else
-        attValue = module.nc_get_att_double(ncid, varid, attname, attInfo.len);
+    // Dispatch table: maps NetCDF type -> module getter
+    const getterMap = {
+        [NC_CONSTANTS.NC_CHAR]: module.nc_get_att_text,
+        [NC_CONSTANTS.NC_SHORT]: module.nc_get_att_short,
+        [NC_CONSTANTS.NC_INT]: module.nc_get_att_int,
+        [NC_CONSTANTS.NC_FLOAT]: module.nc_get_att_float,
+        [NC_CONSTANTS.NC_DOUBLE]: module.nc_get_att_double,
+        [NC_CONSTANTS.NC_UBYTE]: module.nc_get_att_uchar,
+        [NC_CONSTANTS.NC_UINT]: module.nc_get_att_uint,
+        [NC_CONSTANTS.NC_USHORT]: module.nc_get_att_ushort,
+        [NC_CONSTANTS.NC_LONGLONG]: module.nc_get_att_longlong,
+        [NC_CONSTANTS.NC_UINT64]: module.nc_get_att_ulonglong,
+        [NC_CONSTANTS.NC_STRING]: module.nc_get_att_string
+    };
+    const getter = getterMap[attType];
+    if (!getter)
+        throw new Error(`Unsupported attribute type ${attType}`);
+    const attValue = getter(ncid, varid, attname, attInfo.len);
     return attValue.data;
 }
-export function getGlobalAttributes(module, ncid) {
+export function getGlobalAttributes(module, ncid, groupPath) {
+    const workingNcid = groupPath ? getGroupNCID(module, ncid, groupPath) : ncid;
     const attributes = {};
-    const nattsResult = module.nc_inq_natts(ncid);
+    const nattsResult = module.nc_inq_natts(workingNcid);
     if (nattsResult.result !== NC_CONSTANTS.NC_NOERR) {
         throw new Error(`Failed to get number of global attributes (error: ${nattsResult.result})`);
     }
     const nAtts = nattsResult.natts;
     const attNames = [];
     for (let i = 0; i < nAtts; i++) {
-        const name = getAttributeName(module, ncid, NC_CONSTANTS.NC_GLOBAL, i);
+        const name = getAttributeName(module, workingNcid, NC_CONSTANTS.NC_GLOBAL, i);
         attNames.push(name);
     }
     if (attNames.length === 0)
@@ -105,7 +139,7 @@ export function getGlobalAttributes(module, ncid) {
     for (const attname of attNames) {
         if (!attname)
             continue;
-        attributes[attname] = getAttributeValues(module, ncid, NC_CONSTANTS.NC_GLOBAL, attname);
+        attributes[attname] = getAttributeValues(module, workingNcid, NC_CONSTANTS.NC_GLOBAL, attname);
     }
     return attributes;
 }
@@ -116,11 +150,12 @@ export function getAttributeName(module, ncid, varid, attId) {
     }
     return result.name;
 }
-export function getFullMetadata(module, ncid) {
-    const varIds = getVarIDs(module, ncid);
+export function getFullMetadata(module, ncid, groupPath) {
+    const workingNcid = groupPath ? getGroupNCID(module, ncid, groupPath) : ncid;
+    const varIds = getVarIDs(module, workingNcid);
     const metas = [];
     for (const varid of varIds) {
-        const varMeta = getVariableInfo(module, ncid, varid);
+        const varMeta = getVariableInfo(module, workingNcid, varid);
         const { attributes, ...varDeets } = varMeta;
         metas.push({ ...varDeets, ...attributes });
     }
@@ -131,39 +166,44 @@ export function getVarIDs(module, ncid) {
     if (result.result !== NC_CONSTANTS.NC_NOERR) {
         throw new Error(`Failed to get variable IDs (error: ${result.result})`);
     }
-    return result.varids || [0];
+    return result.varids ?? [];
 }
-export function getVariableInfo(module, ncid, variable) {
+export function getVariableInfo(module, ncid, variable, groupPath) {
+    const workingNcid = groupPath ? getGroupNCID(module, ncid, groupPath) : ncid;
     const info = {};
     const isId = typeof variable === "number";
     let varid = variable;
     if (!isId) {
-        const result = module.nc_inq_varid(ncid, variable);
+        const result = module.nc_inq_varid(workingNcid, variable);
         varid = result.varid;
     }
-    const result = module.nc_inq_var(ncid, varid);
+    const result = module.nc_inq_var(workingNcid, varid);
     if (result.result !== NC_CONSTANTS.NC_NOERR) {
         throw new Error(`Failed to get variable info (error: ${result.result})`);
     }
     const typeMultiplier = DATA_TYPE_SIZE[result.type];
-    //Dim Info
+    // Dim Info - FIXED to preserve order
     const dimids = result.dimids;
     const dims = [];
     const shape = [];
+    const dimensions = []; // Array to store dimension names in order
     let size = 1;
     if (dimids) {
-        for (const dimid of dimids) {
-            const dim = getDim(module, ncid, dimid);
+        // Iterate through dimids in order - this matches the shape order
+        for (let i = 0; i < dimids.length; i++) {
+            const dimid = dimids[i];
+            const dim = getDim(module, workingNcid, dimid);
             size *= dim.len;
             dims.push(dim);
             shape.push(dim.len);
+            dimensions.push(dim.name); // Add dimension name in the same order
         }
     }
-    //Attribute Info
+    // Attribute Info
     const attNames = [];
     if (result.natts) {
         for (let i = 0; i < result.natts; i++) {
-            const attname = getAttributeName(module, ncid, varid, i);
+            const attname = getAttributeName(module, workingNcid, varid, i);
             attNames.push(attname);
         }
     }
@@ -172,12 +212,12 @@ export function getVariableInfo(module, ncid, variable) {
         for (const attname of attNames) {
             if (!attname)
                 continue;
-            atts[attname] = getAttributeValues(module, ncid, varid, attname);
+            atts[attname] = getAttributeValues(module, workingNcid, varid, attname);
         }
     }
-    //Chunking Info
+    // Chunking Info
     let chunks;
-    const chunkResult = module.nc_inq_var_chunking(ncid, varid);
+    const chunkResult = module.nc_inq_var_chunking(workingNcid, varid);
     const isChunked = chunkResult.chunking === NC_CONSTANTS.NC_CHUNKED;
     if (isChunked) {
         chunks = chunkResult.chunkSizes;
@@ -186,12 +226,13 @@ export function getVariableInfo(module, ncid, variable) {
         chunks = shape;
     }
     const chunkElements = chunks.reduce((a, b) => a * b, 1);
-    //Output 
+    // Output 
     info["name"] = result.name;
     info["dtype"] = CONSTANT_DTYPE_MAP[result.type];
     info['nctype'] = result.type;
     info["shape"] = shape;
     info['dims'] = dims;
+    info["dimensions"] = dimensions; // Add ordered dimension names array
     info["size"] = size;
     info["totalSize"] = size * typeMultiplier;
     info["attributes"] = atts;
@@ -200,64 +241,360 @@ export function getVariableInfo(module, ncid, variable) {
     info["chunkSize"] = chunkElements * typeMultiplier;
     return info;
 }
-export function getVariableArray(module, ncid, variable) {
-    const isId = typeof variable === "number";
-    let varid = isId ? variable : 0;
-    if (!isId) {
-        const result = module.nc_inq_varid(ncid, variable);
+export function getVariableArray(module, ncid, variable, groupPath) {
+    const workingNcid = groupPath ? getGroupNCID(module, ncid, groupPath) : ncid;
+    // Resolve variable id
+    let varid;
+    if (typeof variable === "number") {
+        varid = variable;
+    }
+    else {
+        const result = module.nc_inq_varid(workingNcid, variable);
+        if (result.result !== NC_CONSTANTS.NC_NOERR) {
+            throw new Error(`Failed to get variable id for '${variable}' (error: ${result.result})`);
+        }
         varid = result.varid;
     }
-    const info = getVariableInfo(module, ncid, varid);
-    const arraySize = info.size;
+    const info = getVariableInfo(module, workingNcid, varid);
     const arrayType = info.nctype;
-    if (!arrayType || !arraySize)
-        throw new Error("Failed to allocate memory for array");
+    const arraySize = info.size;
+    if (arrayType === undefined || arrayType === null) {
+        throw new Error("Failed to determine variable type");
+    }
+    if (arraySize === undefined || arraySize === null) {
+        throw new Error("Failed to determine variable size");
+    }
+    // Arrow wrappers = safe binding
+    const readers = {
+        [NC_CONSTANTS.NC_CHAR]: (...args) => module.nc_get_var_text(...args),
+        [NC_CONSTANTS.NC_SHORT]: (...args) => module.nc_get_var_short(...args),
+        [NC_CONSTANTS.NC_INT]: (...args) => module.nc_get_var_int(...args),
+        [NC_CONSTANTS.NC_FLOAT]: (...args) => module.nc_get_var_float(...args),
+        [NC_CONSTANTS.NC_DOUBLE]: (...args) => module.nc_get_var_double(...args),
+        [NC_CONSTANTS.NC_LONGLONG]: (...args) => module.nc_get_var_longlong(...args),
+        [NC_CONSTANTS.NC_BYTE]: (...args) => module.nc_get_var_schar(...args),
+        [NC_CONSTANTS.NC_UBYTE]: (...args) => module.nc_get_var_uchar(...args),
+        [NC_CONSTANTS.NC_USHORT]: (...args) => module.nc_get_var_ushort(...args),
+        [NC_CONSTANTS.NC_UINT]: (...args) => module.nc_get_var_uint(...args),
+        [NC_CONSTANTS.NC_INT64]: (...args) => module.nc_get_var_longlong(...args),
+        [NC_CONSTANTS.NC_UINT64]: (...args) => module.nc_get_var_ulonglong(...args),
+        [NC_CONSTANTS.NC_STRING]: (...args) => module.nc_get_var_string(...args),
+    };
+    const reader = readers[arrayType];
     let arrayData;
-    if (arrayType === 2)
-        arrayData = module.nc_get_var_text(ncid, varid, arraySize);
-    else if (arrayType === 3)
-        arrayData = module.nc_get_var_short(ncid, varid, arraySize);
-    else if (arrayType === 4)
-        arrayData = module.nc_get_var_int(ncid, varid, arraySize);
-    else if (arrayType === 10)
-        arrayData = module.nc_get_var_longlong(ncid, varid, arraySize);
-    else if (arrayType === 5)
-        arrayData = module.nc_get_var_float(ncid, varid, arraySize);
-    else if (arrayType === 6)
-        arrayData = module.nc_get_var_double(ncid, varid, arraySize);
-    else
-        arrayData = module.nc_get_var_double(ncid, varid, arraySize);
-    if (!arrayData.data)
-        throw new Error("Failed to read array data");
+    if (!reader) {
+        console.warn(`Unknown NetCDF type ${arrayType}, falling back to double`);
+        arrayData = module.nc_get_var_double(workingNcid, varid, arraySize);
+    }
+    else {
+        arrayData = reader(workingNcid, varid, arraySize);
+    }
+    if (arrayData.result !== NC_CONSTANTS.NC_NOERR) {
+        throw new Error(`Failed to read array data (error: ${arrayData.result})`);
+    }
+    if (!arrayData.data) {
+        console.error("nc_get_var result:", arrayData);
+        throw new Error("nc_get_var returned no data");
+    }
     return arrayData.data;
 }
-export function getSlicedVariableArray(module, ncid, variable, start, count) {
-    const isId = typeof variable === "number";
-    let varid = isId ? variable : 0;
-    if (!isId) {
-        const result = module.nc_inq_varid(ncid, variable);
+export function getSlicedVariableArray(module, ncid, variable, start, count, groupPath) {
+    const workingNcid = groupPath ? getGroupNCID(module, ncid, groupPath) : ncid;
+    // Resolve variable id
+    let varid;
+    if (typeof variable === "number") {
+        varid = variable;
+    }
+    else {
+        const result = module.nc_inq_varid(workingNcid, variable);
+        if (result.result !== NC_CONSTANTS.NC_NOERR) {
+            throw new Error(`Failed to get variable id for '${variable}' (error: ${result.result})`);
+        }
         varid = result.varid;
     }
-    const info = getVariableInfo(module, ncid, varid);
+    const info = getVariableInfo(module, workingNcid, varid);
     const arrayType = info.nctype;
-    if (!arrayType)
-        throw new Error("Failed to allocate memory for array");
+    if (arrayType === undefined || arrayType === null) {
+        throw new Error("Failed to determine variable type");
+    }
+    // Arrow wrappers keep module binding intact
+    const readers = {
+        [NC_CONSTANTS.NC_SHORT]: (...args) => module.nc_get_vara_short(...args),
+        [NC_CONSTANTS.NC_INT]: (...args) => module.nc_get_vara_int(...args),
+        [NC_CONSTANTS.NC_FLOAT]: (...args) => module.nc_get_vara_float(...args),
+        [NC_CONSTANTS.NC_DOUBLE]: (...args) => module.nc_get_vara_double(...args),
+        [NC_CONSTANTS.NC_BYTE]: (...args) => module.nc_get_vara_schar(...args),
+        [NC_CONSTANTS.NC_UBYTE]: (...args) => module.nc_get_vara_uchar(...args),
+        [NC_CONSTANTS.NC_USHORT]: (...args) => module.nc_get_vara_ushort(...args),
+        [NC_CONSTANTS.NC_UINT]: (...args) => module.nc_get_vara_uint(...args),
+        [NC_CONSTANTS.NC_INT64]: (...args) => module.nc_get_vara_longlong(...args),
+        [NC_CONSTANTS.NC_UINT64]: (...args) => module.nc_get_vara_ulonglong(...args),
+        [NC_CONSTANTS.NC_STRING]: (...args) => module.nc_get_vara_string(...args),
+    };
+    const reader = readers[arrayType];
     let arrayData;
-    if (arrayType === 3)
-        arrayData = module.nc_get_vara_short(ncid, varid, start, count);
-    else if (arrayType === 4)
-        arrayData = module.nc_get_vara_int(ncid, varid, start, count);
-    else if (arrayType === 5)
-        arrayData = module.nc_get_vara_float(ncid, varid, start, count);
-    else if (arrayType === 6)
-        arrayData = module.nc_get_vara_double(ncid, varid, start, count);
-    else
-        arrayData = module.nc_get_vara_double(ncid, varid, start, count);
+    if (!reader) {
+        console.warn(`Unknown NetCDF type ${arrayType}, falling back to double`);
+        arrayData = module.nc_get_vara_double(workingNcid, varid, start, count);
+    }
+    else {
+        arrayData = reader(workingNcid, varid, start, count);
+    }
+    if (arrayData.result !== NC_CONSTANTS.NC_NOERR) {
+        throw new Error(`Failed to read sliced array data (error: ${arrayData.result})`);
+    }
     if (!arrayData.data) {
-        console.log(arrayData);
-        throw new Error("Failed to read array data");
+        console.error("nc_get_vara result:", arrayData);
+        throw new Error("Failed to read array data - no data returned");
     }
     return arrayData.data;
 }
-//    if (!module) throw new Error("Failed to load module. Ensure module is initialized before calling methods")
+//---- Group Functions ----//
+/**
+ * Get group ncid by path (supports nested groups)
+ * Uses nc_inq_grp_full_ncid for absolute paths and manual traversal for relative paths
+ * @param module - NetCDF4 module
+ * @param ncid - Current ncid (can be root or any group)
+ * @param groupPath - Can be absolute ("/group1/subgroup") or relative ("subgroup" or "group1/subgroup")
+ * @returns The ncid of the requested group
+ */
+export function getGroupNCID(module, ncid, groupPath) {
+    // Optimization: if path is root, return the ncid
+    if (groupPath === '/' || groupPath === '') {
+        return ncid;
+    }
+    // Try using nc_inq_grp_full_ncid for absolute paths (more efficient)
+    if (groupPath.startsWith('/')) {
+        const result = module.nc_inq_grp_full_ncid(ncid, groupPath);
+        if (result.result === NC_CONSTANTS.NC_NOERR) {
+            return result.grp_ncid;
+        }
+        // Get current path for better error message
+        const currentPath = getGroupPath(module, ncid);
+        throw new Error(`Failed to find group '${groupPath}' from '${currentPath}' (error: ${result.result})`);
+    }
+    // Manual traversal for relative paths
+    const parts = groupPath.split('/').filter(p => p.length > 0);
+    let currentNcid = ncid;
+    for (const part of parts) {
+        const result = module.nc_inq_grp_ncid(currentNcid, part);
+        if (result.result !== NC_CONSTANTS.NC_NOERR) {
+            const currentPath = getGroupPath(module, currentNcid);
+            throw new Error(`Failed to get group ncid for '${part}' in path '${groupPath}' from '${currentPath}' (error: ${result.result})`);
+        }
+        currentNcid = result.grp_ncid;
+    }
+    return currentNcid;
+}
+/**
+ * Alias for getGroupNCID (matches nc_inq_ncid API)
+ * @param module - NetCDF4 module
+ * @param ncid - Current ncid
+ * @param groupName - Group name or path
+ * @returns The ncid of the requested group
+ */
+export const getNCID = getGroupNCID;
+/**
+ * Get immediate child groups (non-recursive)
+ * @param module - NetCDF4 module
+ * @param ncid - Group ncid to query
+ * @returns Object mapping group names to their ncids
+ */
+export function getGroups(module, ncid) {
+    const result = module.nc_inq_grps(ncid);
+    if (result.result !== NC_CONSTANTS.NC_NOERR) {
+        throw new Error(`Failed to get groups (error: ${result.result})`);
+    }
+    const groups = {};
+    const grpids = result.grpids || [];
+    for (const grpid of grpids) {
+        const nameResult = module.nc_inq_grpname(grpid);
+        if (nameResult.result === NC_CONSTANTS.NC_NOERR && nameResult.name) {
+            groups[nameResult.name] = grpid;
+        }
+    }
+    return groups;
+}
+/**
+ * Get all groups recursively (returns nested structure)
+ * @param module - NetCDF4 module
+ * @param ncid - Group ncid to start from (usually root)
+ * @returns Nested object structure with group names, ncids, and subgroups
+ */
+export function getGroupsRecursive(module, ncid) {
+    const result = module.nc_inq_grps(ncid);
+    if (result.result !== NC_CONSTANTS.NC_NOERR) {
+        throw new Error(`Failed to get groups (error: ${result.result})`);
+    }
+    const groups = {};
+    const grpids = result.grpids || [];
+    for (const grpid of grpids) {
+        const nameResult = module.nc_inq_grpname(grpid);
+        if (nameResult.result === NC_CONSTANTS.NC_NOERR && nameResult.name) {
+            groups[nameResult.name] = {
+                ncid: grpid,
+                subgroups: getGroupsRecursive(module, grpid) // Recursive call
+            };
+        }
+    }
+    return groups;
+}
+/**
+ * Get the name of a group
+ * @param module - NetCDF4 module
+ * @param ncid - Group ncid
+ * @returns Group name
+ */
+export function getGroupName(module, ncid) {
+    const result = module.nc_inq_grpname(ncid);
+    if (result.result !== NC_CONSTANTS.NC_NOERR) {
+        throw new Error(`Failed to get group name (error: ${result.result})`);
+    }
+    return result.name || '';
+}
+/**
+ * Get the full absolute path of a group
+ * Uses nc_inq_grpname_full for efficient path retrieval
+ * @param module - NetCDF4 module
+ * @param ncid - Group ncid
+ * @returns Full path like "/group1/subgroup"
+ */
+export function getGroupPath(module, ncid) {
+    // Use nc_inq_grpname_full to get the complete path efficiently
+    const result = module.nc_inq_grpname_full(ncid);
+    if (result.result !== NC_CONSTANTS.NC_NOERR) {
+        throw new Error(`Failed to get group full name (error: ${result.result})`);
+    }
+    return result.full_name || '/';
+}
+/**
+ * Get the length of a group's full path name
+ * @param module - NetCDF4 module
+ * @param ncid - Group ncid
+ * @returns Length of the full group path name
+ */
+export function getGroupPathLength(module, ncid) {
+    const result = module.nc_inq_grpname_len(ncid);
+    if (result.result !== NC_CONSTANTS.NC_NOERR) {
+        throw new Error(`Failed to get group name length (error: ${result.result})`);
+    }
+    return result.lenp || 0;
+}
+/**
+ * Get the parent group ncid
+ * @param module - NetCDF4 module
+ * @param ncid - Group ncid
+ * @returns Parent group ncid, or null if this is the root group
+ */
+export function getGroupParent(module, ncid) {
+    const result = module.nc_inq_grp_parent(ncid);
+    if (result.result !== NC_CONSTANTS.NC_NOERR) {
+        return null; // No parent (at root)
+    }
+    return result.parent_ncid;
+}
+function findDimInHierarchy(module, startNcid, name) {
+    let current = startNcid;
+    while (current !== null) {
+        const result = module.nc_inq_dimid(current, name);
+        if (result.result === NC_CONSTANTS.NC_NOERR) {
+            return true;
+        }
+        current = getGroupParent(module, current);
+    }
+    return false;
+}
+/**
+ * Get complete hierarchy: groups + their variables, dimensions, and attributes recursively
+ * This is the unified method that should be used for exploring the file structure
+ * @param module - NetCDF4 module
+ * @param ncid - Group ncid to start from
+ * @param groupPath - Optional path to a specific starting group
+ * @param includeParentDims - Whether to include parent dimensions in each group (default: false)
+ * @returns Complete hierarchical structure
+ */
+export function getCompleteHierarchy(module, ncid, groupPath, includeParentDims = false) {
+    const workingNcid = groupPath ? getGroupNCID(module, ncid, groupPath) : ncid;
+    // Get variables at this level (now includes ncid)
+    const variables = getGroupVariables(module, workingNcid);
+    // Get dimensions at this level
+    const dimensions = getDims(module, workingNcid);
+    // If includeParentDims is true, also get parent dimensions
+    if (includeParentDims) {
+        const result = module.nc_inq_dimids(workingNcid, 1);
+        if (result.result === NC_CONSTANTS.NC_NOERR && result.dimids) {
+            const parentDims = {};
+            for (const dimid of result.dimids) {
+                const dim = getDim(module, workingNcid, dimid);
+                // Only add if not already in dimensions (avoid duplicates)
+                if (!dimensions[dim.name]) {
+                    parentDims[dim.name] = {
+                        size: dim.len,
+                        units: dim.units ?? null,
+                        id: dim.id,
+                        inherited: true
+                    };
+                }
+            }
+            // Merge parent dimensions
+            Object.assign(dimensions, parentDims);
+        }
+    }
+    // Get attributes at this level
+    const attributes = getGlobalAttributes(module, workingNcid);
+    // Get the full path for this group
+    const fullPath = getGroupPath(module, workingNcid);
+    // Get subgroups and recurse
+    const groupsResult = module.nc_inq_grps(workingNcid);
+    const subgroups = {};
+    if (groupsResult.result === NC_CONSTANTS.NC_NOERR && groupsResult.grpids) {
+        for (const grpid of groupsResult.grpids) {
+            const nameResult = module.nc_inq_grpname(grpid);
+            if (nameResult.result === NC_CONSTANTS.NC_NOERR && nameResult.name) {
+                // Recursively get the complete hierarchy for this subgroup
+                subgroups[nameResult.name] = getCompleteHierarchy(module, grpid, undefined, includeParentDims);
+            }
+        }
+    }
+    return {
+        ncid: workingNcid, // Include the ncid at this level
+        path: fullPath, // Include the full path
+        variables,
+        dimensions,
+        attributes,
+        groups: subgroups
+    };
+}
+/**
+ * Get all variables recursively from all groups
+ * Returns a flat structure with full paths as keys
+ * @param module - NetCDF4 module
+ * @param ncid - Group ncid to start from
+ * @param currentPath - Current path (used internally for recursion)
+ * @returns Flat dictionary with full variable paths
+ */
+export function getVariables(module, ncid, currentPath) {
+    const allVars = {};
+    // Get the actual path if not provided
+    const path = currentPath || getGroupPath(module, ncid);
+    // Get variables at current level
+    const vars = getGroupVariables(module, ncid);
+    for (const [name, varData] of Object.entries(vars)) {
+        const fullPath = path === '/' ? `/${name}` : `${path}/${name}`;
+        allVars[fullPath] = { ...varData, path, ncid };
+    }
+    // Recurse into subgroups
+    const groupsResult = module.nc_inq_grps(ncid);
+    if (groupsResult.result === NC_CONSTANTS.NC_NOERR && groupsResult.grpids) {
+        for (const grpid of groupsResult.grpids) {
+            const nameResult = module.nc_inq_grpname(grpid);
+            if (nameResult.result === NC_CONSTANTS.NC_NOERR && nameResult.name) {
+                const newPath = path === '/' ? `/${nameResult.name}` : `${path}/${nameResult.name}`;
+                const subVars = getVariables(module, grpid, newPath);
+                Object.assign(allVars, subVars);
+            }
+        }
+    }
+    return allVars;
+}
 //# sourceMappingURL=netcdf-getters.js.map