!
!                Parallel Sparse BLAS  version 3.5
!      (C) Copyright 2006-2018
!        Salvatore Filippone
!        Alfredo Buttari
!
!    Redistribution and use in source and binary forms, with or without
!    modification, are permitted provided that the following conditions
!    are met:
!      1. Redistributions of source code must retain the above copyright
!         notice, this list of conditions and the following disclaimer.
!      2. Redistributions in binary form must reproduce the above copyright
!         notice, this list of conditions, and the following disclaimer in the
!         documentation and/or other materials provided with the distribution.
!      3. The name of the PSBLAS group or the names of its contributors may
!         not be used to endorse or promote products derived from this
!         software without specific written permission.
!
!    THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS
!    ``AS IS'' AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED
!    TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR
!    PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE PSBLAS GROUP OR ITS CONTRIBUTORS
!    BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
!    CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF
!    SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
!    INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN
!    CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)
!    ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
!    POSSIBILITY OF SUCH DAMAGE.
!
!
!
! package: psb_c_mat_mod
!
! This module contains the definition of the psb_c_sparse type which
! is a generic container for a sparse matrix and it is mostly meant to
! provide a mean of switching, at run-time, among different formats,
! potentially unknown at the library compile-time by adding a layer of
! indirection. This type encapsulates the psb_c_base_sparse_mat class
! inside another class which is the one visible to the user.
! Most methods of the psb_c_mat_mod simply call the methods of the
! encapsulated class.
! The exceptions are mainly cscnv and cp_from/cp_to; these provide
! the functionalities to have the encapsulated class change its
! type dynamically, and to extract/input an inner object.
!
! A sparse matrix has a state corresponding to its progression
! through the application life.
! In particular, computational methods can only be invoked when
! the matrix is in the ASSEMBLED state, whereas the other states are
! dedicated to operations on the internal matrix data.
! A sparse matrix can move between states according to the
! following state transition table. Associated with these states are
! the possible dynamic types of the inner matrix object.
! Only COO matrices can ever be in the BUILD state, whereas
! the ASSEMBLED and UPDATE state can be entered by any class.
!
! In           Out        Method
!| ----------------------------------
!| Null         Build      csall
!| Build        Build      csput
!| Build        Assembled  cscnv
!| Assembled    Assembled  cscnv
!| Assembled    Update     reinit
!| Update       Update     csput
!| Update       Assembled  cscnv
!| *            unchanged  reall
!| Assembled    Null       free
!
!
!
! We are also introducing the type psb_lcspmat_type.
! The basic difference with psb_cspmat_type is in the type
! of the indices, which are PSB_LPK_ so that the entries
! are guaranteed to be able to contain global indices.
! This type only supports data handling and preprocessing, it is
! not supposed to be used for computations.
!
module psb_c_mat_mod

  use psb_c_base_mat_mod
  use psb_c_csr_mat_mod,  only : psb_c_csr_sparse_mat, psb_lc_csr_sparse_mat
  use psb_c_csc_mat_mod,  only : psb_c_csc_sparse_mat, psb_lc_csc_sparse_mat

  type :: psb_cspmat_type

    class(psb_c_base_sparse_mat), allocatable  :: a   
    integer(psb_ipk_) :: remote_build=psb_matbld_noremote_
    type(psb_lc_coo_sparse_mat), allocatable  :: rmta

  contains
    ! Getters
    procedure, pass(a) :: get_nrows   => psb_c_get_nrows
    procedure, pass(a) :: get_ncols   => psb_c_get_ncols
    procedure, pass(a) :: get_nzeros  => psb_c_get_nzeros
    procedure, pass(a) :: get_nz_row  => psb_c_get_nz_row
    procedure, pass(a) :: get_size    => psb_c_get_size
    procedure, pass(a) :: get_dupl    => psb_c_get_dupl
    procedure, pass(a) :: is_null     => psb_c_is_null
    procedure, pass(a) :: is_bld      => psb_c_is_bld
    procedure, pass(a) :: is_upd      => psb_c_is_upd
    procedure, pass(a) :: is_asb      => psb_c_is_asb
    procedure, pass(a) :: is_sorted   => psb_c_is_sorted
    procedure, pass(a) :: is_by_rows  => psb_c_is_by_rows
    procedure, pass(a) :: is_by_cols  => psb_c_is_by_cols
    procedure, pass(a) :: is_upper    => psb_c_is_upper
    procedure, pass(a) :: is_lower    => psb_c_is_lower
    procedure, pass(a) :: is_triangle => psb_c_is_triangle
    procedure, pass(a) :: is_symmetric => psb_c_is_symmetric
    procedure, pass(a) :: is_unit     => psb_c_is_unit
    procedure, pass(a) :: is_repeatable_updates => psb_c_is_repeatable_updates
    procedure, pass(a) :: get_fmt     => psb_c_get_fmt
    procedure, pass(a) :: sizeof      => psb_c_sizeof
    procedure, pass(a) :: is_remote_build => psb_c_is_remote_build
    

    ! Setters
    procedure, pass(a) :: set_nrows    => psb_c_set_nrows
    procedure, pass(a) :: set_ncols    => psb_c_set_ncols
    procedure, pass(a) :: set_dupl     => psb_c_set_dupl
    procedure, pass(a) :: set_null     => psb_c_set_null
    procedure, pass(a) :: set_bld      => psb_c_set_bld
    procedure, pass(a) :: set_upd      => psb_c_set_upd
    procedure, pass(a) :: set_asb      => psb_c_set_asb
    procedure, pass(a) :: set_sorted   => psb_c_set_sorted
    procedure, pass(a) :: set_upper    => psb_c_set_upper
    procedure, pass(a) :: set_lower    => psb_c_set_lower
    procedure, pass(a) :: set_triangle => psb_c_set_triangle
    procedure, pass(a) :: set_symmetric => psb_c_set_symmetric
    procedure, pass(a) :: set_unit     => psb_c_set_unit
    procedure, pass(a) :: set_repeatable_updates => psb_c_set_repeatable_updates
    procedure, pass(a) :: set_remote_build => psb_c_set_remote_build

    ! Memory/data management
    procedure, pass(a) :: csall       => psb_c_csall
    generic, public    :: allocate    => csall
    procedure, pass(a) :: free        => psb_c_free
    procedure, pass(a) :: trim        => psb_c_trim
    procedure, pass(a) :: csput_a     => psb_c_csput_a
    procedure, pass(a) :: csput_v     => psb_c_csput_v
    generic, public    :: csput       => csput_a,  csput_v
    procedure, pass(a) :: csgetptn    => psb_c_csgetptn
    procedure, pass(a) :: csgetrow    => psb_c_csgetrow
    procedure, pass(a) :: csgetblk    => psb_c_csgetblk
    generic, public    :: csget       => csgetptn, csgetrow, csgetblk
#if defined(IPK4) && defined(LPK8)
    procedure, pass(a) :: lcsgetptn    => psb_c_lcsgetptn
    procedure, pass(a) :: lcsgetrow    => psb_c_lcsgetrow
    generic, public    :: csget        => lcsgetptn, lcsgetrow
#endif
    procedure, pass(a) :: tril        => psb_c_tril
    procedure, pass(a) :: triu        => psb_c_triu
    procedure, pass(a) :: m_csclip    => psb_c_csclip
    procedure, pass(a) :: m_csclip_ip => psb_c_csclip_ip
    procedure, pass(a) :: b_csclip    => psb_c_b_csclip
    generic, public    :: csclip      => b_csclip, m_csclip, m_csclip_ip
    procedure, pass(a) :: clean_zeros => psb_c_clean_zeros
    procedure, pass(a) :: reall       => psb_c_reallocate_nz
    procedure, pass(a) :: get_neigh   => psb_c_get_neigh
    procedure, pass(a) :: reinit      => psb_c_reinit
    procedure, pass(a) :: print_i     => psb_c_sparse_print
    procedure, pass(a) :: print_n     => psb_c_n_sparse_print
    generic, public    :: print       => print_i, print_n
    procedure, pass(a) :: mold        => psb_c_mold
    procedure, pass(a) :: asb         => psb_c_asb
    procedure, pass(a) :: transp_1mat => psb_c_transp_1mat
    procedure, pass(a) :: transp_2mat => psb_c_transp_2mat
    generic, public    :: transp      => transp_1mat, transp_2mat
    procedure, pass(a) :: transc_1mat => psb_c_transc_1mat
    procedure, pass(a) :: transc_2mat => psb_c_transc_2mat
    generic, public    :: transc      => transc_1mat, transc_2mat

    !
    ! Sync: centerpiece of handling of external storage.
    ! Any derived class having extra storage upon sync
    ! will guarantee that both fortran/host side and
    ! external side contain the same data. The base
    ! version is only a placeholder.
    !
    procedure, pass(a) :: sync        => c_mat_sync
    procedure, pass(a) :: is_host     => c_mat_is_host
    procedure, pass(a) :: is_dev      => c_mat_is_dev
    procedure, pass(a) :: is_sync     => c_mat_is_sync
    procedure, pass(a) :: set_host    => c_mat_set_host
    procedure, pass(a) :: set_dev     => c_mat_set_dev
    procedure, pass(a) :: set_sync    => c_mat_set_sync


    ! These are specific to this level of encapsulation.
    procedure, pass(a) :: mv_from_b   => psb_c_mv_from
    generic, public    :: mv_from     => mv_from_b
    procedure, pass(a) :: mv_to_b     => psb_c_mv_to
    generic, public    :: mv_to       => mv_to_b
    procedure, pass(a) :: cp_from_b   => psb_c_cp_from
    generic, public    :: cp_from     => cp_from_b
    procedure, pass(a) :: cp_to_b     => psb_c_cp_to
    generic, public    :: cp_to       => cp_to_b
    procedure, pass(a) :: clip_d_ip   => psb_c_clip_d_ip
    procedure, pass(a) :: clip_d      => psb_c_clip_d
    generic, public    :: clip_diag   => clip_d_ip, clip_d
    procedure, pass(a) :: cscnv_np    => psb_c_cscnv
    procedure, pass(a) :: cscnv_ip    => psb_c_cscnv_ip
    procedure, pass(a) :: cscnv_base  => psb_c_cscnv_base
    generic, public    :: cscnv       => cscnv_np, cscnv_ip, cscnv_base
    procedure, pass(a) :: clone       => psb_cspmat_clone
    procedure, pass(a) :: move_alloc  => psb_cspmat_type_move
    !
    ! To/from lc
    !
    procedure, pass(a) :: mv_from_lb  => psb_c_mv_from_lb
    procedure, pass(a) :: mv_to_lb    => psb_c_mv_to_lb
    procedure, pass(a) :: cp_from_lb  => psb_c_cp_from_lb
    procedure, pass(a) :: cp_to_lb    => psb_c_cp_to_lb
    procedure, pass(a) :: mv_from_l   => psb_c_mv_from_l
    procedure, pass(a) :: mv_to_l     => psb_c_mv_to_l
    procedure, pass(a) :: cp_from_l   => psb_c_cp_from_l
    procedure, pass(a) :: cp_to_l     => psb_c_cp_to_l
    generic, public    :: mv_from     => mv_from_lb, mv_from_l
    generic, public    :: mv_to       => mv_to_lb, mv_to_l
    generic, public    :: cp_from     => cp_from_lb, cp_from_l
    generic, public    :: cp_to       => cp_to_lb, cp_to_l

    ! Computational routines
    procedure, pass(a) :: get_diag => psb_c_get_diag
    procedure, pass(a) :: maxval   => psb_c_maxval
    procedure, pass(a) :: spnmi    => psb_c_csnmi
    procedure, pass(a) :: spnm1    => psb_c_csnm1
    procedure, pass(a) :: rowsum   => psb_c_rowsum
    procedure, pass(a) :: arwsum   => psb_c_arwsum
    procedure, pass(a) :: colsum   => psb_c_colsum
    procedure, pass(a) :: aclsum   => psb_c_aclsum
    procedure, pass(a) :: csmv_v   => psb_c_csmv_vect
    procedure, pass(a) :: csmv     => psb_c_csmv
    procedure, pass(a) :: csmm     => psb_c_csmm
    generic, public    :: spmm     => csmm, csmv, csmv_v
    procedure, pass(a) :: scals    => psb_c_scals
    procedure, pass(a) :: scalv    => psb_c_scal
    generic, public    :: scal     => scals, scalv
    procedure, pass(a) :: cssv_v   => psb_c_cssv_vect
    procedure, pass(a) :: cssv     => psb_c_cssv
    procedure, pass(a) :: cssm     => psb_c_cssm
    generic, public    :: spsm     => cssm, cssv, cssv_v
    procedure, pass(a) :: scalpid  => psb_c_scalplusidentity
    procedure, pass(a) :: spaxpby  => psb_c_spaxpby
    procedure, pass(a) :: cmpval   => psb_c_cmpval
    procedure, pass(a) :: cmpmat   => psb_c_cmpmat
    generic, public    :: spcmp    => cmpval, cmpmat

  end type psb_cspmat_type

  private :: psb_c_get_nrows, psb_c_get_ncols, &
       & psb_c_get_nzeros, psb_c_get_size, &
       & psb_c_get_dupl, psb_c_is_null, psb_c_is_bld, &
       & psb_c_is_upd, psb_c_is_asb, psb_c_is_sorted, &
       & psb_c_is_by_rows, psb_c_is_by_cols, psb_c_is_upper, &
       & psb_c_is_lower, psb_c_is_triangle, psb_c_get_nz_row, &
       & c_mat_sync, c_mat_is_host, c_mat_is_dev, &
       & c_mat_is_sync, c_mat_set_host, c_mat_set_dev,&
       & c_mat_set_sync



  class(psb_c_base_sparse_mat), allocatable, target, &
       & save, private :: psb_c_base_mat_default

  interface psb_set_mat_default
    module procedure psb_c_set_mat_default
  end interface

  interface psb_get_mat_default
    module procedure psb_c_get_mat_default
  end interface

  interface psb_sizeof
    module procedure psb_c_sizeof
  end interface


  type :: psb_lcspmat_type

    class(psb_lc_base_sparse_mat), allocatable  :: a

  contains
    ! Getters
    procedure, pass(a) :: get_nrows   => psb_lc_get_nrows
    procedure, pass(a) :: get_ncols   => psb_lc_get_ncols
    procedure, pass(a) :: get_nzeros  => psb_lc_get_nzeros
    procedure, pass(a) :: get_nz_row  => psb_lc_get_nz_row
    procedure, pass(a) :: get_size    => psb_lc_get_size
    procedure, pass(a) :: get_dupl    => psb_lc_get_dupl
    procedure, pass(a) :: is_null     => psb_lc_is_null
    procedure, pass(a) :: is_bld      => psb_lc_is_bld
    procedure, pass(a) :: is_upd      => psb_lc_is_upd
    procedure, pass(a) :: is_asb      => psb_lc_is_asb
    procedure, pass(a) :: is_sorted   => psb_lc_is_sorted
    procedure, pass(a) :: is_by_rows  => psb_lc_is_by_rows
    procedure, pass(a) :: is_by_cols  => psb_lc_is_by_cols
    procedure, pass(a) :: is_upper    => psb_lc_is_upper
    procedure, pass(a) :: is_lower    => psb_lc_is_lower
    procedure, pass(a) :: is_triangle => psb_lc_is_triangle
    procedure, pass(a) :: is_symmetric => psb_lc_is_symmetric
    procedure, pass(a) :: is_unit     => psb_lc_is_unit
    procedure, pass(a) :: is_repeatable_updates => psb_lc_is_repeatable_updates
    procedure, pass(a) :: get_fmt     => psb_lc_get_fmt
    procedure, pass(a) :: sizeof      => psb_lc_sizeof

    ! Setters
    procedure, pass(a) :: set_lnrows   => psb_lc_set_lnrows
    procedure, pass(a) :: set_lncols   => psb_lc_set_lncols
