Release ESMF_3_0_3 Public Method Interface Additions and Modifications:

Public method interface changes:

The following methods have been modified in their arguments to reflect the change from type(ESMF_Grid) to type(ESMF_IGrid). Many of these arguments will be converted back to ESMF_Grid as integration of the new Grid class with Fields, Bundles, etc. proceeds and the IGrid class is removed.

Gridded Component:
ESMF_GridCompCreate()
ESMF_GridCompGet()
ESMF_GridCompSet()
Bundle:
ESMF_BundleGet()
ESMF_BundleSetGrid()
Field:
ESMF_FieldCreate()
ESMF_FieldCreateNoData()
ESMF_FieldGet()
ESMF_FieldSetGrid()

Public method name changes:

All of the following routines from v3.0.2 had method and argument name modifications to
reflect the change from Grid to IGrid. The names of all parameter types associated with
the Grid software from v3.0.2 were also changed from GRID to IGRID.

(new) ESMF_IGridAddVertHeight()
(old) ESMF_GridAddVertHeight()


(new) ESMF_IGridCreate()
(old) ESMF_GridCreate()


(new) ESMF_IGridDestroy()
(old) ESMF_GridDestroy()


(new) ESMF_IGridDistribute()
(old) ESMF_GridDistribute()


(new) ESMF_IGridDistribute()
(old) ESMF_GridDistribute()


(new) ESMF_IGridGet()
(old) ESMF_GridGet()


(new) ESMF_IGridIGetAttribute()
(old) ESMF_GridGetAttribute()


(new) ESMF_IGridGetAttributeCount()
(old) ESMF_GridGetAttributeCount()


(new) ESMF_IGridGetAttributeInfo()
(old) ESMF_GridGetAttributeInfo()


(new) ESMF_IGridGetCoord()
(old) ESMF_GridGetCoord()


(new) ESMF_IGridGetCoordByDim1D()
(old) ESMF_GridGetCoordByDim1D()


(new) ESMF_IGridGetCoordByDim2D()
(old) ESMF_GridGetCoordByDim2D()


(new) ESMF_IGridGetDELocalInfo()
(old) ESMF_GridGetDELocalInfo()


(new) ESMF_IGridGlobalToDELocalIndex()
(old) ESMF_GridGlobalToDELocalIndex()


(new) ESMF_IGridDELocalToGlobalIndex()
(old) ESMF_GridDELocalToGlobalIndex()


(new) ESMF_IGridPrint()
(old) ESMF_GridPrint()


(new) ESMF_IGridSet()
(old) ESMF_GridSet()


(new) ESMF_IGridSetAttribute()
(old) ESMF_GridSetAttribute()


(new) ESMF_IGridValidate()
(old) ESMF_GridValidate()


(new) ESMF_IGridCreateHorzLatLon()
(old) ESMF_GridCreateHorzLatLon()


(new) ESMF_IGridCreateHorzLatLonUni()
(old) ESMF_GridCreateHorzLatLonUni()


(new) ESMF_IGridCreateHorzXY()
(old) ESMF_GridCreateHorzXY()


(new) ESMF_IGridCreateHorzXYUni()
(old) ESMF_GridCreateHorzXYUni()


Grid

(new) ESMF_GridAllocCoord(grid, staggerLoc, &
staggerLWidth, staggerUWidth, staggerAlign, &
computationalLWidth, computationalUWidth, &
totalLWidth, totalUWidth,rc)


(new) ESMF_GridCommit(grid, status, defaultflag, rc)


(new) newGrid=ESMF_GridCreate(name,coordTypeKind,distgrid, dimmap, &
lbounds, ubounds, coordRank, coordDimMap, indexflag, gridType, rc)


(new) newGrid=ESMF_GridCreateEmpty(rc)


(new) newGrid=ESMF_GridCreateShape(name,coordTypeKind, minIndex, &
countsPerDEDim1,countsPerDeDim2, countsPerDEDim3, &
connDim1, connDim2, connDim3, &
poleStaggerLoc1, poleStaggerLoc2, poleStaggerLoc3, &
bipolePos1, bipolePos2, bipolePos3, &
coordDep1, coordDep2, coordDep3, &
indexflag, gridType, petMap, rc)


(new) ESMF_GridDestroy(grid, rc)


