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)