#if defined(IPK4) && defined(LPK8)
    procedure, pass(a) :: set_inrows   => psb_lc_set_inrows
    procedure, pass(a) :: set_incols   => psb_lc_set_incols
    generic, public    :: set_nrows   => set_inrows, set_lnrows
    generic, public    :: set_ncols   => set_incols, set_lncols
#else
    generic, public    :: set_nrows   => set_lnrows
    generic, public    :: set_ncols   => set_lncols
#endif

    procedure, pass(a) :: set_dupl     => psb_lc_set_dupl
    procedure, pass(a) :: set_null     => psb_lc_set_null
    procedure, pass(a) :: set_bld      => psb_lc_set_bld
    procedure, pass(a) :: set_upd      => psb_lc_set_upd
    procedure, pass(a) :: set_asb      => psb_lc_set_asb
    procedure, pass(a) :: set_sorted   => psb_lc_set_sorted
    procedure, pass(a) :: set_upper    => psb_lc_set_upper
    procedure, pass(a) :: set_lower    => psb_lc_set_lower
    procedure, pass(a) :: set_triangle => psb_lc_set_triangle
    procedure, pass(a) :: set_symmetric => psb_lc_set_symmetric
    procedure, pass(a) :: set_unit     => psb_lc_set_unit
    procedure, pass(a) :: set_repeatable_updates => psb_lc_set_repeatable_updates

    ! Memory/data management
    procedure, pass(a) :: csall       => psb_lc_csall
    generic, public    :: allocate    => csall
    procedure, pass(a) :: free        => psb_lc_free
    procedure, pass(a) :: trim        => psb_lc_trim
    procedure, pass(a) :: csput_a     => psb_lc_csput_a
    procedure, pass(a) :: csput_v     => psb_lc_csput_v
    generic, public    :: csput       => csput_a,  csput_v
    procedure, pass(a) :: csgetptn    => psb_lc_csgetptn
    procedure, pass(a) :: csgetrow    => psb_lc_csgetrow
    procedure, pass(a) :: csgetblk    => psb_lc_csgetblk
    generic, public    :: csget       => csgetptn, csgetrow, csgetblk
