Abdelrahman Said
288 lines
15 KiB
C
288 lines
15 KiB
C
/*
|
|
igraph library.
|
|
Copyright (C) 2010-2025 The igraph development team <igraph@igraph.org>
|
|
|
|
This program is free software; you can redistribute it and/or modify
|
|
it under the terms of the GNU General Public License as published by
|
|
the Free Software Foundation; either version 2 of the License, or
|
|
(at your option) any later version.
|
|
|
|
This program is distributed in the hope that it will be useful,
|
|
but WITHOUT ANY WARRANTY; without even the implied warranty of
|
|
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
|
|
GNU General Public License for more details.
|
|
|
|
You should have received a copy of the GNU General Public License
|
|
along with this program. If not, see <https://www.gnu.org/licenses/>.
|
|
*/
|
|
|
|
#ifndef IGRAPH_SPARSEMAT_H
|
|
#define IGRAPH_SPARSEMAT_H
|
|
|
|
#include "igraph_decls.h"
|
|
#include "igraph_error.h"
|
|
#include "igraph_types.h"
|
|
#include "igraph_vector.h"
|
|
#include "igraph_arpack.h"
|
|
|
|
#include <stdio.h>
|
|
|
|
IGRAPH_BEGIN_C_DECLS
|
|
|
|
/*
|
|
* These types are private to igraph, and customized to use igraph_int_t.
|
|
* Do not attempt to access them using a separate copy of the CXSparse library.
|
|
* Use the public igraph_sparsemat_... types instead.
|
|
*/
|
|
struct cs_igraph_sparse;
|
|
struct cs_igraph_symbolic;
|
|
struct cs_igraph_numeric;
|
|
|
|
typedef struct {
|
|
struct cs_igraph_sparse *cs;
|
|
} igraph_sparsemat_t;
|
|
|
|
typedef struct {
|
|
struct cs_igraph_symbolic *symbolic;
|
|
} igraph_sparsemat_symbolic_t;
|
|
|
|
typedef struct {
|
|
struct cs_igraph_numeric *numeric;
|
|
} igraph_sparsemat_numeric_t;
|
|
|
|
typedef enum { IGRAPH_SPARSEMAT_TRIPLET,
|
|
IGRAPH_SPARSEMAT_CC
|
|
} igraph_sparsemat_type_t;
|
|
|
|
typedef struct {
|
|
const igraph_sparsemat_t *mat;
|
|
igraph_int_t pos;
|
|
igraph_int_t col;
|
|
} igraph_sparsemat_iterator_t;
|
|
|
|
IGRAPH_EXPORT igraph_error_t igraph_sparsemat_init(
|
|
igraph_sparsemat_t *A, igraph_int_t rows, igraph_int_t cols,
|
|
igraph_int_t nzmax
|
|
);
|
|
IGRAPH_EXPORT igraph_error_t igraph_sparsemat_init_copy(
|
|
igraph_sparsemat_t *to, const igraph_sparsemat_t *from);
|
|
IGRAPH_EXPORT void igraph_sparsemat_destroy(igraph_sparsemat_t *A);
|
|
IGRAPH_EXPORT igraph_error_t igraph_sparsemat_realloc(igraph_sparsemat_t *A, igraph_int_t nzmax);
|
|
|
|
IGRAPH_EXPORT igraph_error_t igraph_sparsemat_init_eye(igraph_sparsemat_t *A,
|
|
igraph_int_t n, igraph_int_t nzmax,
|
|
igraph_real_t value, igraph_bool_t compress);
|
|
|
|
IGRAPH_EXPORT igraph_error_t igraph_sparsemat_init_diag(igraph_sparsemat_t *A,
|
|
igraph_int_t nzmax, const igraph_vector_t *values,
|
|
igraph_bool_t compress);
|
|
|
|
IGRAPH_EXPORT igraph_int_t igraph_sparsemat_nrow(const igraph_sparsemat_t *A);
|
|
IGRAPH_EXPORT igraph_int_t igraph_sparsemat_ncol(const igraph_sparsemat_t *B);
|
|
IGRAPH_EXPORT igraph_sparsemat_type_t igraph_sparsemat_type(const igraph_sparsemat_t *A);
|
|
IGRAPH_EXPORT igraph_bool_t igraph_sparsemat_is_triplet(const igraph_sparsemat_t *A);
|
|
IGRAPH_EXPORT igraph_bool_t igraph_sparsemat_is_cc(const igraph_sparsemat_t *A);
|
|
|
|
IGRAPH_EXPORT igraph_error_t igraph_sparsemat_permute(const igraph_sparsemat_t *A,
|
|
const igraph_vector_int_t *p,
|
|
const igraph_vector_int_t *q,
|
|
igraph_sparsemat_t *res);
|
|
|
|
IGRAPH_EXPORT igraph_real_t igraph_sparsemat_get(
|
|
const igraph_sparsemat_t *A, igraph_int_t row, igraph_int_t col
|
|
);
|
|
IGRAPH_EXPORT igraph_error_t igraph_sparsemat_index(const igraph_sparsemat_t *A,
|
|
const igraph_vector_int_t *p,
|
|
const igraph_vector_int_t *q,
|
|
igraph_sparsemat_t *res,
|
|
igraph_real_t *constres);
|
|
|
|
IGRAPH_EXPORT igraph_error_t igraph_sparsemat_entry(igraph_sparsemat_t *A,
|
|
igraph_int_t row, igraph_int_t col, igraph_real_t elem);
|
|
IGRAPH_EXPORT igraph_error_t igraph_sparsemat_compress(const igraph_sparsemat_t *A,
|
|
igraph_sparsemat_t *res);
|
|
IGRAPH_EXPORT igraph_error_t igraph_sparsemat_transpose(
|
|
const igraph_sparsemat_t *A, igraph_sparsemat_t *res
|
|
);
|
|
IGRAPH_EXPORT igraph_error_t igraph_sparsemat_is_symmetric(const igraph_sparsemat_t *A, igraph_bool_t *result);
|
|
IGRAPH_EXPORT igraph_error_t igraph_sparsemat_dupl(igraph_sparsemat_t *A);
|
|
IGRAPH_EXPORT igraph_error_t igraph_sparsemat_fkeep(igraph_sparsemat_t *A,
|
|
igraph_int_t (*fkeep)(igraph_int_t, igraph_int_t, igraph_real_t, void*),
|
|
void *other);
|
|
IGRAPH_EXPORT igraph_error_t igraph_sparsemat_dropzeros(igraph_sparsemat_t *A);
|
|
IGRAPH_EXPORT igraph_error_t igraph_sparsemat_droptol(igraph_sparsemat_t *A, igraph_real_t tol);
|
|
IGRAPH_EXPORT igraph_error_t igraph_sparsemat_multiply(const igraph_sparsemat_t *A,
|
|
const igraph_sparsemat_t *B,
|
|
igraph_sparsemat_t *res);
|
|
IGRAPH_EXPORT igraph_error_t igraph_sparsemat_add(const igraph_sparsemat_t *A,
|
|
const igraph_sparsemat_t *B,
|
|
igraph_real_t alpha,
|
|
igraph_real_t beta,
|
|
igraph_sparsemat_t *res);
|
|
IGRAPH_EXPORT igraph_error_t igraph_sparsemat_gaxpy(const igraph_sparsemat_t *A,
|
|
const igraph_vector_t *x,
|
|
igraph_vector_t *res);
|
|
|
|
IGRAPH_EXPORT igraph_error_t igraph_sparsemat_lsolve(const igraph_sparsemat_t *A,
|
|
const igraph_vector_t *b,
|
|
igraph_vector_t *res);
|
|
IGRAPH_EXPORT igraph_error_t igraph_sparsemat_ltsolve(const igraph_sparsemat_t *A,
|
|
const igraph_vector_t *b,
|
|
igraph_vector_t *res);
|
|
IGRAPH_EXPORT igraph_error_t igraph_sparsemat_usolve(const igraph_sparsemat_t *A,
|
|
const igraph_vector_t *b,
|
|
igraph_vector_t *res);
|
|
IGRAPH_EXPORT igraph_error_t igraph_sparsemat_utsolve(const igraph_sparsemat_t *A,
|
|
const igraph_vector_t *b,
|
|
igraph_vector_t *res);
|
|
|
|
IGRAPH_EXPORT igraph_error_t igraph_sparsemat_cholsol(const igraph_sparsemat_t *A,
|
|
const igraph_vector_t *b,
|
|
igraph_vector_t *res,
|
|
igraph_int_t order);
|
|
|
|
IGRAPH_EXPORT igraph_error_t igraph_sparsemat_lusol(const igraph_sparsemat_t *A,
|
|
const igraph_vector_t *b,
|
|
igraph_vector_t *res,
|
|
igraph_int_t order,
|
|
igraph_real_t tol);
|
|
|
|
IGRAPH_EXPORT igraph_error_t igraph_sparsemat_print(const igraph_sparsemat_t *A,
|
|
FILE *outstream);
|
|
|
|
IGRAPH_EXPORT igraph_error_t igraph_matrix_as_sparsemat(igraph_sparsemat_t *res,
|
|
const igraph_matrix_t *mat,
|
|
igraph_real_t tol);
|
|
|
|
IGRAPH_EXPORT igraph_error_t igraph_sparsemat_as_matrix(igraph_matrix_t *res,
|
|
const igraph_sparsemat_t *spmat);
|
|
|
|
typedef enum { IGRAPH_SPARSEMAT_SOLVE_LU,
|
|
IGRAPH_SPARSEMAT_SOLVE_QR
|
|
} igraph_sparsemat_solve_t;
|
|
|
|
IGRAPH_EXPORT igraph_error_t igraph_sparsemat_arpack_rssolve(const igraph_sparsemat_t *A,
|
|
igraph_arpack_options_t *options,
|
|
igraph_arpack_storage_t *storage,
|
|
igraph_vector_t *values,
|
|
igraph_matrix_t *vectors,
|
|
igraph_sparsemat_solve_t solvemethod);
|
|
|
|
IGRAPH_EXPORT igraph_error_t igraph_sparsemat_arpack_rnsolve(const igraph_sparsemat_t *A,
|
|
igraph_arpack_options_t *options,
|
|
igraph_arpack_storage_t *storage,
|
|
igraph_matrix_t *values,
|
|
igraph_matrix_t *vectors);
|
|
|
|
IGRAPH_EXPORT igraph_error_t igraph_sparsemat_lu(const igraph_sparsemat_t *A,
|
|
const igraph_sparsemat_symbolic_t *dis,
|
|
igraph_sparsemat_numeric_t *din, double tol);
|
|
|
|
IGRAPH_EXPORT igraph_error_t igraph_sparsemat_qr(const igraph_sparsemat_t *A,
|
|
const igraph_sparsemat_symbolic_t *dis,
|
|
igraph_sparsemat_numeric_t *din);
|
|
|
|
IGRAPH_EXPORT igraph_error_t igraph_sparsemat_luresol(const igraph_sparsemat_symbolic_t *dis,
|
|
const igraph_sparsemat_numeric_t *din,
|
|
const igraph_vector_t *b,
|
|
igraph_vector_t *res);
|
|
|
|
IGRAPH_EXPORT igraph_error_t igraph_sparsemat_qrresol(const igraph_sparsemat_symbolic_t *dis,
|
|
const igraph_sparsemat_numeric_t *din,
|
|
const igraph_vector_t *b,
|
|
igraph_vector_t *res);
|
|
|
|
IGRAPH_EXPORT igraph_error_t igraph_sparsemat_symbqr(igraph_int_t order, const igraph_sparsemat_t *A,
|
|
igraph_sparsemat_symbolic_t *dis);
|
|
|
|
IGRAPH_EXPORT igraph_error_t igraph_sparsemat_symblu(igraph_int_t order, const igraph_sparsemat_t *A,
|
|
igraph_sparsemat_symbolic_t *dis);
|
|
|
|
|
|
IGRAPH_EXPORT void igraph_sparsemat_symbolic_destroy(igraph_sparsemat_symbolic_t *dis);
|
|
IGRAPH_EXPORT void igraph_sparsemat_numeric_destroy(igraph_sparsemat_numeric_t *din);
|
|
|
|
IGRAPH_EXPORT igraph_real_t igraph_sparsemat_max(igraph_sparsemat_t *A);
|
|
IGRAPH_EXPORT igraph_real_t igraph_sparsemat_min(igraph_sparsemat_t *A);
|
|
IGRAPH_EXPORT igraph_error_t igraph_sparsemat_minmax(igraph_sparsemat_t *A,
|
|
igraph_real_t *min, igraph_real_t *max);
|
|
|
|
IGRAPH_EXPORT igraph_int_t igraph_sparsemat_count_nonzero(igraph_sparsemat_t *A);
|
|
IGRAPH_EXPORT igraph_int_t igraph_sparsemat_count_nonzerotol(igraph_sparsemat_t *A,
|
|
igraph_real_t tol);
|
|
IGRAPH_EXPORT igraph_error_t igraph_sparsemat_rowsums(const igraph_sparsemat_t *A,
|
|
igraph_vector_t *res);
|
|
IGRAPH_EXPORT igraph_error_t igraph_sparsemat_colsums(const igraph_sparsemat_t *A,
|
|
igraph_vector_t *res);
|
|
|
|
IGRAPH_EXPORT igraph_error_t igraph_sparsemat_rowmins(igraph_sparsemat_t *A,
|
|
igraph_vector_t *res);
|
|
IGRAPH_EXPORT igraph_error_t igraph_sparsemat_colmins(igraph_sparsemat_t *A,
|
|
igraph_vector_t *res);
|
|
|
|
IGRAPH_EXPORT igraph_error_t igraph_sparsemat_rowmaxs(igraph_sparsemat_t *A,
|
|
igraph_vector_t *res);
|
|
IGRAPH_EXPORT igraph_error_t igraph_sparsemat_colmaxs(igraph_sparsemat_t *A,
|
|
igraph_vector_t *res);
|
|
|
|
IGRAPH_EXPORT igraph_error_t igraph_sparsemat_which_min_rows(igraph_sparsemat_t *A,
|
|
igraph_vector_t *res,
|
|
igraph_vector_int_t *pos);
|
|
IGRAPH_EXPORT igraph_error_t igraph_sparsemat_which_min_cols(igraph_sparsemat_t *A,
|
|
igraph_vector_t *res,
|
|
igraph_vector_int_t *pos);
|
|
|
|
IGRAPH_EXPORT igraph_error_t igraph_sparsemat_scale(igraph_sparsemat_t *A, igraph_real_t by);
|
|
|
|
|
|
IGRAPH_EXPORT igraph_error_t igraph_sparsemat_add_rows(igraph_sparsemat_t *A, igraph_int_t n);
|
|
IGRAPH_EXPORT igraph_error_t igraph_sparsemat_add_cols(igraph_sparsemat_t *A, igraph_int_t n);
|
|
IGRAPH_EXPORT igraph_error_t igraph_sparsemat_resize(igraph_sparsemat_t *A,
|
|
igraph_int_t nrow, igraph_int_t ncol, igraph_int_t nzmax);
|
|
IGRAPH_EXPORT igraph_int_t igraph_sparsemat_nonzero_storage(const igraph_sparsemat_t *A);
|
|
IGRAPH_EXPORT igraph_error_t igraph_sparsemat_getelements(const igraph_sparsemat_t *A,
|
|
igraph_vector_int_t *i,
|
|
igraph_vector_int_t *j,
|
|
igraph_vector_t *x);
|
|
IGRAPH_EXPORT igraph_error_t igraph_sparsemat_getelements_sorted(const igraph_sparsemat_t *A,
|
|
igraph_vector_int_t *i,
|
|
igraph_vector_int_t *j,
|
|
igraph_vector_t *x);
|
|
IGRAPH_EXPORT igraph_error_t igraph_sparsemat_scale_rows(igraph_sparsemat_t *A,
|
|
const igraph_vector_t *fact);
|
|
IGRAPH_EXPORT igraph_error_t igraph_sparsemat_scale_cols(igraph_sparsemat_t *A,
|
|
const igraph_vector_t *fact);
|
|
IGRAPH_EXPORT igraph_error_t igraph_sparsemat_multiply_by_dense(const igraph_sparsemat_t *A,
|
|
const igraph_matrix_t *B,
|
|
igraph_matrix_t *res);
|
|
IGRAPH_EXPORT igraph_error_t igraph_sparsemat_dense_multiply(const igraph_matrix_t *A,
|
|
const igraph_sparsemat_t *B,
|
|
igraph_matrix_t *res);
|
|
|
|
IGRAPH_EXPORT igraph_error_t igraph_sparsemat_sort(const igraph_sparsemat_t *A,
|
|
igraph_sparsemat_t *sorted);
|
|
|
|
IGRAPH_EXPORT igraph_int_t igraph_sparsemat_nzmax(const igraph_sparsemat_t *A);
|
|
|
|
IGRAPH_EXPORT igraph_error_t igraph_sparsemat_neg(igraph_sparsemat_t *A);
|
|
|
|
IGRAPH_EXPORT igraph_error_t igraph_sparsemat_normalize_cols(igraph_sparsemat_t *sparsemat,
|
|
igraph_bool_t allow_zeros);
|
|
IGRAPH_EXPORT igraph_error_t igraph_sparsemat_normalize_rows(igraph_sparsemat_t *sparsemat,
|
|
igraph_bool_t allow_zeros);
|
|
|
|
IGRAPH_EXPORT igraph_error_t igraph_sparsemat_iterator_init(
|
|
igraph_sparsemat_iterator_t *it, const igraph_sparsemat_t *sparsemat
|
|
);
|
|
IGRAPH_EXPORT igraph_error_t igraph_sparsemat_iterator_reset(igraph_sparsemat_iterator_t *it);
|
|
IGRAPH_EXPORT igraph_bool_t igraph_sparsemat_iterator_end(const igraph_sparsemat_iterator_t *it);
|
|
IGRAPH_EXPORT igraph_int_t igraph_sparsemat_iterator_row(const igraph_sparsemat_iterator_t *it);
|
|
IGRAPH_EXPORT igraph_int_t igraph_sparsemat_iterator_col(const igraph_sparsemat_iterator_t *it);
|
|
IGRAPH_EXPORT igraph_int_t igraph_sparsemat_iterator_idx(const igraph_sparsemat_iterator_t *it);
|
|
IGRAPH_EXPORT igraph_real_t igraph_sparsemat_iterator_get(const igraph_sparsemat_iterator_t *it);
|
|
IGRAPH_EXPORT igraph_int_t igraph_sparsemat_iterator_next(igraph_sparsemat_iterator_t *it);
|
|
|
|
IGRAPH_END_C_DECLS
|
|
|
|
#endif
|