ESMF_3_1_0 Public Method Interface Additions and Modifications
The following methods were removed:
All FieldDataMap methods were removed:
ESMF_FieldDataMapGet()
ESMF_FieldDataMapPrint()
ESMF_FieldDataMapSet()
ESMF_FieldDataMapSetDefault()
ESMF_FieldDataMapSetDefault()
ESMF_FieldDataMapSetInvalid()
All BundleDataMap methods were removed:
ESMF_BundleDataMapGet()
ESMF_BundleDataMapPrint()
ESMF_BundleDataMapSet()
ESMF_BundleDataMapSetDefault()
ESMF_BundleDataMapSetInvalid()
ESMF_BundleDataMapValidate()
Field communication and other methods were temporarily disabled:
ESMF_FieldGather()
ESMF_FieldGetDataPointer()
ESMF_FieldGetLocalArray()
ESMF_FieldPrint()
ESMF_FieldRedist()
ESMF_FieldRedistRelease()
ESMF_FieldRedistStore()
ESMF_FieldRegrid()
ESMF_FieldRegridRelease()
ESMF_FieldRegridStore()
ESMF_FieldSetDataMap()
ESMF_FieldSetDataPointer()
ESMF_FieldWrite()
Field create methods were temporarily disabled * except * the modified interface:
(new) newField=ESMF_FieldCreate(grid, arrayspec, allocflag, staggerloc, &
gridToFieldMap, ungriddedLBound, &
ungriddedUBound, maxHaloLWidth, &
maxHaloUWidth, name, iospec, rc)
(old) newField=ESMF_FieldCreate(igrid, arrayspec, allocflag, horzRelloc, &
vertRelloc, haloWidth, datamap, name, &
iospec, rc)
New Interfaces for Grid:
newGrid=ESMF_GridCreateShapeTile(name, coordTypeKind, &
regDecomp, decompFlag, minIndex, maxIndex, &
connDim1, connDim2, connDim3, &
poleStaggerLoc1, poleStaggerLoc2, poleStaggerLoc3, &
bipolePos1, bipolePos2, bipolePos3, &
coordDep1, coordDep2, coordDep3, &
gridEdgeLWidth, gridEdgeUWidth, gridAlign, &
indexflag, distDim, petMap, rc)
ESMF_GridGet(grid, localDe, staggerloc, &
exclusiveLBound, exclusiveUBound, exclusiveCount, &
computationalLBound, computationalUBound, computationalCount, rc)
ESMF_GridGet(grid, staggerloc, &
computationalEdgeLWidth, computationalEdgeUWidth, &
undistLBound,undistUBound, rc)
ESMF_GridSetShapeTileReg(grid, name, coordTypeKind, &
regDecomp, decompFlag, minIndex, maxIndex, &
connDim1, connDim2, connDim3, &
poleStaggerLoc1, poleStaggerLoc2, poleStaggerLoc3, &
bipolePos1, bipolePos2, bipolePos3, &
coordDep1, coordDep2, coordDep3, &
gridEdgeLWidth, gridEdgeUWidth, gridAlign, &
indexflag, distDim, petMap, rc)
ESMF_GridValidate(grid, rc)
ESMF_StaggerLocString(staggerloc, string, rc)
Interface Changes for Field:
(new) ESMF_FieldGet(field, grid, array, &
typekind, rank, staggerloc, &
gridToFieldMap, ungriddedLBound, &
ungriddedUBound, maxHaloLWidth, &
maxHaloUWidth, name, iospec, rc)
(old) ESMF_FieldGet(field, igrid, array, datamap, horzRelloc, &
vertRelloc, haloWidth, iospec, typekind, &
rank, lbounds, ubounds, name, rc)
(new) ESMF_FieldGetArray(field, array, rc)
(old) ESMF_FieldGetInternArray(field, array, rc)
(new) ESMF_FieldSetArray(field, array, rc)
(old) ESMF_FieldSetInternArray(field, array, rc)
Interface Changes for Bundle:
Bundle communication and get methods were temporarily disabled:
ESMF_BundleGetDataPointer()
ESMF_BundleRedist()
ESMF_BundleRedistRelease()
ESMF_BundleRedistStore()
ESMF_BundleRegrid()
(new) ESMF_BundleGet(bundle, grid, fieldCount, name, rc)
(old) ESMF_BundleGet(bundle, igrid, fieldCount, name, rc)
(old) ESMF_BundleSetGrid(bundle, grid, rc)
(new) ESMF_BundleSetIGrid(bundle, igrid, rc)
Interface Changes for GridComp:
(new) newComp=ESMF_GridCompCreate(name, gridcomptype, grid, &
config, configFile, clock, petList, contextflag, parentVm, rc)
(old) newComp=ESMF_GridCompCreate(name, gridcomptype, igrid, &
config, configFile, clock, petList, contextflag, parentVm, rc)
(new) ESMF_GridCompGet(gridcomp, name, gridcomptype, &
grid, config, configFile, clock, vm, contextflag, rc)
(old) ESMF_GridCompGet(gridcomp, name, gridcomptype, &
igrid, config, configFile, clock, vm, contextflag, rc)
(new) ESMF_GridCompSet(gridcomp, name, gridcomptype, grid, &
config, configFile, clock, rc)
(old) ESMF_GridCompSet(gridcomp, name, gridcomptype, igrid, &
config, configFile, clock, rc)
Interface Changes for Grid:
(new) newGrid=ESMF_GridCreateFromDistGrid(name,coordTypeKind,distgrid, &
distgridToGridMap, undistLBound, undistUBound, coordRank, coordDimMap, &
gridEdgeLWidth, gridEdgeUWidth, gridAlign, indexflag, rc)
(old) newGrid=ESMF_GridCreateFromDistGrid(name,coordTypeKind,distgrid, dimmap, &
lbounds, ubounds, coordRank, coordDimMap, indexflag, gridType, rc)
(new) newGrid=ESMF_GridCreateShapeTileIrreg(name,coordTypeKind, minIndex, &
countsPerDEDim1,countsPerDeDim2, countsPerDEDim3, &
connDim1, connDim2, connDim3, &
poleStaggerLoc1, poleStaggerLoc2, poleStaggerLoc3, &
bipolePos1, bipolePos2, bipolePos3, &
coordDep1, coordDep2, coordDep3, &
gridEdgeLWidth, gridEdgeUWidth, gridAlign, &
indexflag, distDim, petMap, rc)
(old) newGrid=ESMF_GridCreateShapeIrreg(name,coordTypeKind, minIndex, &
countsPerDEDim1,countsPerDeDim2, countsPerDEDim3, &
connDim1, connDim2, connDim3, &
poleStaggerLoc1, poleStaggerLoc2, poleStaggerLoc3, &
bipolePos1, bipolePos2, bipolePos3, &
coordDep1, coordDep2, coordDep3, &
indexflag, gridType, petMap, rc)
(new) ESMF_GridGet(grid, name, coordTypeKind, &
rank, distRank, undistRank, &
tileCount, staggerlocsCount, localDECount, distgrid, &
distgridToGridMap, undistLBound, undistUBound, coordRank, coordDimMap, &
gridEdgeLWidth, gridEdgeUWidth, gridAlign, &
indexFlag, rc)
(old) ESMF_GridGet(grid, name, coordTypeKind, rank, &
tileCount, distGrid, staggerLocsCount, &
dimmap, lbounds, ubounds, coordRank, coordDimMap, &
indexFlag, gridType, localDECount,distRank,undistRank, rc)
(new) ESMF_GridGetCoord(grid, localDE, coordDim, staggerloc, &
exclusiveLBound, exclusiveUBound, exclusiveCount, &
computationalLBound, computationalUBound, computationalCount, &
totalLBound, totalUBound, totalCount, &
, doCopy, rc)
(old) ESMF_GridGetLocalTileCoord(grid, localDE, staggerloc, coord, &
, doCopy, rc)
(new) ESMF_GridGetCoordIntoArray(grid, staggerloc,coordDim, array, docopy, rc)
(old) ESMF_GridGetCoordIntoArray(grid, staggerLoc,coord, array, docopy, rc)
(new) ESMF_GridSetFromDistGrid(grid, name, coordTypeKind, distgrid, &
distgridToGridMap, undistLBound, undistUBound, coordRank, coordDimMap, &
gridEdgeLWidth, gridEdgeUWidth, gridAlign, &
indexflag, rc)
(old) ESMF_GridSetFromDistGrid(grid,name,coordTypeKind,distgrid, &
dimmap, lbounds, ubounds, coordRank, coordDimMap, &
indexflag, gridType, rc)
(new) ESMF_GridSetCoordFromArray(grid, staggerloc, coordDim, array, doCopy, rc)
(old) ESMF_GridSetCoordFromArray(grid, staggerLoc, coord, array, doCopy, rc)
(new) ESMF_GridSetShapeTileIrreg(grid, name,coordTypeKind, minIndex, &
countsPerDEDim1,countsPerDeDim2, countsPerDEDim3, &
connDim1, connDim2, connDim3, &
poleStaggerLoc1, poleStaggerLoc2, poleStaggerLoc3, &
bipolePos1, bipolePos2, bipolePos3, &
coordDep1, coordDep2, coordDep3, &
gridEdgeLWidth, gridEdgeUWidth, gridAlign, &
indexflag, distDim, petMap, rc)
(old) ESMF_GridSetShapeIrreg(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(staggerloc,dim,loc,rc)
(old) ESMF_StaggerLocSetDim(staggerloc,dim,loc,rc)
New Interfaces for Array:
ESMF_ArrayRedistStore(srcArray, dstArray, routehandle, rc)
ESMF_ArrayRedist(srcArray, dstArray, routehandle, checkflag, &
rc)
ESMF_ArraySet(array, name, staggerLoc, vectorDim, &
computationalLWidth, computationalUWidth, rc)
ESMF_ArraySet(array, tensorIndex, staggerLoc, vectorDim, rc)
ESMF_ArrayGather(array, farray, patch, rootPet, vm, rc)
Interface Changes for Array:
(new) newArray=ESMF_ArrayCreate(farray, &
distgrid, distgridToArrayMap, computationalEdgeLWidth, &
computationalEdgeUWidth, computationalLWidth, &
computationalUWidth, totalLWidth, &
totalUWidth, indexflag, staggerLoc, vectorDim, &
undistLBound, undistUBound, name, rc)
(old) newArray=ESMF_ArrayCreate(farray, &
distgrid, dimmap, computationalLWidth, computationalUWidth, &
totalLWidth, totalUWidth, indexflag, staggerLoc, vectorDim, lbounds, &
ubounds, name, rc)
(new) newArray=ESMF_ArrayCreate(larrayList, distgrid, distgridToArrayMap, &
computationalEdgeLWidth, computationalEdgeUWidth, &
computationalLWidth, computationalUWidth, totalLWidth, totalUWidth, &
indexflag, staggerLoc, vectorDim, undistLBound, undistUBound, name, rc)
(old) newArray=ESMF_ArrayCreateLocalArray(larrayList, distgrid, dimmap,
computationalLWidth, computationalUWidth, totalLWidth, totalUWidth, &
indexflag, staggerLoc, vectorDim, lbounds, ubounds, name, rc)
(new) newArray=ESMF_ArrayCreate(arrayspec, distgrid, distgridToArrayMap, &
computationalEdgeLWidth, computationalEdgeUWidth, &
computationalLWidth, computationalUWidth, totalLWidth, totalUWidth, &
indexflag, staggerLoc, vectorDim, undistLBound, undistUBound, name, rc)
(old) newArray=ESMF_ArrayCreate(arrayspec, distgrid, dimmap, &
computationalLWidth, computationalUWidth, totalLWidth, totalUWidth, &
indexflag, staggerLoc, vectorDim, lbounds, ubounds, name, rc)
(new) ESMF_ArrayGet(array, typekind, rank, larrayList, &
indexflag, distgridToArrayMap, arrayToDistGridMap, undistLBound, &
undistUBound, 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, patchCount, minIndexPDimPPatch, &
maxIndexPDimPPatch, patchListPDe, indexCountPDimPDe, delayout, &
deCount, localDeCount, localDeList, rc)
New Interface for DistGrid:
ESMF_DistGridMatch(distgrid1, distgrid2, rc)
Interface Changes for DistGrid:
(new) ESMF_DistGridGet(distgrid, delayout, dimCount, patchCount, &
minIndexPDimPPatch, maxIndexPDimPPatch, elementCountPPatch, &
elementCountPDe, patchListPDe, indexCountPDimPDe, regDecompFlag, rc)
(old) ESMF_DistGridGet(distgrid, delayout, dimCount, patchCount, &
minIndexPDimPPatch, maxIndexPDimPPatch, cellCountPPatch, cellCountPDe, &
patchListPDe, indexCountPDimPDe, regDecompFlag, rc)