#if defined(IPK4) && defined(LPK8)
!!$    procedure, pass(a) :: icsgetptn    => psb_lc_icsgetptn
!!$    procedure, pass(a) :: icsgetrow    => psb_lc_icsgetrow
!!$    generic, public    :: csget        => icsgetptn, icsgetrow
#endif
    procedure, pass(a) :: tril        => psb_lc_tril
    procedure, pass(a) :: triu        => psb_lc_triu
    procedure, pass(a) :: m_csclip    => psb_lc_csclip
    procedure, pass(a) :: m_csclip_ip => psb_lc_csclip_ip
    procedure, pass(a) :: b_csclip    => psb_lc_b_csclip
    generic, public    :: csclip      => b_csclip, m_csclip, m_csclip_ip
    procedure, pass(a) :: clean_zeros => psb_lc_clean_zeros
    procedure, pass(a) :: reall       => psb_lc_reallocate_nz
    procedure, pass(a) :: get_neigh   => psb_lc_get_neigh
    procedure, pass(a) :: reinit      => psb_lc_reinit
    procedure, pass(a) :: print_i     => psb_lc_sparse_print
    procedure, pass(a) :: print_n     => psb_lc_n_sparse_print
    generic, public    :: print       => print_i, print_n
    procedure, pass(a) :: mold        => psb_lc_mold
    procedure, pass(a) :: asb         => psb_lc_asb
    procedure, pass(a) :: transp_1mat => psb_lc_transp_1mat
    procedure, pass(a) :: transp_2mat => psb_lc_transp_2mat
    generic, public    :: transp      => transp_1mat, transp_2mat
    procedure, pass(a) :: transc_1mat => psb_lc_transc_1mat
    procedure, pass(a) :: transc_2mat => psb_lc_transc_2mat
    generic, public    :: transc      => transc_1mat, transc_2mat

    !
    ! Sync: centerpiece of handling of external storage.
    ! Any derived class having extra storage upon sync
    ! will guarantee that both fortran/host side and
    ! external side contain the same data. The base
    ! version is only a placeholder.
    !
    procedure, pass(a) :: sync        => lc_mat_sync
    procedure, pass(a) :: is_host     => lc_mat_is_host
    procedure, pass(a) :: is_dev      => lc_mat_is_dev
    procedure, pass(a) :: is_sync     => lc_mat_is_sync
    procedure, pass(a) :: set_host    => lc_mat_set_host
    procedure, pass(a) :: set_dev     => lc_mat_set_dev
    procedure, pass(a) :: set_sync    => lc_mat_set_sync


    ! These are specific to this level of encapsulation.
    procedure, pass(a) :: mv_from_b   => psb_lc_mv_from
    generic, public    :: mv_from     => mv_from_b
    procedure, pass(a) :: mv_to_b     => psb_lc_mv_to
    generic, public    :: mv_to       => mv_to_b
    procedure, pass(a) :: cp_from_b   => psb_lc_cp_from
    generic, public    :: cp_from     => cp_from_b
    procedure, pass(a) :: cp_to_b     => psb_lc_cp_to
    generic, public    :: cp_to       => cp_to_b
    procedure, pass(a) :: clip_d_ip   => psb_lc_clip_d_ip
    procedure, pass(a) :: clip_d      => psb_lc_clip_d
    generic, public    :: clip_diag   => clip_d_ip, clip_d
    procedure, pass(a) :: cscnv_np    => psb_lc_cscnv
    procedure, pass(a) :: cscnv_ip    => psb_lc_cscnv_ip
    procedure, pass(a) :: cscnv_base  => psb_lc_cscnv_base
    generic, public    :: cscnv       => cscnv_np, cscnv_ip, cscnv_base
    procedure, pass(a) :: clone       => psb_lcspmat_clone
    procedure, pass(a) :: move_alloc  => psb_lcspmat_type_move
    !
    ! To/from c
    !
    procedure, pass(a) :: mv_from_ib  => psb_lc_mv_from_ib
    procedure, pass(a) :: mv_to_ib    => psb_lc_mv_to_ib
    procedure, pass(a) :: cp_from_ib  => psb_lc_cp_from_ib
    procedure, pass(a) :: cp_to_ib    => psb_lc_cp_to_ib
    procedure, pass(a) :: mv_from_i   => psb_lc_mv_from_i
    procedure, pass(a) :: mv_to_i     => psb_lc_mv_to_i
    procedure, pass(a) :: cp_from_i   => psb_lc_cp_from_i
    procedure, pass(a) :: cp_to_i     => psb_lc_cp_to_i
    generic, public    :: mv_from     => mv_from_ib, mv_from_i
    generic, public    :: mv_to       => mv_to_ib, mv_to_i
    generic, public    :: cp_from     => cp_from_ib, cp_from_i
    generic, public    :: cp_to       => cp_to_ib, cp_to_i

    ! Computational routines
    procedure, pass(a) :: get_diag => psb_lc_get_diag
    procedure, pass(a) :: maxval   => psb_lc_maxval
    procedure, pass(a) :: spnmi    => psb_lc_csnmi
    procedure, pass(a) :: spnm1    => psb_lc_csnm1
    procedure, pass(a) :: rowsum   => psb_lc_rowsum
    procedure, pass(a) :: arwsum   => psb_lc_arwsum
    procedure, pass(a) :: colsum   => psb_lc_colsum
    procedure, pass(a) :: aclsum   => psb_lc_aclsum
    procedure, pass(a) :: scals    => psb_lc_scals
    procedure, pass(a) :: scalv    => psb_lc_scal
    generic, public    :: scal     => scals, scalv
    procedure, pass(a) :: scalpid  => psb_lc_scalplusidentity
    procedure, pass(a) :: spaxpby  => psb_lc_spaxpby
    procedure, pass(a) :: cmpval   => psb_lc_cmpval
    procedure, pass(a) :: cmpmat   => psb_lc_cmpmat
    generic, public    :: spcmp    => cmpval, cmpmat

  end type psb_lcspmat_type

  private :: psb_lc_get_nrows, psb_lc_get_ncols, &
       & psb_lc_get_nzeros, psb_lc_get_size, &
       & psb_lc_get_dupl, psb_lc_is_null, psb_lc_is_bld, &
       & psb_lc_is_upd, psb_lc_is_asb, psb_lc_is_sorted, &
       & psb_lc_is_by_rows, psb_lc_is_by_cols, psb_lc_is_upper, &
       & psb_lc_is_lower, psb_lc_is_triangle, psb_lc_get_nz_row, &
       & lc_mat_sync, lc_mat_is_host, lc_mat_is_dev, &
       & lc_mat_is_sync, lc_mat_set_host, lc_mat_set_dev,&
       & lc_mat_set_sync



  class(psb_lc_base_sparse_mat), allocatable, target, &
       & save, private :: psb_lc_base_mat_default

  interface psb_set_mat_default
    module procedure psb_lc_set_mat_default
  end interface

  interface psb_get_mat_default
    module procedure psb_lc_get_mat_default
  end interface

  ! == ===================================
  !
  !
  !
  ! Setters
  !
  !
  !
  !
  !
  !
  ! == ===================================


  interface
    subroutine  psb_c_set_nrows(m,a)
      import :: psb_ipk_, psb_cspmat_type
      class(psb_cspmat_type), intent(inout) :: a
      integer(psb_ipk_), intent(in) :: m
    end subroutine psb_c_set_nrows
  end interface

  interface
    subroutine psb_c_set_ncols(n,a)
      import :: psb_ipk_, psb_cspmat_type
      class(psb_cspmat_type), intent(inout) :: a
      integer(psb_ipk_), intent(in) :: n
    end subroutine psb_c_set_ncols
  end interface

  interface
    subroutine  psb_c_set_dupl(n,a)
      import :: psb_ipk_, psb_lpk_, psb_cspmat_type
      class(psb_cspmat_type), intent(inout) :: a
      integer(psb_ipk_), intent(in) :: n
    end subroutine psb_c_set_dupl
  end interface

  interface
    subroutine psb_c_set_null(a)
      import :: psb_ipk_, psb_lpk_, psb_cspmat_type
      class(psb_cspmat_type), intent(inout) :: a
    end subroutine psb_c_set_null
  end interface

  interface
    subroutine psb_c_set_bld(a)
      import :: psb_ipk_, psb_lpk_, psb_cspmat_type
      class(psb_cspmat_type), intent(inout) :: a
    end subroutine psb_c_set_bld
  end interface

  interface
    subroutine psb_c_set_upd(a)
      import :: psb_ipk_, psb_lpk_, psb_cspmat_type
      class(psb_cspmat_type), intent(inout) :: a
    end subroutine psb_c_set_upd
  end interface

  interface
    subroutine psb_c_set_asb(a)
      import :: psb_ipk_, psb_lpk_, psb_cspmat_type
      class(psb_cspmat_type), intent(inout) :: a
    end subroutine psb_c_set_asb
  end interface

  interface
    subroutine psb_c_set_sorted(a,val)
      import :: psb_ipk_, psb_lpk_, psb_cspmat_type
      class(psb_cspmat_type), intent(inout) :: a
      logical, intent(in), optional :: val
    end subroutine psb_c_set_sorted
  end interface

  interface
    subroutine psb_c_set_triangle(a,val)
      import :: psb_ipk_, psb_lpk_, psb_cspmat_type
      class(psb_cspmat_type), intent(inout) :: a
      logical, intent(in), optional :: val
    end subroutine psb_c_set_triangle
  end interface

  interface
    subroutine psb_c_set_symmetric(a,val)
      import :: psb_ipk_, psb_cspmat_type
      class(psb_cspmat_type), intent(inout) :: a
      logical, intent(in), optional :: val
    end subroutine psb_c_set_symmetric
  end interface

  interface
    subroutine psb_c_set_unit(a,val)
      import :: psb_ipk_, psb_lpk_, psb_cspmat_type
      class(psb_cspmat_type), intent(inout) :: a
      logical, intent(in), optional :: val
    end subroutine psb_c_set_unit
  end interface

  interface
    subroutine psb_c_set_lower(a,val)
      import :: psb_ipk_, psb_lpk_, psb_cspmat_type
      class(psb_cspmat_type), intent(inout) :: a
      logical, intent(in), optional :: val
    end subroutine psb_c_set_lower
  end interface

  interface
    subroutine psb_c_set_upper(a,val)
      import :: psb_ipk_, psb_lpk_, psb_cspmat_type
      class(psb_cspmat_type), intent(inout) :: a
      logical, intent(in), optional :: val
    end subroutine psb_c_set_upper
  end interface

  interface
    subroutine psb_c_sparse_print(iout,a,iv,head,ivr,ivc)
      import :: psb_ipk_, psb_lpk_, psb_cspmat_type
      integer(psb_ipk_), intent(in)               :: iout
      class(psb_cspmat_type), intent(in) :: a
      integer(psb_lpk_), intent(in), optional     :: iv(:)
      character(len=*), optional        :: head
      integer(psb_lpk_), intent(in), optional     :: ivr(:), ivc(:)
    end subroutine psb_c_sparse_print
  end interface

  interface
    subroutine psb_c_n_sparse_print(fname,a,iv,head,ivr,ivc)
      import :: psb_ipk_, psb_lpk_, psb_cspmat_type
      character(len=*), intent(in)      :: fname
      class(psb_cspmat_type), intent(in) :: a
      integer(psb_lpk_), intent(in), optional     :: iv(:)
      character(len=*), optional        :: head
      integer(psb_lpk_), intent(in), optional     :: ivr(:), ivc(:)
    end subroutine psb_c_n_sparse_print
  end interface

  interface
    subroutine psb_c_get_neigh(a,idx,neigh,n,info,lev)
      import :: psb_ipk_, psb_lpk_, psb_cspmat_type
      class(psb_cspmat_type), intent(in) :: a
      integer(psb_ipk_), intent(in)                :: idx
      integer(psb_ipk_), intent(out)               :: n
      integer(psb_ipk_), allocatable, intent(out)  :: neigh(:)
      integer(psb_ipk_), intent(out)               :: info
      integer(psb_ipk_), optional, intent(in)      :: lev
    end subroutine psb_c_get_neigh
  end interface

  interface
    subroutine psb_c_csall(nr,nc,a,info,nz,type,mold)
      import :: psb_ipk_, psb_lpk_, psb_cspmat_type, psb_c_base_sparse_mat
      class(psb_cspmat_type), intent(inout) :: a
      integer(psb_ipk_), intent(in)             :: nr,nc
      integer(psb_ipk_), intent(out)            :: info
      integer(psb_ipk_), intent(in), optional   :: nz
      character(len=*), intent(in), optional    :: type
      class(psb_c_base_sparse_mat), optional, intent(in) :: mold
    end subroutine psb_c_csall
  end interface

  interface
    subroutine psb_c_reallocate_nz(nz,a)
      import :: psb_ipk_, psb_lpk_, psb_cspmat_type
      integer(psb_ipk_), intent(in) :: nz
      class(psb_cspmat_type), intent(inout) :: a
    end subroutine psb_c_reallocate_nz
  end interface

  interface
    subroutine psb_c_free(a)
      import :: psb_ipk_, psb_lpk_, psb_cspmat_type
      class(psb_cspmat_type), intent(inout) :: a
    end subroutine psb_c_free
  end interface

  interface
    subroutine psb_c_trim(a)
      import :: psb_ipk_, psb_lpk_, psb_cspmat_type
      class(psb_cspmat_type), intent(inout) :: a
    end subroutine psb_c_trim
  end interface

  interface
    subroutine psb_c_csput_a(nz,ia,ja,val,a,imin,imax,jmin,jmax,info)
      import :: psb_ipk_, psb_lpk_, psb_cspmat_type, psb_spk_
      class(psb_cspmat_type), intent(inout) :: a
      complex(psb_spk_), intent(in)      :: val(:)
      integer(psb_ipk_), intent(in)             :: nz, ia(:), ja(:), imin,imax,jmin,jmax
      integer(psb_ipk_), intent(out)            :: info
    end subroutine psb_c_csput_a
  end interface


  interface
    subroutine psb_c_csput_v(nz,ia,ja,val,a,imin,imax,jmin,jmax,info)
      use psb_c_vect_mod, only : psb_c_vect_type
      use psb_i_vect_mod, only : psb_i_vect_type
      import :: psb_ipk_, psb_lpk_, psb_cspmat_type
      class(psb_cspmat_type), intent(inout) :: a
      type(psb_c_vect_type), intent(inout)  :: val
      type(psb_i_vect_type), intent(inout)  :: ia, ja
      integer(psb_ipk_), intent(in)             :: nz, imin,imax,jmin,jmax
      integer(psb_ipk_), intent(out)            :: info
    end subroutine psb_c_csput_v
  end interface

  interface
    subroutine psb_c_csgetptn(imin,imax,a,nz,ia,ja,info,&
       & jmin,jmax,iren,append,nzin,rscale,cscale)
      import :: psb_ipk_, psb_lpk_, psb_cspmat_type, psb_spk_
      class(psb_cspmat_type), intent(in) :: a
      integer(psb_ipk_), intent(in)                  :: imin,imax
      integer(psb_ipk_), intent(out)                 :: nz
      integer(psb_ipk_), allocatable, intent(inout)  :: ia(:), ja(:)
      integer(psb_ipk_),intent(out)                  :: info
      logical, intent(in), optional        :: append
      integer(psb_ipk_), intent(in), optional        :: iren(:)
      integer(psb_ipk_), intent(in), optional        :: jmin,jmax, nzin
      logical, intent(in), optional        :: rscale,cscale
    end subroutine psb_c_csgetptn
  end interface

  interface
    subroutine psb_c_csgetrow(imin,imax,a,nz,ia,ja,val,info,&
         & jmin,jmax,iren,append,nzin,rscale,cscale,chksz)
      import :: psb_ipk_, psb_lpk_, psb_cspmat_type, psb_spk_
      class(psb_cspmat_type), intent(in) :: a
      integer(psb_ipk_), intent(in)                  :: imin,imax
      integer(psb_ipk_), intent(out)                 :: nz
      integer(psb_ipk_), allocatable, intent(inout)  :: ia(:), ja(:)
      complex(psb_spk_), allocatable,  intent(inout)    :: val(:)
      integer(psb_ipk_),intent(out)                  :: info
      logical, intent(in), optional        :: append
      integer(psb_ipk_), intent(in), optional        :: iren(:)
      integer(psb_ipk_), intent(in), optional        :: jmin,jmax, nzin
      logical, intent(in), optional        :: rscale,cscale,chksz
    end subroutine psb_c_csgetrow
  end interface

  interface
    subroutine psb_c_csgetblk(imin,imax,a,b,info,&
       & jmin,jmax,iren,append,rscale,cscale)
      import :: psb_ipk_, psb_lpk_, psb_cspmat_type, psb_spk_
      class(psb_cspmat_type), intent(in)    :: a
      class(psb_cspmat_type), intent(inout) :: b
      integer(psb_ipk_), intent(in)                  :: imin,imax
      integer(psb_ipk_),intent(out)                  :: info
      logical, intent(in), optional        :: append
      integer(psb_ipk_), intent(in), optional        :: iren(:)
      integer(psb_ipk_), intent(in), optional        :: jmin,jmax
      logical, intent(in), optional        :: rscale,cscale
    end subroutine psb_c_csgetblk
  end interface

  interface
    subroutine psb_c_tril(a,l,info,diag,imin,imax,&
         & jmin,jmax,rscale,cscale,u)
      import :: psb_ipk_, psb_lpk_, psb_cspmat_type, psb_spk_
      class(psb_cspmat_type), intent(in)      :: a
      class(psb_cspmat_type), intent(inout)   :: l
      integer(psb_ipk_),intent(out)           :: info
      integer(psb_ipk_), intent(in), optional :: diag,imin,imax,jmin,jmax
      logical, intent(in), optional           :: rscale,cscale
      class(psb_cspmat_type), optional, intent(inout)   :: u
    end subroutine psb_c_tril
  end interface

  interface
    subroutine psb_c_triu(a,u,info,diag,imin,imax,&
         & jmin,jmax,rscale,cscale,l)
      import :: psb_ipk_, psb_lpk_, psb_cspmat_type, psb_spk_
      class(psb_cspmat_type), intent(in)      :: a
      class(psb_cspmat_type), intent(inout)   :: u
      integer(psb_ipk_),intent(out)           :: info
      integer(psb_ipk_), intent(in), optional :: diag,imin,imax,jmin,jmax
      logical, intent(in), optional           :: rscale,cscale
      class(psb_cspmat_type), optional, intent(inout)   :: l
    end subroutine psb_c_triu
  end interface


  interface
    subroutine psb_c_csclip(a,b,info,&
       & imin,imax,jmin,jmax,rscale,cscale)
      import :: psb_ipk_, psb_lpk_, psb_cspmat_type, psb_spk_
      class(psb_cspmat_type), intent(in) :: a
      class(psb_cspmat_type), intent(inout) :: b
      integer(psb_ipk_),intent(out)                  :: info
      integer(psb_ipk_), intent(in), optional        :: imin,imax,jmin,jmax
      logical, intent(in), optional        :: rscale,cscale
    end subroutine psb_c_csclip
  end interface

  interface
    subroutine psb_c_csclip_ip(a,info,&
       & imin,imax,jmin,jmax,rscale,cscale)
      import :: psb_ipk_, psb_lpk_, psb_cspmat_type, psb_spk_
      class(psb_cspmat_type), intent(inout) :: a
      integer(psb_ipk_),intent(out)                  :: info
      integer(psb_ipk_), intent(in), optional        :: imin,imax,jmin,jmax
      logical, intent(in), optional        :: rscale,cscale
    end subroutine psb_c_csclip_ip
  end interface

  interface
    subroutine psb_c_b_csclip(a,b,info,&
       & imin,imax,jmin,jmax,rscale,cscale)
      import :: psb_ipk_, psb_lpk_, psb_cspmat_type, psb_spk_, psb_c_coo_sparse_mat
      class(psb_cspmat_type), intent(in) :: a
      type(psb_c_coo_sparse_mat), intent(out) :: b
      integer(psb_ipk_),intent(out)                  :: info
      integer(psb_ipk_), intent(in), optional        :: imin,imax,jmin,jmax
      logical, intent(in), optional        :: rscale,cscale
    end subroutine psb_c_b_csclip
  end interface

  interface
    subroutine psb_c_mold(a,b)
      import :: psb_ipk_, psb_lpk_, psb_cspmat_type, psb_c_base_sparse_mat
      class(psb_cspmat_type), intent(inout)     :: a
      class(psb_c_base_sparse_mat), allocatable, intent(out) :: b
    end subroutine psb_c_mold
  end interface

  interface
    subroutine psb_c_asb(a,mold)
      import :: psb_ipk_, psb_lpk_, psb_cspmat_type, psb_c_base_sparse_mat
      class(psb_cspmat_type), intent(inout) :: a
      class(psb_c_base_sparse_mat), optional, intent(in) :: mold
    end subroutine psb_c_asb
  end interface

  interface
    subroutine psb_c_transp_1mat(a)
      import :: psb_ipk_, psb_lpk_, psb_cspmat_type
      class(psb_cspmat_type), intent(inout) :: a
    end subroutine psb_c_transp_1mat
  end interface

  interface
    subroutine psb_c_transp_2mat(a,b)
      import :: psb_ipk_, psb_lpk_, psb_cspmat_type
      class(psb_cspmat_type), intent(in)  :: a
      class(psb_cspmat_type), intent(inout) :: b
    end subroutine psb_c_transp_2mat
  end interface

  interface
    subroutine psb_c_transc_1mat(a)
      import :: psb_ipk_, psb_lpk_, psb_cspmat_type
      class(psb_cspmat_type), intent(inout) :: a
    end subroutine psb_c_transc_1mat
  end interface

  interface
    subroutine psb_c_transc_2mat(a,b)
      import :: psb_ipk_, psb_lpk_, psb_cspmat_type
      class(psb_cspmat_type), intent(in)  :: a
      class(psb_cspmat_type), intent(inout) :: b
    end subroutine psb_c_transc_2mat
  end interface

  interface
    subroutine psb_c_reinit(a,clear)
      import :: psb_ipk_, psb_lpk_, psb_cspmat_type
      class(psb_cspmat_type), intent(inout) :: a
      logical, intent(in), optional :: clear
    end subroutine psb_c_reinit

  end interface


  !
  ! These methods are specific to the outer SPMAT_TYPE level, since
  ! they tamper with the inner BASE_SPARSE_MAT object.
  !
  !

  !
  ! CSCNV: switches to a different internal derived type.
  !   3 versions: copying to target
  !               copying to a base_sparse_mat object.
  !               in place
  !
  !
  interface
    subroutine psb_c_cscnv(a,b,info,type,mold,upd,dupl)
      import :: psb_ipk_, psb_lpk_, psb_cspmat_type, psb_spk_, psb_c_base_sparse_mat
      class(psb_cspmat_type), intent(in)      :: a
      class(psb_cspmat_type), intent(inout)   :: b
      integer(psb_ipk_), intent(out)                   :: info
      integer(psb_ipk_),optional, intent(in)           :: dupl, upd
      character(len=*), optional, intent(in) :: type
      class(psb_c_base_sparse_mat), intent(in), optional :: mold
    end subroutine psb_c_cscnv
  end interface


  interface
    subroutine psb_c_cscnv_ip(a,iinfo,type,mold,dupl)
      import :: psb_ipk_, psb_lpk_, psb_cspmat_type, psb_spk_, psb_c_base_sparse_mat
      class(psb_cspmat_type), intent(inout) :: a
      integer(psb_ipk_), intent(out)                   :: iinfo
      integer(psb_ipk_),optional, intent(in)           :: dupl
      character(len=*), optional, intent(in) :: type
      class(psb_c_base_sparse_mat), intent(in), optional :: mold
    end subroutine psb_c_cscnv_ip
  end interface


  interface
    subroutine psb_c_cscnv_base(a,b,info,dupl)
      import :: psb_ipk_, psb_lpk_, psb_cspmat_type, psb_spk_, psb_c_base_sparse_mat
      class(psb_cspmat_type), intent(in)       :: a
      class(psb_c_base_sparse_mat), intent(out) :: b
      integer(psb_ipk_), intent(out)                   :: info
      integer(psb_ipk_),optional, intent(in)           :: dupl
    end subroutine psb_c_cscnv_base
  end interface

  !
  ! Produce a version of the matrix with diagonal cut
  ! out; passes through a COO buffer.
  !
  interface
    subroutine psb_c_clip_d(a,b,info)
      import :: psb_ipk_, psb_lpk_, psb_cspmat_type
      class(psb_cspmat_type), intent(in)    :: a
      class(psb_cspmat_type), intent(inout) :: b
      integer(psb_ipk_),intent(out)                  :: info
    end subroutine psb_c_clip_d
  end interface

  interface
    subroutine psb_c_clip_d_ip(a,info)
      import :: psb_ipk_, psb_lpk_, psb_cspmat_type
      class(psb_cspmat_type), intent(inout) :: a
      integer(psb_ipk_),intent(out)                  :: info
    end subroutine psb_c_clip_d_ip
  end interface

  !
  ! These four interfaces cut through the
  ! encapsulation between spmat_type and base_sparse_mat.
  !
  interface
    subroutine psb_c_mv_from(a,b)
      import :: psb_ipk_, psb_lpk_, psb_cspmat_type, psb_spk_, psb_c_base_sparse_mat
      class(psb_cspmat_type), intent(inout) :: a
      class(psb_c_base_sparse_mat), intent(inout) :: b
    end subroutine psb_c_mv_from
  end interface

  interface
    subroutine psb_c_cp_from(a,b)
      import :: psb_ipk_, psb_lpk_, psb_cspmat_type, psb_spk_, psb_c_base_sparse_mat
      class(psb_cspmat_type), intent(out) :: a
      class(psb_c_base_sparse_mat), intent(in) :: b
    end subroutine psb_c_cp_from
  end interface

  interface
    subroutine psb_c_mv_to(a,b)
      import :: psb_ipk_, psb_lpk_, psb_cspmat_type, psb_spk_, psb_c_base_sparse_mat
      class(psb_cspmat_type), intent(inout) :: a
      class(psb_c_base_sparse_mat), intent(inout) :: b
    end subroutine psb_c_mv_to
  end interface

  interface
    subroutine psb_c_cp_to(a,b)
      import :: psb_ipk_, psb_lpk_, psb_cspmat_type, psb_spk_, psb_c_base_sparse_mat
      class(psb_cspmat_type), intent(in) :: a
      class(psb_c_base_sparse_mat), intent(inout) :: b
    end subroutine psb_c_cp_to
  end interface
  !
  ! Mixed type conversions
  !
  interface
    subroutine psb_c_mv_from_lb(a,b)
      import :: psb_ipk_, psb_lpk_, psb_cspmat_type, psb_spk_, psb_lc_base_sparse_mat
      class(psb_cspmat_type), intent(inout) :: a
      class(psb_lc_base_sparse_mat), intent(inout) :: b
    end subroutine psb_c_mv_from_lb
  end interface

  interface
    subroutine psb_c_cp_from_lb(a,b)
      import :: psb_ipk_, psb_lpk_, psb_cspmat_type, psb_spk_, psb_lc_base_sparse_mat
      class(psb_cspmat_type), intent(inout) :: a
      class(psb_lc_base_sparse_mat), intent(inout) :: b
    end subroutine psb_c_cp_from_lb
  end interface

  interface
    subroutine psb_c_mv_to_lb(a,b)
      import :: psb_ipk_, psb_lpk_, psb_cspmat_type, psb_spk_, psb_lc_base_sparse_mat
      class(psb_cspmat_type), intent(inout) :: a
      class(psb_lc_base_sparse_mat), intent(inout) :: b
    end subroutine psb_c_mv_to_lb
  end interface

  interface
    subroutine psb_c_cp_to_lb(a,b)
      import :: psb_ipk_, psb_lpk_, psb_cspmat_type, psb_spk_, psb_lc_base_sparse_mat
      class(psb_cspmat_type), intent(in) :: a
      class(psb_lc_base_sparse_mat), intent(inout) :: b
    end subroutine psb_c_cp_to_lb
  end interface

    interface
    subroutine psb_c_mv_from_l(a,b)
      import :: psb_ipk_, psb_lpk_, psb_cspmat_type, psb_spk_, psb_lcspmat_type
      class(psb_cspmat_type), intent(inout) :: a
      class(psb_lcspmat_type), intent(inout) :: b
    end subroutine psb_c_mv_from_l
  end interface

  interface
    subroutine psb_c_cp_from_l(a,b)
      import :: psb_ipk_, psb_lpk_, psb_cspmat_type, psb_spk_, psb_lcspmat_type
      class(psb_cspmat_type), intent(out) :: a
      class(psb_lcspmat_type), intent(in) :: b
    end subroutine psb_c_cp_from_l
  end interface

  interface
    subroutine psb_c_mv_to_l(a,b)
      import :: psb_ipk_, psb_lpk_, psb_cspmat_type, psb_spk_, psb_lcspmat_type
      class(psb_cspmat_type), intent(inout) :: a
      class(psb_lcspmat_type), intent(inout) :: b
    end subroutine psb_c_mv_to_l
  end interface

  interface
    subroutine psb_c_cp_to_l(a,b)
      import :: psb_ipk_, psb_lpk_, psb_cspmat_type, psb_spk_, psb_lcspmat_type
      class(psb_cspmat_type), intent(in) :: a
      class(psb_lcspmat_type), intent(inout) :: b
    end subroutine psb_c_cp_to_l
  end interface

  !
  ! Transfer the internal allocation to the target.
  !
  interface psb_move_alloc
    subroutine psb_cspmat_type_move(a,b,info)
      import :: psb_ipk_, psb_lpk_, psb_cspmat_type
      class(psb_cspmat_type), intent(inout) :: a
      class(psb_cspmat_type), intent(inout)   :: b
      integer(psb_ipk_), intent(out)                   :: info
    end subroutine psb_cspmat_type_move
  end interface

  interface
    subroutine psb_cspmat_clone(a,b,info)
      import :: psb_ipk_, psb_lpk_, psb_cspmat_type
      class(psb_cspmat_type), intent(inout) :: a
      class(psb_cspmat_type), intent(inout) :: b
      integer(psb_ipk_), intent(out)        :: info
    end subroutine psb_cspmat_clone
  end interface




  ! == ===================================
  !
  !
  !
  ! Computational routines
  !
  !
  !
  !
  !
  !
  ! == ===================================

  interface psb_csmm
    subroutine psb_c_csmm(alpha,a,x,beta,y,info,trans)
      import :: psb_ipk_, psb_lpk_, psb_cspmat_type, psb_spk_
      class(psb_cspmat_type), intent(in) :: a
      complex(psb_spk_), intent(in)    :: alpha, beta, x(:,:)
      complex(psb_spk_), intent(inout) :: y(:,:)
      integer(psb_ipk_), intent(out)            :: info
      character, optional, intent(in) :: trans
    end subroutine psb_c_csmm
    subroutine psb_c_csmv(alpha,a,x,beta,y,info,trans)
      import :: psb_ipk_, psb_lpk_, psb_cspmat_type, psb_spk_
      class(psb_cspmat_type), intent(in) :: a
      complex(psb_spk_), intent(in)    :: alpha, beta, x(:)
      complex(psb_spk_), intent(inout) :: y(:)
      integer(psb_ipk_), intent(out)            :: info
      character, optional, intent(in) :: trans
    end subroutine psb_c_csmv
    subroutine psb_c_csmv_vect(alpha,a,x,beta,y,info,trans)
      use psb_c_vect_mod, only : psb_c_vect_type
      import :: psb_ipk_, psb_lpk_, psb_cspmat_type, psb_spk_
      class(psb_cspmat_type), intent(in)   :: a
      complex(psb_spk_), intent(in)        :: alpha, beta
      type(psb_c_vect_type), intent(inout) :: x
      type(psb_c_vect_type), intent(inout) :: y
      integer(psb_ipk_), intent(out)                 :: info
      character, optional, intent(in)      :: trans
    end subroutine psb_c_csmv_vect
  end interface

  interface psb_cssm
    subroutine psb_c_cssm(alpha,a,x,beta,y,info,trans,scale,d)
      import :: psb_ipk_, psb_lpk_, psb_cspmat_type, psb_spk_
      class(psb_cspmat_type), intent(in) :: a
      complex(psb_spk_), intent(in)    :: alpha, beta, x(:,:)
      complex(psb_spk_), intent(inout) :: y(:,:)
      integer(psb_ipk_), intent(out)            :: info
      character, optional, intent(in) :: trans, scale
      complex(psb_spk_), intent(in), optional :: d(:)
    end subroutine psb_c_cssm
    subroutine psb_c_cssv(alpha,a,x,beta,y,info,trans,scale,d)
      import :: psb_ipk_, psb_lpk_, psb_cspmat_type, psb_spk_
      class(psb_cspmat_type), intent(in) :: a
      complex(psb_spk_), intent(in)    :: alpha, beta, x(:)
      complex(psb_spk_), intent(inout) :: y(:)
      integer(psb_ipk_), intent(out)            :: info
      character, optional, intent(in) :: trans, scale
      complex(psb_spk_), intent(in), optional :: d(:)
    end subroutine psb_c_cssv
    subroutine psb_c_cssv_vect(alpha,a,x,beta,y,info,trans,scale,d)
      use psb_c_vect_mod, only : psb_c_vect_type
      import :: psb_ipk_, psb_lpk_, psb_cspmat_type, psb_spk_
      class(psb_cspmat_type), intent(in)   :: a
      complex(psb_spk_), intent(in)        :: alpha, beta
      type(psb_c_vect_type), intent(inout) :: x
      type(psb_c_vect_type), intent(inout) :: y
      integer(psb_ipk_), intent(out)                 :: info
      character, optional, intent(in)      :: trans, scale
      type(psb_c_vect_type), optional, intent(inout)   :: d
    end subroutine psb_c_cssv_vect
  end interface

  interface
    function psb_c_maxval(a) result(res)
      import :: psb_ipk_, psb_lpk_, psb_cspmat_type, psb_spk_
      class(psb_cspmat_type), intent(in) :: a
      real(psb_spk_)         :: res
    end function psb_c_maxval
  end interface

  interface
    function psb_c_csnmi(a) result(res)
      import :: psb_ipk_, psb_lpk_, psb_cspmat_type, psb_spk_
      class(psb_cspmat_type), intent(in) :: a
      real(psb_spk_)         :: res
    end function psb_c_csnmi
  end interface

  interface
    function psb_c_csnm1(a) result(res)
      import :: psb_ipk_, psb_lpk_, psb_cspmat_type, psb_spk_
      class(psb_cspmat_type), intent(in) :: a
      real(psb_spk_)         :: res
    end function psb_c_csnm1
  end interface

  interface
    function psb_c_rowsum(a,info) result(d)
      import :: psb_ipk_, psb_lpk_, psb_cspmat_type, psb_spk_
      class(psb_cspmat_type), intent(in) :: a
      complex(psb_spk_), allocatable      :: d(:)
      integer(psb_ipk_), intent(out)               :: info
    end function psb_c_rowsum
  end interface

  interface
    function psb_c_arwsum(a,info) result(d)
      import :: psb_ipk_, psb_lpk_, psb_cspmat_type, psb_spk_
      class(psb_cspmat_type), intent(in) :: a
      real(psb_spk_), allocatable        :: d(:)
      integer(psb_ipk_), intent(out)               :: info
    end function psb_c_arwsum
  end interface

  interface
    function psb_c_colsum(a,info) result(d)
      import :: psb_ipk_, psb_lpk_, psb_cspmat_type, psb_spk_
      class(psb_cspmat_type), intent(in) :: a
      complex(psb_spk_), allocatable      :: d(:)
      integer(psb_ipk_), intent(out)               :: info
    end function psb_c_colsum
  end interface

  interface
    function psb_c_aclsum(a,info)  result(d)
      import :: psb_ipk_, psb_lpk_, psb_cspmat_type, psb_spk_
      class(psb_cspmat_type), intent(in) :: a
      real(psb_spk_), allocatable        :: d(:)
      integer(psb_ipk_), intent(out)        :: info
    end function psb_c_aclsum
  end interface

  interface
    function psb_c_get_diag(a,info) result(d)
      import :: psb_ipk_, psb_lpk_, psb_cspmat_type, psb_spk_
      class(psb_cspmat_type), intent(in) :: a
      complex(psb_spk_), allocatable         :: d(:)
      integer(psb_ipk_), intent(out)       :: info
    end function psb_c_get_diag
  end interface

  interface psb_scal
    subroutine psb_c_scal(d,a,info,side)
      import :: psb_ipk_, psb_lpk_, psb_cspmat_type, psb_spk_
      class(psb_cspmat_type), intent(inout) :: a
      complex(psb_spk_), intent(in)             :: d(:)
      integer(psb_ipk_), intent(out)                    :: info
      character, intent(in), optional :: side
    end subroutine psb_c_scal
    subroutine psb_c_scals(d,a,info)
      import :: psb_ipk_, psb_lpk_, psb_cspmat_type, psb_spk_
      class(psb_cspmat_type), intent(inout) :: a
      complex(psb_spk_), intent(in)             :: d
      integer(psb_ipk_), intent(out)                    :: info
    end subroutine psb_c_scals
  end interface

  interface  psb_scalplusidentity
      subroutine psb_c_scalplusidentity(d,a,info)
          import :: psb_ipk_, psb_lpk_, psb_cspmat_type, psb_spk_
          class(psb_cspmat_type), intent(inout) :: a
          complex(psb_spk_), intent(in)             :: d
          integer(psb_ipk_), intent(out)          :: info
      end subroutine psb_c_scalplusidentity
  end interface

  interface psb_spaxpby
      subroutine psb_c_spaxpby(alpha,a,beta,b,info)
          import :: psb_ipk_, psb_lpk_, psb_cspmat_type, psb_spk_
          class(psb_cspmat_type), intent(inout) :: a
          class(psb_cspmat_type), intent(inout) :: b
          complex(psb_spk_), intent(in)             :: alpha
          complex(psb_spk_), intent(in)             :: beta
          integer(psb_ipk_), intent(out)          :: info
      end subroutine psb_c_spaxpby
  end interface

  interface
      function psb_c_cmpval(a,val,tol,info) result(res)
          import :: psb_ipk_, psb_lpk_, psb_cspmat_type, psb_spk_
          class(psb_cspmat_type), intent(inout) :: a
          complex(psb_spk_), intent(in)             :: val
          real(psb_spk_), intent(in)            :: tol
          logical                                 :: res
          integer(psb_ipk_), intent(out)          :: info
      end function psb_c_cmpval
  end interface

  interface
      function psb_c_cmpmat(a,b,tol,info) result(res)
          import :: psb_ipk_, psb_lpk_, psb_cspmat_type, psb_spk_
          class(psb_cspmat_type), intent(inout) :: a
          class(psb_cspmat_type), intent(inout) :: b
          real(psb_spk_), intent(in)            :: tol
          logical                                 :: res
          integer(psb_ipk_), intent(out)          :: info
      end function psb_c_cmpmat
  end interface

  ! == ===================================
  !
  !
  !
  ! Setters
  !
  !
  !
  !
  !
  !
  ! == ===================================


  interface
    subroutine  psb_lc_set_lnrows(m,a)
      import :: psb_ipk_, psb_lpk_, psb_lcspmat_type
      class(psb_lcspmat_type), intent(inout) :: a
      integer(psb_lpk_), intent(in) :: m
    end subroutine psb_lc_set_lnrows
