# Docs: Changes: 2.0.22

NEW FEATURES and CHANGES in PETSc 2.0.22

General:

- The Fortran90-specific routines such as VecGetArrayF90() now work with the IBM Fortran compiler, the SGI Fortran 90 compiler, and the Cray T3E Fortran compiler.
- The third argument for the Fortran versions of the routines VecGetArray()/VecRestoreArray(), ISGetIndices()/ISRestoreIndices(), MatGetArray()/MatRestoreArray() and DAGetGlobalIndices() has been changed from integer to PetscOffset. See src/snes/examples/tutorials/ex5f.F for example usage.
- Changed the location of the manual pages from docs/www/www.html and docs/www to docs/manualpages/manualpages.html and docs/manualpages.
- The location of the mpiuni include files (used in the base.site file when not compiling with an MPI) has moved from src/mpiuni to src/sys/src/mpiuni
- Added the option -log_summary_exclude <vec,mat,sles,snes> to limit the information printed in the summary table
- Added the option -log_info_exclude <vec,mat,sles,snes>
- Changed the calling sequences of PetscGetTime(), PetscGetCPUTime(), PetscGetFlops() to return error codes like all other PETSc functions.
- Changed the internal structure of the PETSc objects. This will not effect most users but makes PETSc more extensible for the future.
- Removed the PETSc object child support and replaced it with

> PetscObjectCompose(PetscObject,char *name,PetscObject);
> PetscObjectQuery(PetscObject,char *name,PetscObject *);
> PetscObjectComposeFunction(PetscObject,char *name, void *);
> PetscObjectQueryFunction(PetscObject,char *name,void **);

> These allow the user to attach objects and functions to any PETSc object.

- Added a feeble example that demonstrates how to manage partitioning a grid in parallel in src/mat/examples/tutorials/ex2.c
- The build command 'make all' in ${PETSC_DIR} will build the PETSc libraries, including the fortran interface.

AO (Application Orderings):

TS (Timestepping Solvers):

- The calling sequence of TSSetType() has changed; see the manual page.
- TSType is now a string, rather than enum type

SNES (Nonlinear Solvers):

- The calling sequence of SNESSetType() has changed; see the manual page.
- SNESType is now a string, rather than enum type

SLES (Linear Solvers):

- See PC and KSP

KSP (Krylov Subspace Methods):

- The calling sequence of KSPSetType() has changed; see the manual page.
- KSPType is now a string, rather than enum type.

PC (Preconditioners):

- Added two new PC classes, PCSLES and PCCOMPOSITE that allow use of any SLES object as a preconditioner and enable combining several preconditioners.
- The calling sequence of PCSetType() has changed; see the manual page.
- PCType is now a string, rather than enum type.

MAT (Matrices):

- Added support for partitioning using the ParMETIS parallel partitioning package, see the manual page for PartitioningCreate()
- Added MatGetColumnVector()
- Added argument column size to MatGetSubMatrix()
- Changed the memory allocation algorithm in MatLUFactorSymbolic() and MatILUFactorSymbolic() based on a suggestion by David Hysom of ODU.
- The third argument for the Fortran version of the routines MatGetArray()/MatRestoreArray() has been changed from integer to PetscOffset.

DA (Distributed Arrays):

- Changed DAGetDistributedVector() and DAGetLocalVector() to DACreateGlobalVector() and DACreateLocalVector(). You should destroy these vectors with a usual call to VecDestroy().
- The third argument for the Fortran version of the routine DAGetGlobalIndices() has been changed from integer to PetscOffset.

VEC (Vectors):

- Added VecSetBlockSize(), VecSetValuesBlocked(), VecSetValuesBlockedLocal(), VecSetLocalToGlobalMappingBlocked()
- Added VecCreatedShared(), which creates a parallel vector in shared memory on the SGI machines
- Changed VEC_IGNORE_OFF_PROCESSOR_ENTRIES to VEC_IGNORE_OFF_PROC_ENTRIES
- The third argument for the Fortran versions of the routines VecGetArray()/VecRestoreArray(), has been changed from integer to PetscOffset. See src/snes/examples/tutorials/ex5f.F for example usage.
- VecGetArray(), VecRestoreArray() now work from Fortran on all machines, finally after 3 long years!
- Changed the calling sequence of VecCreate(), now takes both local and global size, see the manual page.

IS (Index Sets):

- The third argument for the Fortran versions of the routines ISGetIndices()/ISRestoreIndices() has been changed from integer to PetscOffset.

Draw (Graphics):

Viewers:

System:

Error Handling:

Event Logging:

Fortran Interface:

- PETSC_NULL has been replaced with PETSC_NULL_INTEGER, PETSC_NULL_SCALAR, PETSC_NULL_DOUBLE or PETSC_NULL_CHARACTER depending on the context for usage. If the function expects an integer, a scalar (double or complex depending if you compile with BOPT=*_complex), a double precision array, or a string.
- The Fortran include files are now located in the directory "include/finclude/*.", rather than "include/FINCLUDE/*.h". The include files that used to be in "include/finclude/*.h (not recommended) are now in "include/foldinclude/*.h"
- If you have stored PETSc objects in Fortran integer arrays, such as user(3) = vec you have to declare those arrays to be of type PetscFortranAddr instead of as integer. Note that PetscFortranAddr is simply integer on 32 bit machines and integer*8 on 64 bit machines.
- The Fortran90-specific routines such as VecGetArrayF90() now work with the IBM Fortran compiler, the SGI Fortran 90 compiler, and the Cray T3E Fortran compiler.
- PETSc objects can now be passed between C and Fortran directly. You do not have to use the commands PetscCObjectToFortranObject() and PetscFortranObjectToCObject() to translate the objects between languages.
- Changed Fortran object argument from type int to type PetscFortranAddr in the routines PetscCObjectToFortranObject() and PetscFortranObjectToCObject().
- Added the routine PetscInitializeFortran() to assist in mixed-language use of PETSc. See the manual page for details.