(new) ESMF_GridGet(grid, name, coordTypeKind, rank, &
tileCount, distGrid, staggerLocsCount, &
dimmap, lbounds, ubounds, coordRank, coordDimMap, &
indexFlag, gridType, localDECount,distRank,undistRank, rc)



(new) ESMF_GridGetCoord(grid, staggerLoc,coord, array, docopy, rc)


(new) ESMF_GridGetLocalTileCoord(grid, localDE, &
staggerLoc, coord, fptr, doCopy, rc)


(new) ESMF_GridGetLocalTileInfo(grid, coord, localDE, staggerLoc, &
exclusiveLBound, exclusiveUBound, staggerLBound, staggerUBound, &
computationalLBound, computationalUBound, totalLBound, totalUBound, rc)


(new) ESMF_GridSet(grid,name,coordTypeKind,distgrid, &
dimmap, lbounds, ubounds, coordRank, coordDimMap, &
indexflag, gridType, rc)


(new) ESMF_GridSetCoordFromArray(grid, staggerLoc, coord, &
array, doCopy, rc)


(new) ESMF_GridSetShape(grid, name,coordTypeKind, minIndex, &
countsPerDEDim1,countsPerDeDim2, countsPerDEDim3, &
connDim1, connDim2, connDim3, &
poleStaggerLoc1, poleStaggerLoc2, poleStaggerLoc3, &
bipolePos1, bipolePos2, bipolePos3, &
coordDep1, coordDep2, coordDep3, &
indexflag, gridType, petMap, rc)


(new) ESMF_StaggerLocSet(stagLoc,loc,rc)


DistGrid


(new) ESMF_DistGridCreate(minIndex, maxIndex, ..., rc)

(old) ESMF_DistGridCreate(minCorner, maxCorner, ..., rc)



(new) ESMF_DistGridCreate(arbSeqIndexList, rc)



(new) ESMF_DistGridGet(distgrid, delayout, dimCount, patchCount, &
minIndexPDimPPatch, maxIndexPDimPPatch, cellCountPPatch, cellCountPDe, &
patchListPDe, indexCountPDimPDe, regDecompFlag, rc)

(old) ESMF_DistGridGet(distgrid, delayout, patchCount, patchList, &
dimCount, dimExtent, regDecompFlag, rc)



(new) ESMF_DistGridGet(distgrid, localDe, seqIndexList, rc)



(new) ESMF_DistGridGet(distgrid, localDe, dim, indexList, rc)

(old) ESMF_DistGridGet(distgrid, de, dim, indexList, rc)


Array


(new) ESMF_ArrayCreate(..., name, rc)

(old) ESMF_ArrayCreate(..., rc)

(new) ESMF_ArrayGet(array, typekind, rank, larrayList, &
indexflag, dimmap, inverseDimmap, exclusiveLBound, exclusiveUBound,&
computationalLBound, computationalUBound, totalLBound, totalUBound, &
computationalLWidth, computationalUWidth, totalLWidth, totalUWidth, &
name, distgrid, dimCount, patchCount, minIndexPDimPPatch, &
maxIndexPDimPPatch, patchListPDe, indexCountPDimPDe, delayout, &
deCount, localDeCount, localDeList, rc)

(old) ESMF_ArrayGet(array, typekind, rank, larrayList, &
indexflag, dimmap, inverseDimmap, &
exclusiveLBound, exclusiveUBound, &
computationalLBound, computationalUBound, &
totalLBound, totalUBound, &
computationalLWidth, computationalUWidth, &
totalLWidth, totalUWidth, &
name, distgrid, dimCount, dimExtent, &
delayout, deCount, localDeCount, &
localDeList, rc)

(new) ESMF_ArrayGet(array, localDe, dim, indexCount, indexList, rc)

(old) ESMF_ArrayGet(array, dim, localDe, dimExtent, indexList, rc)

(new) ESMF_ArraySparseMatMulStore(srcArray, dstArray, routehandle, factorList, factorIndexList, rc)
(old) ESMF_ArraySparseMatMulStore(srcArray, dstArray, factorList, factorIndexList, rootPET, routehandle, rc)

(new) ESMF_ArraySparseMatMul(srcArray, dstArray, routehandle, zeroflag, rc)

(old) ESMF_ArraySparseMatMul(srcArray, dstArray, routehandle, rc)