#if defined(IPK4) && defined(LPK8)
    subroutine  psb_lc_set_inrows(m,a)
      import :: psb_ipk_, psb_lpk_, psb_lcspmat_type
      class(psb_lcspmat_type), intent(inout) :: a
      integer(psb_ipk_), intent(in) :: m
    end subroutine psb_lc_set_inrows
#endif
  end interface

  interface
    subroutine psb_lc_set_lncols(n,a)
      import :: psb_ipk_, psb_lpk_, psb_lcspmat_type
      class(psb_lcspmat_type), intent(inout) :: a
      integer(psb_lpk_), intent(in) :: n
    end subroutine psb_lc_set_lncols
#if defined(IPK4) && defined(LPK8)
    subroutine psb_lc_set_incols(n,a)
      import :: psb_ipk_, psb_lpk_, psb_lcspmat_type
      class(psb_lcspmat_type), intent(inout) :: a
      integer(psb_ipk_), intent(in) :: n
    end subroutine psb_lc_set_incols
#endif
  end interface

  interface
    subroutine  psb_lc_set_dupl(n,a)
      import :: psb_ipk_, psb_lpk_, psb_lcspmat_type
      class(psb_lcspmat_type), intent(inout) :: a
      integer(psb_ipk_), intent(in) :: n
    end subroutine psb_lc_set_dupl
  end interface

  interface
    subroutine psb_lc_set_null(a)
      import :: psb_ipk_, psb_lpk_, psb_lcspmat_type
      class(psb_lcspmat_type), intent(inout) :: a
    end subroutine psb_lc_set_null
  end interface

  interface
    subroutine psb_lc_set_bld(a)
      import :: psb_ipk_, psb_lpk_, psb_lcspmat_type
      class(psb_lcspmat_type), intent(inout) :: a
    end subroutine psb_lc_set_bld
  end interface

  interface
    subroutine psb_lc_set_upd(a)
      import :: psb_ipk_, psb_lpk_, psb_lcspmat_type
      class(psb_lcspmat_type), intent(inout) :: a
    end subroutine psb_lc_set_upd
  end interface

  interface
    subroutine psb_lc_set_asb(a)
      import :: psb_ipk_, psb_lpk_, psb_lcspmat_type
      class(psb_lcspmat_type), intent(inout) :: a
    end subroutine psb_lc_set_asb
  end interface

  interface
    subroutine psb_lc_set_sorted(a,val)
      import :: psb_ipk_, psb_lpk_, psb_lcspmat_type
      class(psb_lcspmat_type), intent(inout) :: a
      logical, intent(in), optional :: val
    end subroutine psb_lc_set_sorted
  end interface

  interface
    subroutine psb_lc_set_triangle(a,val)
      import :: psb_ipk_, psb_lpk_, psb_lcspmat_type
      class(psb_lcspmat_type), intent(inout) :: a
      logical, intent(in), optional :: val
    end subroutine psb_lc_set_triangle
  end interface

  interface
    subroutine psb_lc_set_symmetric(a,val)
      import :: psb_ipk_, psb_lcspmat_type
      class(psb_lcspmat_type), intent(inout) :: a
      logical, intent(in), optional :: val
    end subroutine psb_lc_set_symmetric
  end interface

  interface
    subroutine psb_lc_set_unit(a,val)
      import :: psb_ipk_, psb_lpk_, psb_lcspmat_type
      class(psb_lcspmat_type), intent(inout) :: a
      logical, intent(in), optional :: val
    end subroutine psb_lc_set_unit
  end interface

  interface
    subroutine psb_lc_set_lower(a,val)
      import :: psb_ipk_, psb_lpk_, psb_lcspmat_type
      class(psb_lcspmat_type), intent(inout) :: a
      logical, intent(in), optional :: val
    end subroutine psb_lc_set_lower
  end interface

  interface
    subroutine psb_lc_set_upper(a,val)
      import :: psb_ipk_, psb_lpk_, psb_lcspmat_type
      class(psb_lcspmat_type), intent(inout) :: a
      logical, intent(in), optional :: val
    end subroutine psb_lc_set_upper
  end interface

  interface
    subroutine psb_lc_sparse_print(iout,a,iv,head,ivr,ivc)
      import :: psb_ipk_, psb_lpk_, psb_lcspmat_type
      integer(psb_ipk_), intent(in)               :: iout
      class(psb_lcspmat_type), intent(in) :: a
      integer(psb_lpk_), intent(in), optional     :: iv(:)
      character(len=*), optional        :: head
      integer(psb_lpk_), intent(in), optional     :: ivr(:), ivc(:)
    end subroutine psb_lc_sparse_print
  end interface

  interface
    subroutine psb_lc_n_sparse_print(fname,a,iv,head,ivr,ivc)
      import :: psb_ipk_, psb_lpk_, psb_lcspmat_type
      character(len=*), intent(in)      :: fname
      class(psb_lcspmat_type), intent(in) :: a
      integer(psb_lpk_), intent(in), optional     :: iv(:)
      character(len=*), optional        :: head
      integer(psb_lpk_), intent(in), optional     :: ivr(:), ivc(:)
    end subroutine psb_lc_n_sparse_print
  end interface

  interface
    subroutine psb_lc_get_neigh(a,idx,neigh,n,info,lev)
      import :: psb_ipk_, psb_lpk_, psb_lcspmat_type
      class(psb_lcspmat_type), intent(in) :: a
      integer(psb_lpk_), intent(in)                :: idx
      integer(psb_lpk_), intent(out)               :: n
      integer(psb_lpk_), allocatable, intent(out)  :: neigh(:)
      integer(psb_ipk_), intent(out)               :: info
      integer(psb_lpk_), optional, intent(in)      :: lev
    end subroutine psb_lc_get_neigh
  end interface

  interface
    subroutine psb_lc_csall(nr,nc,a,info,nz,type,mold)
      import :: psb_ipk_, psb_lpk_, psb_lcspmat_type, psb_lc_base_sparse_mat
      class(psb_lcspmat_type), intent(inout) :: a
      integer(psb_lpk_), intent(in)             :: nr,nc
      integer(psb_ipk_), intent(out)            :: info
      integer(psb_lpk_), intent(in), optional   :: nz
      character(len=*), intent(in), optional    :: type
      class(psb_lc_base_sparse_mat), optional, intent(in) :: mold
    end subroutine psb_lc_csall
  end interface

  interface
    subroutine psb_lc_reallocate_nz(nz,a)
      import :: psb_ipk_, psb_lpk_, psb_lcspmat_type
      integer(psb_lpk_), intent(in) :: nz
      class(psb_lcspmat_type), intent(inout) :: a
    end subroutine psb_lc_reallocate_nz
  end interface

  interface
    subroutine psb_lc_free(a)
      import :: psb_ipk_, psb_lpk_, psb_lcspmat_type
      class(psb_lcspmat_type), intent(inout) :: a
    end subroutine psb_lc_free
  end interface

  interface
    subroutine psb_lc_trim(a)
      import :: psb_ipk_, psb_lpk_, psb_lcspmat_type
      class(psb_lcspmat_type), intent(inout) :: a
    end subroutine psb_lc_trim
  end interface

  interface
    subroutine psb_lc_csput_a(nz,ia,ja,val,a,imin,imax,jmin,jmax,info)
      import :: psb_ipk_, psb_lpk_, psb_lcspmat_type, psb_spk_
      class(psb_lcspmat_type), intent(inout) :: a
      complex(psb_spk_), intent(in)      :: val(:)
      integer(psb_lpk_), intent(in)             :: nz, ia(:), ja(:), imin,imax,jmin,jmax
      integer(psb_ipk_), intent(out)            :: info
    end subroutine psb_lc_csput_a
  end interface


  interface
    subroutine psb_lc_csput_v(nz,ia,ja,val,a,imin,imax,jmin,jmax,info)
      use psb_c_vect_mod, only : psb_c_vect_type
      use psb_l_vect_mod, only : psb_l_vect_type
      import :: psb_ipk_, psb_lpk_, psb_lcspmat_type
      class(psb_lcspmat_type), intent(inout) :: a
      type(psb_c_vect_type), intent(inout)  :: val
      type(psb_l_vect_type), intent(inout)  :: ia, ja
      integer(psb_lpk_), intent(in)             :: nz, imin,imax,jmin,jmax
      integer(psb_ipk_), intent(out)            :: info
    end subroutine psb_lc_csput_v
  end interface

  interface
    subroutine psb_lc_csgetptn(imin,imax,a,nz,ia,ja,info,&
       & jmin,jmax,iren,append,nzin,rscale,cscale)
      import :: psb_ipk_, psb_lpk_, psb_lcspmat_type, psb_spk_
      class(psb_lcspmat_type), intent(in) :: a
      integer(psb_lpk_), intent(in)                  :: imin,imax
      integer(psb_lpk_), intent(out)                 :: nz
      integer(psb_lpk_), allocatable, intent(inout)  :: ia(:), ja(:)
      integer(psb_ipk_),intent(out)                  :: info
      logical, intent(in), optional        :: append
      integer(psb_lpk_), intent(in), optional        :: iren(:)
      integer(psb_lpk_), intent(in), optional        :: jmin,jmax, nzin
      logical, intent(in), optional        :: rscale,cscale
    end subroutine psb_lc_csgetptn
  end interface

  interface
    subroutine psb_lc_csgetrow(imin,imax,a,nz,ia,ja,val,info,&
         & jmin,jmax,iren,append,nzin,rscale,cscale)
      import :: psb_ipk_, psb_lpk_, psb_lcspmat_type, psb_spk_
      class(psb_lcspmat_type), intent(in) :: a
      integer(psb_lpk_), intent(in)                  :: imin,imax
      integer(psb_lpk_), intent(out)                 :: nz
      integer(psb_lpk_), allocatable, intent(inout)  :: ia(:), ja(:)
      complex(psb_spk_), allocatable,  intent(inout)    :: val(:)
      integer(psb_ipk_),intent(out)                  :: info
      logical, intent(in), optional        :: append
      integer(psb_lpk_), intent(in), optional        :: iren(:)
      integer(psb_lpk_), intent(in), optional        :: jmin,jmax, nzin
      logical, intent(in), optional        :: rscale,cscale
    end subroutine psb_lc_csgetrow
  end interface

  interface
    subroutine psb_lc_csgetblk(imin,imax,a,b,info,&
       & jmin,jmax,iren,append,rscale,cscale)
      import :: psb_ipk_, psb_lpk_, psb_lcspmat_type, psb_spk_
      class(psb_lcspmat_type), intent(in)    :: a
      class(psb_lcspmat_type), intent(inout) :: b
      integer(psb_lpk_), intent(in)                  :: imin,imax
      integer(psb_ipk_),intent(out)                  :: info
      logical, intent(in), optional        :: append
      integer(psb_lpk_), intent(in), optional        :: iren(:)
      integer(psb_lpk_), intent(in), optional        :: jmin,jmax
      logical, intent(in), optional        :: rscale,cscale
    end subroutine psb_lc_csgetblk
  end interface

  interface
    subroutine psb_lc_tril(a,l,info,diag,imin,imax,&
         & jmin,jmax,rscale,cscale,u)
      import :: psb_ipk_, psb_lpk_, psb_lcspmat_type, psb_spk_
      class(psb_lcspmat_type), intent(in)      :: a
      class(psb_lcspmat_type), intent(inout)   :: l
      integer(psb_ipk_),intent(out)           :: info
      integer(psb_lpk_), intent(in), optional :: diag,imin,imax,jmin,jmax
      logical, intent(in), optional           :: rscale,cscale
      class(psb_lcspmat_type), optional, intent(inout)   :: u
    end subroutine psb_lc_tril
  end interface

  interface
    subroutine psb_lc_triu(a,u,info,diag,imin,imax,&
         & jmin,jmax,rscale,cscale,l)
      import :: psb_ipk_, psb_lpk_, psb_lcspmat_type, psb_spk_
      class(psb_lcspmat_type), intent(in)      :: a
      class(psb_lcspmat_type), intent(inout)   :: u
      integer(psb_ipk_),intent(out)           :: info
      integer(psb_lpk_), intent(in), optional :: diag,imin,imax,jmin,jmax
      logical, intent(in), optional           :: rscale,cscale
      class(psb_lcspmat_type), optional, intent(inout)   :: l
    end subroutine psb_lc_triu
  end interface


  interface
    subroutine psb_lc_csclip(a,b,info,&
       & imin,imax,jmin,jmax,rscale,cscale)
      import :: psb_ipk_, psb_lpk_, psb_lcspmat_type, psb_spk_
      class(psb_lcspmat_type), intent(in) :: a
      class(psb_lcspmat_type), intent(inout) :: b
      integer(psb_ipk_),intent(out)                  :: info
      integer(psb_lpk_), intent(in), optional        :: imin,imax,jmin,jmax
      logical, intent(in), optional        :: rscale,cscale
    end subroutine psb_lc_csclip
  end interface

  interface
    subroutine psb_lc_csclip_ip(a,info,&
       & imin,imax,jmin,jmax,rscale,cscale)
      import :: psb_ipk_, psb_lpk_, psb_lcspmat_type, psb_spk_
      class(psb_lcspmat_type), intent(inout) :: a
      integer(psb_ipk_),intent(out)                  :: info
      integer(psb_lpk_), intent(in), optional        :: imin,imax,jmin,jmax
      logical, intent(in), optional        :: rscale,cscale
    end subroutine psb_lc_csclip_ip
  end interface

  interface
    subroutine psb_lc_b_csclip(a,b,info,&
       & imin,imax,jmin,jmax,rscale,cscale)
      import :: psb_ipk_, psb_lpk_, psb_lcspmat_type, psb_spk_, psb_lc_coo_sparse_mat
      class(psb_lcspmat_type), intent(in) :: a
      type(psb_lc_coo_sparse_mat), intent(out) :: b
      integer(psb_ipk_),intent(out)                  :: info
      integer(psb_lpk_), intent(in), optional        :: imin,imax,jmin,jmax
      logical, intent(in), optional        :: rscale,cscale
    end subroutine psb_lc_b_csclip
  end interface

  interface
    subroutine psb_lc_mold(a,b)
      import :: psb_ipk_, psb_lpk_, psb_lcspmat_type, psb_lc_base_sparse_mat
      class(psb_lcspmat_type), intent(inout)     :: a
      class(psb_lc_base_sparse_mat), allocatable, intent(out) :: b
    end subroutine psb_lc_mold
  end interface

  interface
    subroutine psb_lc_asb(a,mold)
      import :: psb_ipk_, psb_lpk_, psb_lcspmat_type, psb_lc_base_sparse_mat
      class(psb_lcspmat_type), intent(inout) :: a
      class(psb_lc_base_sparse_mat), optional, intent(in) :: mold
    end subroutine psb_lc_asb
  end interface

  interface
    subroutine psb_lc_transp_1mat(a)
      import :: psb_ipk_, psb_lpk_, psb_lcspmat_type
      class(psb_lcspmat_type), intent(inout) :: a
    end subroutine psb_lc_transp_1mat
  end interface

  interface
    subroutine psb_lc_transp_2mat(a,b)
      import :: psb_ipk_, psb_lpk_, psb_lcspmat_type
      class(psb_lcspmat_type), intent(in)  :: a
      class(psb_lcspmat_type), intent(inout) :: b
    end subroutine psb_lc_transp_2mat
  end interface

  interface
    subroutine psb_lc_transc_1mat(a)
      import :: psb_ipk_, psb_lpk_, psb_lcspmat_type
      class(psb_lcspmat_type), intent(inout) :: a
    end subroutine psb_lc_transc_1mat
  end interface

  interface
    subroutine psb_lc_transc_2mat(a,b)
      import :: psb_ipk_, psb_lpk_, psb_lcspmat_type
      class(psb_lcspmat_type), intent(in)  :: a
      class(psb_lcspmat_type), intent(inout) :: b
    end subroutine psb_lc_transc_2mat
  end interface

  interface
    subroutine psb_lc_reinit(a,clear)
      import :: psb_ipk_, psb_lpk_, psb_lcspmat_type
      class(psb_lcspmat_type), intent(inout) :: a
      logical, intent(in), optional :: clear
    end subroutine psb_lc_reinit

  end interface


  !
  ! These methods are specific to the outer SPMAT_TYPE level, since
  ! they tamper with the inner BASE_SPARSE_MAT object.
  !
  !

  !
  ! CSCNV: switches to a different internal derived type.
  !   3 versions: copying to target
  !               copying to a base_sparse_mat object.
  !               in place
  !
  !
  interface
    subroutine psb_lc_cscnv(a,b,info,type,mold,upd,dupl)
      import :: psb_ipk_, psb_lpk_, psb_lcspmat_type, psb_spk_, psb_lc_base_sparse_mat
      class(psb_lcspmat_type), intent(in)      :: a
      class(psb_lcspmat_type), intent(inout)   :: b
      integer(psb_ipk_), intent(out)                   :: info
      integer(psb_ipk_),optional, intent(in)           :: dupl, upd
      character(len=*), optional, intent(in) :: type
      class(psb_lc_base_sparse_mat), intent(in), optional :: mold
    end subroutine psb_lc_cscnv
  end interface


  interface
    subroutine psb_lc_cscnv_ip(a,iinfo,type,mold,dupl)
      import :: psb_ipk_, psb_lpk_, psb_lcspmat_type, psb_spk_, psb_lc_base_sparse_mat
      class(psb_lcspmat_type), intent(inout) :: a
      integer(psb_ipk_), intent(out)                   :: iinfo
      integer(psb_ipk_),optional, intent(in)           :: dupl
      character(len=*), optional, intent(in) :: type
      class(psb_lc_base_sparse_mat), intent(in), optional :: mold
    end subroutine psb_lc_cscnv_ip
  end interface


  interface
    subroutine psb_lc_cscnv_base(a,b,info,dupl)
      import :: psb_ipk_, psb_lpk_, psb_lcspmat_type, psb_spk_, psb_lc_base_sparse_mat
      class(psb_lcspmat_type), intent(in)       :: a
      class(psb_lc_base_sparse_mat), intent(out) :: b
      integer(psb_ipk_), intent(out)                   :: info
      integer(psb_ipk_),optional, intent(in)           :: dupl
    end subroutine psb_lc_cscnv_base
  end interface


  !
  ! Produce a version of the matrix with diagonal cut
  ! out; passes through a COO buffer.
  !
  interface
    subroutine psb_lc_clip_d(a,b,info)
      import :: psb_ipk_, psb_lpk_, psb_lcspmat_type
      class(psb_lcspmat_type), intent(in)    :: a
      class(psb_lcspmat_type), intent(inout) :: b
      integer(psb_ipk_),intent(out)                  :: info
    end subroutine psb_lc_clip_d
  end interface

  interface
    subroutine psb_lc_clip_d_ip(a,info)
      import :: psb_ipk_, psb_lpk_, psb_lcspmat_type
      class(psb_lcspmat_type), intent(inout) :: a
      integer(psb_ipk_),intent(out)                  :: info
    end subroutine psb_lc_clip_d_ip
  end interface


  !
  ! These four interfaces cut through the
  ! encapsulation between spmat_type and base_sparse_mat.
  !
  interface
    subroutine psb_lc_mv_from(a,b)
      import :: psb_ipk_, psb_lpk_, psb_lcspmat_type, psb_spk_, psb_lc_base_sparse_mat
      class(psb_lcspmat_type), intent(inout) :: a
      class(psb_lc_base_sparse_mat), intent(inout) :: b
    end subroutine psb_lc_mv_from
  end interface

  interface
    subroutine psb_lc_cp_from(a,b)
      import :: psb_ipk_, psb_lpk_, psb_lcspmat_type, psb_spk_, psb_lc_base_sparse_mat
      class(psb_lcspmat_type), intent(out) :: a
      class(psb_lc_base_sparse_mat), intent(in) :: b
    end subroutine psb_lc_cp_from
  end interface

  interface
    subroutine psb_lc_mv_to(a,b)
      import :: psb_ipk_, psb_lpk_, psb_lcspmat_type, psb_spk_, psb_lc_base_sparse_mat
      class(psb_lcspmat_type), intent(inout) :: a
      class(psb_lc_base_sparse_mat), intent(inout) :: b
    end subroutine psb_lc_mv_to
  end interface

  interface
    subroutine psb_lc_cp_to(a,b)
      import :: psb_ipk_, psb_lpk_, psb_lcspmat_type, psb_spk_, psb_lc_base_sparse_mat
      class(psb_lcspmat_type), intent(in) :: a
      class(psb_lc_base_sparse_mat), intent(inout) :: b
    end subroutine psb_lc_cp_to
  end interface
  !
  ! Mixed type conversions
  !
  interface
    subroutine psb_lc_mv_from_ib(a,b)
      import :: psb_ipk_, psb_lpk_, psb_lcspmat_type, psb_spk_, psb_c_base_sparse_mat
      class(psb_lcspmat_type), intent(inout) :: a
      class(psb_c_base_sparse_mat), intent(inout) :: b
    end subroutine psb_lc_mv_from_ib
  end interface

  interface
    subroutine psb_lc_cp_from_ib(a,b)
      import :: psb_ipk_, psb_lpk_, psb_lcspmat_type, psb_spk_, psb_c_base_sparse_mat
      class(psb_lcspmat_type), intent(inout) :: a
      class(psb_c_base_sparse_mat), intent(inout) :: b
    end subroutine psb_lc_cp_from_ib
  end interface

  interface
    subroutine psb_lc_mv_to_ib(a,b)
      import :: psb_ipk_, psb_lpk_, psb_lcspmat_type, psb_spk_, psb_c_base_sparse_mat
      class(psb_lcspmat_type), intent(inout) :: a
      class(psb_c_base_sparse_mat), intent(inout) :: b
    end subroutine psb_lc_mv_to_ib
  end interface

  interface
    subroutine psb_lc_cp_to_ib(a,b)
      import :: psb_ipk_, psb_lpk_, psb_lcspmat_type, psb_spk_, psb_c_base_sparse_mat
      class(psb_lcspmat_type), intent(in) :: a
      class(psb_c_base_sparse_mat), intent(inout) :: b
    end subroutine psb_lc_cp_to_ib
  end interface

    interface
    subroutine psb_lc_mv_from_i(a,b)
      import :: psb_ipk_, psb_lpk_, psb_lcspmat_type, psb_spk_, psb_cspmat_type
      class(psb_lcspmat_type), intent(inout) :: a
      class(psb_cspmat_type), intent(inout) :: b
    end subroutine psb_lc_mv_from_i
  end interface

  interface
    subroutine psb_lc_cp_from_i(a,b)
      import :: psb_ipk_, psb_lpk_, psb_lcspmat_type, psb_spk_, psb_cspmat_type
      class(psb_lcspmat_type), intent(out) :: a
      class(psb_cspmat_type), intent(in) :: b
    end subroutine psb_lc_cp_from_i
  end interface

  interface
    subroutine psb_lc_mv_to_i(a,b)
      import :: psb_ipk_, psb_lpk_, psb_lcspmat_type, psb_spk_, psb_cspmat_type
      class(psb_lcspmat_type), intent(inout) :: a
      class(psb_cspmat_type), intent(inout) :: b
    end subroutine psb_lc_mv_to_i
  end interface

  interface
    subroutine psb_lc_cp_to_i(a,b)
      import :: psb_ipk_, psb_lpk_, psb_lcspmat_type, psb_spk_, psb_cspmat_type
      class(psb_lcspmat_type), intent(in) :: a
      class(psb_cspmat_type), intent(inout) :: b
    end subroutine psb_lc_cp_to_i
  end interface


  !
  ! Transfer the internal allocation to the target.
  !
  interface psb_move_alloc
    subroutine psb_lcspmat_type_move(a,b,info)
      import :: psb_ipk_, psb_lpk_, psb_lcspmat_type
      class(psb_lcspmat_type), intent(inout) :: a
      class(psb_lcspmat_type), intent(inout)   :: b
      integer(psb_ipk_), intent(out)                   :: info
    end subroutine psb_lcspmat_type_move
  end interface

  interface
    subroutine psb_lcspmat_clone(a,b,info)
      import :: psb_ipk_, psb_lpk_, psb_lcspmat_type
      class(psb_lcspmat_type), intent(inout) :: a
      class(psb_lcspmat_type), intent(inout) :: b
      integer(psb_ipk_), intent(out)        :: info
    end subroutine psb_lcspmat_clone
  end interface



  interface
    function psb_lc_get_diag(a,info) result(d)
      import :: psb_ipk_, psb_lpk_, psb_lcspmat_type, psb_spk_
      class(psb_lcspmat_type), intent(in) :: a
      complex(psb_spk_), allocatable         :: d(:)
      integer(psb_ipk_), intent(out)       :: info
    end function psb_lc_get_diag
  end interface

  interface psb_scal
    subroutine psb_lc_scal(d,a,info,side)
      import :: psb_ipk_, psb_lpk_, psb_lcspmat_type, psb_spk_
      class(psb_lcspmat_type), intent(inout) :: a
      complex(psb_spk_), intent(in)             :: d(:)
      integer(psb_ipk_), intent(out)                    :: info
      character, intent(in), optional :: side
    end subroutine psb_lc_scal
    subroutine psb_lc_scals(d,a,info)
      import :: psb_ipk_, psb_lpk_, psb_lcspmat_type, psb_spk_
      class(psb_lcspmat_type), intent(inout) :: a
      complex(psb_spk_), intent(in)             :: d
      integer(psb_ipk_), intent(out)                    :: info
    end subroutine psb_lc_scals
  end interface

  interface psb_scalplusidentity
      subroutine psb_lc_scalplusidentity(d,a,info)
        import :: psb_ipk_, psb_lpk_, psb_lcspmat_type, psb_spk_
        class(psb_lcspmat_type), intent(inout) :: a
        complex(psb_spk_), intent(in)             :: d
        integer(psb_ipk_), intent(out)                    :: info
    end subroutine psb_lc_scalplusidentity
  end interface

  interface psb_spaxpby
      subroutine psb_lc_spaxpby(alpha,a,beta,b,info)
          import :: psb_ipk_, psb_lpk_, psb_lcspmat_type, psb_spk_
          class(psb_lcspmat_type), intent(inout) :: a
          class(psb_lcspmat_type), intent(inout) :: b
          complex(psb_spk_), intent(in)             :: alpha
          complex(psb_spk_), intent(in)             :: beta
          integer(psb_ipk_), intent(out)          :: info
      end subroutine psb_lc_spaxpby
  end interface

  interface
    function psb_lc_maxval(a) result(res)
      import :: psb_ipk_, psb_lpk_, psb_lcspmat_type, psb_spk_
      class(psb_lcspmat_type), intent(in) :: a
      real(psb_spk_)         :: res
    end function psb_lc_maxval
  end interface

  interface
    function psb_lc_csnmi(a) result(res)
      import :: psb_ipk_, psb_lpk_, psb_lcspmat_type, psb_spk_
      class(psb_lcspmat_type), intent(in) :: a
      real(psb_spk_)         :: res
    end function psb_lc_csnmi
  end interface

  interface
    function psb_lc_csnm1(a) result(res)
      import :: psb_ipk_, psb_lpk_, psb_lcspmat_type, psb_spk_
      class(psb_lcspmat_type), intent(in) :: a
      real(psb_spk_)         :: res
    end function psb_lc_csnm1
  end interface

  interface
    function psb_lc_rowsum(a,info) result(d)
      import :: psb_ipk_, psb_lpk_, psb_lcspmat_type, psb_spk_
      class(psb_lcspmat_type), intent(in) :: a
      complex(psb_spk_), allocatable      :: d(:)
      integer(psb_ipk_), intent(out)               :: info
    end function psb_lc_rowsum
  end interface

  interface
    function psb_lc_arwsum(a,info) result(d)
      import :: psb_ipk_, psb_lpk_, psb_lcspmat_type, psb_spk_
      class(psb_lcspmat_type), intent(in) :: a
      real(psb_spk_), allocatable        :: d(:)
      integer(psb_ipk_), intent(out)               :: info
    end function psb_lc_arwsum
  end interface

  interface
    function psb_lc_colsum(a,info) result(d)
      import :: psb_ipk_, psb_lpk_, psb_lcspmat_type, psb_spk_
      class(psb_lcspmat_type), intent(in) :: a
      complex(psb_spk_), allocatable      :: d(:)
      integer(psb_ipk_), intent(out)               :: info
    end function psb_lc_colsum
  end interface

  interface
    function psb_lc_aclsum(a,info)  result(d)
      import :: psb_ipk_, psb_lpk_, psb_lcspmat_type, psb_spk_
      class(psb_lcspmat_type), intent(in) :: a
      real(psb_spk_), allocatable        :: d(:)
      integer(psb_ipk_), intent(out)        :: info
    end function psb_lc_aclsum
  end interface

  interface  psb_cmpmat
      function psb_lc_cmpval(a,val,tol,info) result(res)
          import :: psb_ipk_, psb_lpk_, psb_lcspmat_type, psb_spk_
          class(psb_lcspmat_type), intent(inout) :: a
          complex(psb_spk_), intent(in)              :: val
          real(psb_spk_), intent(in)             :: tol
          logical                                  :: res
          integer(psb_ipk_), intent(out)           :: info
      end function psb_lc_cmpval
      function psb_lc_cmpmat(a,b,tol,info) result(res)
          import :: psb_ipk_, psb_lpk_, psb_lcspmat_type, psb_spk_
          class(psb_lcspmat_type), intent(inout) :: a
          class(psb_lcspmat_type), intent(inout) :: b
          real(psb_spk_), intent(in)             :: tol
          logical                                  :: res
          integer(psb_ipk_), intent(out)           :: info
      end function psb_lc_cmpmat
  end interface

contains

  subroutine  psb_c_set_mat_default(a)
    implicit none
    class(psb_c_base_sparse_mat), intent(in) :: a

    if (allocated(psb_c_base_mat_default)) then
      deallocate(psb_c_base_mat_default)
    end if
    allocate(psb_c_base_mat_default, mold=a)

  end subroutine psb_c_set_mat_default

  function psb_c_get_mat_default(a) result(res)
    implicit none
    class(psb_cspmat_type), intent(in) :: a
    class(psb_c_base_sparse_mat), pointer :: res

    res => psb_c_get_base_mat_default()

  end function psb_c_get_mat_default


  function psb_c_get_base_mat_default() result(res)
    implicit none
    class(psb_c_base_sparse_mat), pointer :: res

    if (.not.allocated(psb_c_base_mat_default)) then
      allocate(psb_c_csr_sparse_mat :: psb_c_base_mat_default)
    end if

    res => psb_c_base_mat_default

  end function psb_c_get_base_mat_default

  subroutine  psb_c_clear_mat_default() 
    implicit none 
    
    if (allocated(psb_c_base_mat_default)) then 
      deallocate(psb_c_base_mat_default)
    end if

  end subroutine psb_c_clear_mat_default



  ! == ===================================
  !
  !
  !
  ! Getters
  !
  !
  !
  !
  !
  ! == ===================================


  function psb_c_sizeof(a) result(res)
    implicit none
    class(psb_cspmat_type), intent(in) :: a
    integer(psb_epk_) :: res

    res = 0
    if (allocated(a%a)) then
      res = a%a%sizeof()
    end if

  end function psb_c_sizeof


  function psb_c_get_fmt(a) result(res)
    implicit none
    class(psb_cspmat_type), intent(in) :: a
    character(len=5) :: res

    if (allocated(a%a)) then
      res = a%a%get_fmt()
    else
      res = 'NULL'
    end if

  end function psb_c_get_fmt


  function psb_c_get_dupl(a) result(res)
    implicit none
    class(psb_cspmat_type), intent(in) :: a
    integer(psb_ipk_) :: res

    if (allocated(a%a)) then
      res = a%a%get_dupl()
    else
      res = psb_invalid_
    end if
  end function psb_c_get_dupl

  function psb_c_get_nrows(a) result(res)
    implicit none
    class(psb_cspmat_type), intent(in) :: a
    integer(psb_ipk_) :: res

    if (allocated(a%a)) then
      res = a%a%get_nrows()
    else
      res = 0
    end if

  end function psb_c_get_nrows

  function psb_c_get_ncols(a) result(res)
    implicit none
    class(psb_cspmat_type), intent(in) :: a
    integer(psb_ipk_) :: res

    if (allocated(a%a)) then
      res = a%a%get_ncols()
    else
      res = 0
    end if

  end function psb_c_get_ncols

  function psb_c_is_triangle(a) result(res)
    implicit none
    class(psb_cspmat_type), intent(in) :: a
    logical :: res

    if (allocated(a%a)) then
      res = a%a%is_triangle()
    else
      res = .false.
    end if

  end function psb_c_is_triangle

  function psb_c_is_symmetric(a) result(res)
    implicit none
    class(psb_cspmat_type), intent(in) :: a
    logical :: res

    if (allocated(a%a)) then
      res = a%a%is_symmetric()
    else
      res = .false.
    end if

  end function psb_c_is_symmetric

  function psb_c_is_unit(a) result(res)
    implicit none
    class(psb_cspmat_type), intent(in) :: a
    logical :: res

    if (allocated(a%a)) then
      res = a%a%is_unit()
    else
      res = .false.
    end if

  end function psb_c_is_unit

  function psb_c_is_upper(a) result(res)
    implicit none
    class(psb_cspmat_type), intent(in) :: a
    logical :: res

    if (allocated(a%a)) then
      res = a%a%is_upper()
    else
      res = .false.
    end if

  end function psb_c_is_upper

  function psb_c_is_lower(a) result(res)
    implicit none
    class(psb_cspmat_type), intent(in) :: a
    logical :: res

    if (allocated(a%a)) then
      res = .not. a%a%is_upper()
    else
      res = .false.
    end if

  end function psb_c_is_lower

  function psb_c_is_null(a) result(res)
    implicit none
    class(psb_cspmat_type), intent(in) :: a
    logical :: res

    if (allocated(a%a)) then
      res = a%a%is_null()
    else
      res = .true.
    end if

  end function psb_c_is_null

  function psb_c_is_bld(a) result(res)
    implicit none
    class(psb_cspmat_type), intent(in) :: a
    logical :: res

    if (allocated(a%a)) then
      res = a%a%is_bld()
    else
      res = .false.
    end if

  end function psb_c_is_bld

  function psb_c_is_upd(a) result(res)
    implicit none
    class(psb_cspmat_type), intent(in) :: a
    logical :: res

    if (allocated(a%a)) then
      res = a%a%is_upd()
    else
      res = .false.
    end if

  end function psb_c_is_upd

  function psb_c_is_asb(a) result(res)
    implicit none
    class(psb_cspmat_type), intent(in) :: a
    logical :: res

    if (allocated(a%a)) then
      res = a%a%is_asb()
    else
      res = .false.
    end if

  end function psb_c_is_asb

  function psb_c_is_sorted(a) result(res)
    implicit none
    class(psb_cspmat_type), intent(in) :: a
    logical :: res

    if (allocated(a%a)) then
      res = a%a%is_sorted()
    else
      res = .false.
    end if

  end function psb_c_is_sorted

  function psb_c_is_by_rows(a) result(res)
    implicit none
    class(psb_cspmat_type), intent(in) :: a
    logical :: res

    if (allocated(a%a)) then
      res = a%a%is_by_rows()
    else
      res = .false.
    end if

  end function psb_c_is_by_rows

  function psb_c_is_by_cols(a) result(res)
    implicit none
    class(psb_cspmat_type), intent(in) :: a
    logical :: res

    if (allocated(a%a)) then
      res = a%a%is_by_cols()
    else
      res = .false.
    end if

  end function psb_c_is_by_cols


  !
  subroutine c_mat_sync(a)
    implicit none
    class(psb_cspmat_type), target, intent(in) :: a

    if (allocated(a%a))  call a%a%sync()

  end subroutine c_mat_sync

  !
  subroutine c_mat_set_host(a)
    implicit none
    class(psb_cspmat_type), intent(inout) :: a

    if (allocated(a%a))  call a%a%set_host()

  end subroutine c_mat_set_host


  !
  subroutine c_mat_set_dev(a)
    implicit none
    class(psb_cspmat_type), intent(inout) :: a

    if (allocated(a%a))  call a%a%set_dev()

  end subroutine c_mat_set_dev

  !
  subroutine c_mat_set_sync(a)
    implicit none
    class(psb_cspmat_type), intent(inout) :: a

    if (allocated(a%a))  call a%a%set_sync()

  end subroutine c_mat_set_sync

  !
  function c_mat_is_dev(a) result(res)
    implicit none
    class(psb_cspmat_type), intent(in) :: a
    logical  :: res

    if (allocated(a%a)) then
      res = a%a%is_dev()
    else
      res = .false.
    end if
  end function c_mat_is_dev

  !
  function c_mat_is_host(a) result(res)
    implicit none
    class(psb_cspmat_type), intent(in) :: a
    logical  :: res


    if (allocated(a%a)) then
      res = a%a%is_host()
    else
      res = .true.
    end if
  end function c_mat_is_host

  !
  function c_mat_is_sync(a) result(res)
    implicit none
    class(psb_cspmat_type), intent(in) :: a
    logical  :: res


    if (allocated(a%a)) then
      res = a%a%is_sync()
    else
      res = .true.
    end if

  end function c_mat_is_sync

  function psb_c_is_remote_build(a) result(res)
    implicit none
    class(psb_cspmat_type), intent(in) :: a
    logical :: res
    res = (a%remote_build == psb_matbld_remote_)
  end function psb_c_is_remote_build

  subroutine psb_c_set_remote_build(a,val)
    implicit none
    class(psb_cspmat_type), intent(inout) :: a
    integer(psb_ipk_), intent(in), optional :: val

    if (present(val)) then
      a%remote_build = val
    else
      a%remote_build = psb_matbld_remote_
    end if
  end subroutine psb_c_set_remote_build
        
  function psb_c_is_repeatable_updates(a) result(res)
    implicit none
    class(psb_cspmat_type), intent(in) :: a
    logical :: res

    if (allocated(a%a)) then
      res = a%a%is_repeatable_updates()
    else
      res = .false.
    end if

  end function psb_c_is_repeatable_updates

  subroutine psb_c_set_repeatable_updates(a,val)
    implicit none
    class(psb_cspmat_type), intent(inout) :: a
    logical, intent(in), optional :: val

    if (allocated(a%a)) then
      call a%a%set_repeatable_updates(val)
    end if

  end subroutine psb_c_set_repeatable_updates


  function psb_c_get_nzeros(a) result(res)
    implicit none
    class(psb_cspmat_type), intent(in) :: a
    integer(psb_ipk_) :: res

    res = 0
    if (allocated(a%a)) then
      res = a%a%get_nzeros()
    end if

  end function psb_c_get_nzeros

  function psb_c_get_size(a) result(res)

    implicit none
    class(psb_cspmat_type), intent(in) :: a
    integer(psb_ipk_) :: res


    res = 0
    if (allocated(a%a)) then
      res = a%a%get_size()
    end if

  end function psb_c_get_size


  function psb_c_get_nz_row(idx,a) result(res)
    implicit none
    integer(psb_ipk_), intent(in)               :: idx
    class(psb_cspmat_type), intent(in) :: a
    integer(psb_ipk_) :: res

    res = 0

    if (allocated(a%a)) res = a%a%get_nz_row(idx)

  end function psb_c_get_nz_row

  subroutine psb_c_clean_zeros(a,info)
    implicit none
    integer(psb_ipk_), intent(out)        :: info
    class(psb_cspmat_type), intent(inout) :: a

    info = 0
    if (allocated(a%a)) call a%a%clean_zeros(info)

  end subroutine psb_c_clean_zeros

#if defined(IPK4) && defined(LPK8)
  subroutine psb_c_lcsgetptn(imin,imax,a,nz,ia,ja,info,&
       & jmin,jmax,iren,append,nzin,rscale,cscale)
    implicit none
    class(psb_cspmat_type), intent(in) :: a
    integer(psb_ipk_), intent(in)                  :: imin,imax
    integer(psb_ipk_), intent(out)                 :: nz
    integer(psb_lpk_), allocatable, intent(inout)  :: ia(:), ja(:)
    integer(psb_ipk_),intent(out)                  :: info
    logical, intent(in), optional        :: append
    integer(psb_ipk_), intent(in), optional        :: iren(:)
    integer(psb_ipk_), intent(in), optional        :: jmin,jmax, nzin
    logical, intent(in), optional        :: rscale,cscale

    ! Local
    integer(psb_ipk_), allocatable :: lia(:), lja(:)

    info = psb_success_
    !
    ! Note: in principle we could use reallocate on assignment,
    ! but GCC bug 52162 forces us to take defensive programming.
    !
    if (allocated(ia)) then
      call psb_realloc(size(ia),lia,info)
      if (info == psb_success_) lia(:) = ia(:)
    end if
    if (allocated(ja)) then
      call psb_realloc(size(ja),lja,info)
      if (info == psb_success_) lja(:) = ja(:)
    end if
    call a%csget(imin,imax,nz,lia,lja,info,&
       & jmin,jmax,iren,append,nzin,rscale,cscale)

    call psb_ensure_size(size(lia),ia,info)
    if (info == psb_success_) ia(:) = lia(:)
    call psb_ensure_size(size(lja),ja,info)
    if (info == psb_success_) ja(:) = lja(:)

  end subroutine psb_c_lcsgetptn

  subroutine psb_c_lcsgetrow(imin,imax,a,nz,ia,ja,val,info,&
       & jmin,jmax,iren,append,nzin,rscale,cscale)
    implicit none
    class(psb_cspmat_type), intent(in) :: a
    integer(psb_ipk_), intent(in)                  :: imin,imax
    integer(psb_ipk_), intent(out)                 :: nz
    integer(psb_lpk_), allocatable, intent(inout)  :: ia(:), ja(:)
    complex(psb_spk_), allocatable,  intent(inout)    :: val(:)
    integer(psb_ipk_),intent(out)                  :: info
    logical, intent(in), optional        :: append
    integer(psb_ipk_), intent(in), optional        :: iren(:)
    integer(psb_ipk_), intent(in), optional        :: jmin,jmax, nzin
    logical, intent(in), optional        :: rscale,cscale
    ! Local
    integer(psb_ipk_), allocatable :: lia(:), lja(:)

    !
    ! Note: in principle we could use reallocate on assignment,
    ! but GCC bug 52162 forces us to take defensive programming.
    !
    if (allocated(ia)) then
      call psb_realloc(size(ia),lia,info)
      if (info == psb_success_) lia(:) = ia(:)
    end if
    if (allocated(ja)) then
      call psb_realloc(size(ja),lja,info)
      if (info == psb_success_) lja(:) = ja(:)
    end if

    call a%csget(imin,imax,nz,lia,lja,val,info,&
       & jmin,jmax,iren,append,nzin,rscale,cscale)

    call psb_ensure_size(size(lia),ia,info)
    if (info == psb_success_) ia(:) = lia(:)
    call psb_ensure_size(size(lja),ja,info)
    if (info == psb_success_) ja(:) = lja(:)

  end subroutine psb_c_lcsgetrow
#endif

  !
  ! lc methods
  !


  subroutine  psb_lc_set_mat_default(a)
    implicit none
    class(psb_lc_base_sparse_mat), intent(in) :: a

    if (allocated(psb_lc_base_mat_default)) then
      deallocate(psb_lc_base_mat_default)
    end if
    allocate(psb_lc_base_mat_default, mold=a)

  end subroutine psb_lc_set_mat_default

  function psb_lc_get_mat_default(a) result(res)
    implicit none
    class(psb_lcspmat_type), intent(in) :: a
    class(psb_lc_base_sparse_mat), pointer :: res

    res => psb_lc_get_base_mat_default()

  end function psb_lc_get_mat_default


  function psb_lc_get_base_mat_default() result(res)
    implicit none
    class(psb_lc_base_sparse_mat), pointer :: res

    if (.not.allocated(psb_lc_base_mat_default)) then
      allocate(psb_lc_csr_sparse_mat :: psb_lc_base_mat_default)
    end if

    res => psb_lc_base_mat_default

  end function psb_lc_get_base_mat_default

  subroutine  psb_lc_clear_mat_default() 
    implicit none 
    
    if (allocated(psb_lc_base_mat_default)) then 
      deallocate(psb_lc_base_mat_default)
    end if

  end subroutine psb_lc_clear_mat_default



  ! == ===================================
  !
  !
  !
  ! Getters
  !
  !
  !
  !
  !
  ! == ===================================


  function psb_lc_sizeof(a) result(res)
    implicit none
    class(psb_lcspmat_type), intent(in) :: a
    integer(psb_epk_) :: res

    res = 0
    if (allocated(a%a)) then
      res = a%a%sizeof()
    end if

  end function psb_lc_sizeof


  function psb_lc_get_fmt(a) result(res)
    implicit none
    class(psb_lcspmat_type), intent(in) :: a
    character(len=5) :: res

    if (allocated(a%a)) then
      res = a%a%get_fmt()
    else
      res = 'NULL'
    end if

  end function psb_lc_get_fmt


  function psb_lc_get_dupl(a) result(res)
    implicit none
    class(psb_lcspmat_type), intent(in) :: a
    integer(psb_ipk_) :: res

    if (allocated(a%a)) then
      res = a%a%get_dupl()
    else
      res = psb_invalid_
    end if
  end function psb_lc_get_dupl

  function psb_lc_get_nrows(a) result(res)
    implicit none
    class(psb_lcspmat_type), intent(in) :: a
    integer(psb_lpk_) :: res

    if (allocated(a%a)) then
      res = a%a%get_nrows()
    else
      res = 0
    end if

  end function psb_lc_get_nrows

  function psb_lc_get_ncols(a) result(res)
    implicit none
    class(psb_lcspmat_type), intent(in) :: a
    integer(psb_lpk_) :: res

    if (allocated(a%a)) then
      res = a%a%get_ncols()
    else
      res = 0
    end if

  end function psb_lc_get_ncols

  function psb_lc_is_triangle(a) result(res)
    implicit none
    class(psb_lcspmat_type), intent(in) :: a
    logical :: res

    if (allocated(a%a)) then
      res = a%a%is_triangle()
    else
      res = .false.
    end if

  end function psb_lc_is_triangle


  function psb_lc_is_symmetric(a) result(res)
    implicit none
    class(psb_lcspmat_type), intent(in) :: a
    logical :: res

    if (allocated(a%a)) then
      res = a%a%is_symmetric()
    else
      res = .false.
    end if

  end function psb_lc_is_symmetric

  function psb_lc_is_unit(a) result(res)
    implicit none
    class(psb_lcspmat_type), intent(in) :: a
    logical :: res

    if (allocated(a%a)) then
      res = a%a%is_unit()
    else
      res = .false.
    end if

  end function psb_lc_is_unit

  function psb_lc_is_upper(a) result(res)
    implicit none
    class(psb_lcspmat_type), intent(in) :: a
    logical :: res

    if (allocated(a%a)) then
      res = a%a%is_upper()
    else
      res = .false.
    end if

  end function psb_lc_is_upper

  function psb_lc_is_lower(a) result(res)
    implicit none
    class(psb_lcspmat_type), intent(in) :: a
    logical :: res

    if (allocated(a%a)) then
      res = .not. a%a%is_upper()
    else
      res = .false.
    end if

  end function psb_lc_is_lower

  function psb_lc_is_null(a) result(res)
    implicit none
    class(psb_lcspmat_type), intent(in) :: a
    logical :: res

    if (allocated(a%a)) then
      res = a%a%is_null()
    else
      res = .true.
    end if

  end function psb_lc_is_null

  function psb_lc_is_bld(a) result(res)
    implicit none
    class(psb_lcspmat_type), intent(in) :: a
    logical :: res

    if (allocated(a%a)) then
      res = a%a%is_bld()
    else
      res = .false.
    end if

  end function psb_lc_is_bld

  function psb_lc_is_upd(a) result(res)
    implicit none
    class(psb_lcspmat_type), intent(in) :: a
    logical :: res

    if (allocated(a%a)) then
      res = a%a%is_upd()
    else
      res = .false.
    end if

  end function psb_lc_is_upd

  function psb_lc_is_asb(a) result(res)
    implicit none
    class(psb_lcspmat_type), intent(in) :: a
    logical :: res

    if (allocated(a%a)) then
      res = a%a%is_asb()
    else
      res = .false.
    end if

  end function psb_lc_is_asb

  function psb_lc_is_sorted(a) result(res)
    implicit none
    class(psb_lcspmat_type), intent(in) :: a
    logical :: res

    if (allocated(a%a)) then
      res = a%a%is_sorted()
    else
      res = .false.
    end if

  end function psb_lc_is_sorted

  function psb_lc_is_by_rows(a) result(res)
    implicit none
    class(psb_lcspmat_type), intent(in) :: a
    logical :: res

    if (allocated(a%a)) then
      res = a%a%is_by_rows()
    else
      res = .false.
    end if

  end function psb_lc_is_by_rows

  function psb_lc_is_by_cols(a) result(res)
    implicit none
    class(psb_lcspmat_type), intent(in) :: a
    logical :: res

    if (allocated(a%a)) then
      res = a%a%is_by_cols()
    else
      res = .false.
    end if

  end function psb_lc_is_by_cols


  !
  subroutine lc_mat_sync(a)
    implicit none
    class(psb_lcspmat_type), target, intent(in) :: a

    if (allocated(a%a))  call a%a%sync()

  end subroutine lc_mat_sync

  !
  subroutine lc_mat_set_host(a)
    implicit none
    class(psb_lcspmat_type), intent(inout) :: a

    if (allocated(a%a))  call a%a%set_host()

  end subroutine lc_mat_set_host


  !
  subroutine lc_mat_set_dev(a)
    implicit none
    class(psb_lcspmat_type), intent(inout) :: a

    if (allocated(a%a))  call a%a%set_dev()

  end subroutine lc_mat_set_dev

  !
  subroutine lc_mat_set_sync(a)
    implicit none
    class(psb_lcspmat_type), intent(inout) :: a

    if (allocated(a%a))  call a%a%set_sync()

  end subroutine lc_mat_set_sync

  !
  function lc_mat_is_dev(a) result(res)
    implicit none
    class(psb_lcspmat_type), intent(in) :: a
    logical  :: res

    if (allocated(a%a)) then
      res = a%a%is_dev()
    else
      res = .false.
    end if
  end function lc_mat_is_dev

  !
  function lc_mat_is_host(a) result(res)
    implicit none
    class(psb_lcspmat_type), intent(in) :: a
    logical  :: res


    if (allocated(a%a)) then
      res = a%a%is_host()
    else
      res = .true.
    end if
  end function lc_mat_is_host

  !
  function lc_mat_is_sync(a) result(res)
    implicit none
    class(psb_lcspmat_type), intent(in) :: a
    logical  :: res


    if (allocated(a%a)) then
      res = a%a%is_sync()
    else
      res = .true.
    end if

  end function lc_mat_is_sync


  function psb_lc_is_repeatable_updates(a) result(res)
    implicit none
    class(psb_lcspmat_type), intent(in) :: a
    logical :: res

    if (allocated(a%a)) then
      res = a%a%is_repeatable_updates()
    else
      res = .false.
    end if

  end function psb_lc_is_repeatable_updates

  subroutine psb_lc_set_repeatable_updates(a,val)
    implicit none
    class(psb_lcspmat_type), intent(inout) :: a
    logical, intent(in), optional :: val

    if (allocated(a%a)) then
      call a%a%set_repeatable_updates(val)
    end if

  end subroutine psb_lc_set_repeatable_updates


  function psb_lc_get_nzeros(a) result(res)
    implicit none
    class(psb_lcspmat_type), intent(in) :: a
    integer(psb_lpk_) :: res

    res = 0
    if (allocated(a%a)) then
      res = a%a%get_nzeros()
    end if

  end function psb_lc_get_nzeros

  function psb_lc_get_size(a) result(res)

    implicit none
    class(psb_lcspmat_type), intent(in) :: a
    integer(psb_lpk_) :: res


    res = 0
    if (allocated(a%a)) then
      res = a%a%get_size()
    end if

  end function psb_lc_get_size


  function psb_lc_get_nz_row(idx,a) result(res)
    implicit none
    integer(psb_lpk_), intent(in)               :: idx
    class(psb_lcspmat_type), intent(in) :: a
    integer(psb_lpk_) :: res

    res = 0

    if (allocated(a%a)) res = a%a%get_nz_row(idx)

  end function psb_lc_get_nz_row

  subroutine psb_lc_clean_zeros(a,info)
    implicit none
    integer(psb_ipk_), intent(out)        :: info
    class(psb_lcspmat_type), intent(inout) :: a

    info = 0
    if (allocated(a%a)) call a%a%clean_zeros(info)

  end subroutine psb_lc_clean_zeros

#if defined(IPK4) && defined(LPK8)
!!$  subroutine psb_lc_icsgetptn(imin,imax,a,nz,ia,ja,info,&
!!$       & jmin,jmax,iren,append,nzin,rscale,cscale)
!!$    implicit none
!!$    class(psb_lcspmat_type), intent(in) :: a
!!$    integer(psb_ipk_), intent(in)                  :: imin,imax
!!$    integer(psb_ipk_), intent(out)                 :: nz
!!$    integer(psb_ipk_), allocatable, intent(inout)  :: ia(:), ja(:)
!!$    integer(psb_ipk_),intent(out)                  :: info
!!$    logical, intent(in), optional        :: append
!!$    integer(psb_ipk_), intent(in), optional        :: iren(:)
!!$    integer(psb_ipk_), intent(in), optional        :: jmin,jmax, nzin
!!$    logical, intent(in), optional        :: rscale,cscale
!!$
!!$    ! Local
!!$    integer(psb_lpk_), allocatable :: lia(:), lja(:)
!!$    integer(psb_lpk_) :: lnz
!!$
!!$    info = psb_success_
!!$    !
!!$    ! Note: in principle we could use reallocate on assignment,
!!$    ! but GCC bug 52162 forces us to take defensive programming.
!!$    !
!!$    if (allocated(ia)) then
!!$      call psb_realloc(size(ia),lia,info)
!!$      if (info == psb_success_) lia(:) = ia(:)
!!$    end if
!!$    if (allocated(ja)) then
!!$      call psb_realloc(size(ja),lja,info)
!!$      if (info == psb_success_) lja(:) = ja(:)
!!$    end if
!!$    lnz = nz
!!$    call a%csget(imin,imax,lnz,lia,lja,info,&
!!$       & jmin,jmax,iren,append,nzin,rscale,cscale)
!!$    nz = lnz
!!$    call psb_ensure_size(size(lia),ia,info)
!!$    if (info == psb_success_) ia(:) = lia(:)
!!$    call psb_ensure_size(size(lja),ja,info)
!!$    if (info == psb_success_) ja(:) = lja(:)
!!$
!!$  end subroutine psb_lc_icsgetptn
!!$
!!$  subroutine psb_lc_icsgetrow(imin,imax,a,nz,ia,ja,val,info,&
!!$       & jmin,jmax,iren,append,nzin,rscale,cscale)
!!$    implicit none
!!$    class(psb_lcspmat_type), intent(in) :: a
!!$    integer(psb_ipk_), intent(in)                  :: imin,imax
!!$    integer(psb_ipk_), intent(out)                 :: nz
!!$    integer(psb_ipk_), allocatable, intent(inout)  :: ia(:), ja(:)
!!$    complex(psb_spk_), allocatable,  intent(inout)    :: val(:)
!!$    integer(psb_ipk_),intent(out)                  :: info
!!$    logical, intent(in), optional        :: append
!!$    integer(psb_ipk_), intent(in), optional        :: iren(:)
!!$    integer(psb_ipk_), intent(in), optional        :: jmin,jmax, nzin
!!$    logical, intent(in), optional        :: rscale,cscale
!!$    ! Local
!!$    integer(psb_lpk_), allocatable :: lia(:), lja(:), liren(:)
!!$    integer(psb_lpk_) :: lnz
!!$
!!$    !
!!$    ! Note: in principle we could use reallocate on assignment,
!!$    ! but GCC bug 52162 forces us to take defensive programming.
!!$    !
!!$    if (allocated(ia)) then
!!$      call psb_realloc(size(ia),lia,info)
!!$      if (info == psb_success_) lia(:) = ia(:)
!!$    end if
!!$    if (allocated(ja)) then
!!$      call psb_realloc(size(ja),lja,info)
!!$      if (info == psb_success_) lja(:) = ja(:)
!!$    end if
!!$
!!$    lnz = nz
!!$    call a%csget(imin,imax,nz,lia,lja,val,info,&
!!$       & jmin,jmax,iren,append,nzin,rscale,cscale)
!!$    nz=lnz
!!$    call psb_ensure_size(size(lia),ia,info)
!!$    if (info == psb_success_) ia(:) = lia(:)
!!$    call psb_ensure_size(size(lja),ja,info)
!!$    if (info == psb_success_) ja(:) = lja(:)
!!$
!!$  end subroutine psb_lc_icsgetrow
#endif

end module psb_c_mat_mod