Add graph references
This commit is contained in:
Abdelrahman Said
@@ -0,0 +1,293 @@
|
||||
/*
|
||||
igraph library.
|
||||
Copyright (C) 2009-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_LAYOUT_H
|
||||
#define IGRAPH_LAYOUT_H
|
||||
|
||||
#include "igraph_decls.h"
|
||||
#include "igraph_constants.h"
|
||||
#include "igraph_datatype.h"
|
||||
#include "igraph_error.h"
|
||||
#include "igraph_iterators.h"
|
||||
#include "igraph_matrix.h"
|
||||
#include "igraph_matrix_list.h"
|
||||
#include "igraph_types.h"
|
||||
#include "igraph_vector.h"
|
||||
#include "igraph_vector_ptr.h"
|
||||
|
||||
IGRAPH_BEGIN_C_DECLS
|
||||
|
||||
/**
|
||||
* \section about_layouts
|
||||
*
|
||||
* <para>Layout generator functions (or at least most of them) try to place the
|
||||
* vertices and edges of a graph on a 2D plane or in 3D space in a way
|
||||
* which visually pleases the human eye.</para>
|
||||
*
|
||||
* <para>They take a graph object and a number of parameters as arguments
|
||||
* and return an \type igraph_matrix_t, in which each row gives the
|
||||
* coordinates of a vertex.</para>
|
||||
*/
|
||||
|
||||
/* -------------------------------------------------- */
|
||||
/* Layouts */
|
||||
/* -------------------------------------------------- */
|
||||
|
||||
IGRAPH_EXPORT igraph_error_t igraph_layout_random(const igraph_t *graph, igraph_matrix_t *res);
|
||||
IGRAPH_EXPORT igraph_error_t igraph_layout_circle(const igraph_t *graph, igraph_matrix_t *res,
|
||||
igraph_vs_t order);
|
||||
IGRAPH_EXPORT igraph_error_t igraph_layout_star(const igraph_t *graph, igraph_matrix_t *res,
|
||||
igraph_int_t center, const igraph_vector_int_t *order);
|
||||
IGRAPH_EXPORT igraph_error_t igraph_layout_grid(const igraph_t *graph, igraph_matrix_t *res, igraph_int_t width);
|
||||
IGRAPH_EXPORT igraph_error_t igraph_layout_fruchterman_reingold(const igraph_t *graph,
|
||||
igraph_matrix_t *res,
|
||||
igraph_bool_t use_seed,
|
||||
igraph_int_t niter,
|
||||
igraph_real_t start_temp,
|
||||
igraph_layout_grid_t grid,
|
||||
const igraph_vector_t *weights,
|
||||
const igraph_vector_t *minx,
|
||||
const igraph_vector_t *maxx,
|
||||
const igraph_vector_t *miny,
|
||||
const igraph_vector_t *maxy);
|
||||
|
||||
IGRAPH_EXPORT igraph_error_t igraph_layout_kamada_kawai(const igraph_t *graph, igraph_matrix_t *res,
|
||||
igraph_bool_t use_seed, igraph_int_t maxiter,
|
||||
igraph_real_t epsilon, igraph_real_t kkconst,
|
||||
const igraph_vector_t *weights,
|
||||
const igraph_vector_t *minx, const igraph_vector_t *maxx,
|
||||
const igraph_vector_t *miny, const igraph_vector_t *maxy);
|
||||
|
||||
IGRAPH_EXPORT igraph_error_t igraph_layout_lgl(const igraph_t *graph, igraph_matrix_t *res,
|
||||
igraph_int_t maxiter, igraph_real_t maxdelta,
|
||||
igraph_real_t area, igraph_real_t coolexp,
|
||||
igraph_real_t repulserad, igraph_real_t cellsize, igraph_int_t root);
|
||||
IGRAPH_EXPORT igraph_error_t igraph_layout_reingold_tilford(const igraph_t *graph, igraph_matrix_t *res,
|
||||
igraph_neimode_t mode,
|
||||
const igraph_vector_int_t *roots,
|
||||
const igraph_vector_int_t *rootlevel);
|
||||
IGRAPH_EXPORT igraph_error_t igraph_layout_reingold_tilford_circular(const igraph_t *graph,
|
||||
igraph_matrix_t *res,
|
||||
igraph_neimode_t mode,
|
||||
const igraph_vector_int_t *roots,
|
||||
const igraph_vector_int_t *rootlevel);
|
||||
IGRAPH_EXPORT igraph_error_t igraph_layout_sugiyama(
|
||||
const igraph_t *graph, igraph_matrix_t *res, igraph_matrix_list_t *routing,
|
||||
const igraph_vector_int_t* layers, igraph_real_t hgap,
|
||||
igraph_real_t vgap, igraph_int_t maxiter, const igraph_vector_t *weights);
|
||||
|
||||
IGRAPH_EXPORT igraph_error_t igraph_layout_random_3d(const igraph_t *graph, igraph_matrix_t *res);
|
||||
IGRAPH_EXPORT igraph_error_t igraph_layout_sphere(const igraph_t *graph, igraph_matrix_t *res);
|
||||
IGRAPH_EXPORT igraph_error_t igraph_layout_grid_3d(const igraph_t *graph, igraph_matrix_t *res,
|
||||
igraph_int_t width, igraph_int_t height);
|
||||
IGRAPH_EXPORT igraph_error_t igraph_layout_fruchterman_reingold_3d(const igraph_t *graph,
|
||||
igraph_matrix_t *res,
|
||||
igraph_bool_t use_seed,
|
||||
igraph_int_t niter,
|
||||
igraph_real_t start_temp,
|
||||
const igraph_vector_t *weights,
|
||||
const igraph_vector_t *minx,
|
||||
const igraph_vector_t *maxx,
|
||||
const igraph_vector_t *miny,
|
||||
const igraph_vector_t *maxy,
|
||||
const igraph_vector_t *minz,
|
||||
const igraph_vector_t *maxz);
|
||||
|
||||
IGRAPH_EXPORT igraph_error_t igraph_layout_kamada_kawai_3d(const igraph_t *graph, igraph_matrix_t *res,
|
||||
igraph_bool_t use_seed, igraph_int_t maxiter,
|
||||
igraph_real_t epsilon, igraph_real_t kkconst,
|
||||
const igraph_vector_t *weights,
|
||||
const igraph_vector_t *minx, const igraph_vector_t *maxx,
|
||||
const igraph_vector_t *miny, const igraph_vector_t *maxy,
|
||||
const igraph_vector_t *minz, const igraph_vector_t *maxz);
|
||||
|
||||
IGRAPH_EXPORT igraph_error_t igraph_layout_graphopt(const igraph_t *graph,
|
||||
igraph_matrix_t *res, igraph_int_t niter,
|
||||
igraph_real_t node_charge, igraph_real_t node_mass,
|
||||
igraph_real_t spring_length,
|
||||
igraph_real_t spring_constant,
|
||||
igraph_real_t max_sa_movement,
|
||||
igraph_bool_t use_seed);
|
||||
|
||||
IGRAPH_EXPORT igraph_error_t igraph_layout_mds(const igraph_t *graph, igraph_matrix_t *res,
|
||||
const igraph_matrix_t *dist, igraph_int_t dim);
|
||||
|
||||
IGRAPH_EXPORT igraph_error_t igraph_layout_bipartite(const igraph_t *graph,
|
||||
const igraph_vector_bool_t *types,
|
||||
igraph_matrix_t *res, igraph_real_t hgap,
|
||||
igraph_real_t vgap, igraph_int_t maxiter);
|
||||
|
||||
IGRAPH_EXPERIMENTAL IGRAPH_EXPORT igraph_error_t igraph_layout_umap(const igraph_t *graph,
|
||||
igraph_matrix_t *res,
|
||||
igraph_bool_t use_seed,
|
||||
const igraph_vector_t *distances,
|
||||
igraph_real_t min_dist,
|
||||
igraph_int_t epochs,
|
||||
igraph_bool_t distances_are_weights);
|
||||
|
||||
IGRAPH_EXPERIMENTAL IGRAPH_EXPORT igraph_error_t igraph_layout_umap_3d(const igraph_t *graph,
|
||||
igraph_matrix_t *res,
|
||||
igraph_bool_t use_seed,
|
||||
const igraph_vector_t *distances,
|
||||
igraph_real_t min_dist,
|
||||
igraph_int_t epochs,
|
||||
igraph_bool_t distances_are_weights);
|
||||
|
||||
IGRAPH_EXPERIMENTAL IGRAPH_EXPORT igraph_error_t igraph_layout_umap_compute_weights(const igraph_t *graph,
|
||||
const igraph_vector_t *distances,
|
||||
igraph_vector_t *weights);
|
||||
|
||||
|
||||
/**
|
||||
* \struct igraph_layout_drl_options_t
|
||||
* Parameters for the DrL layout generator
|
||||
*
|
||||
* \member edge_cut The edge cutting parameter.
|
||||
* Edge cutting is done in the late stages of the
|
||||
* algorithm in order to achieve less dense layouts. Edges are cut
|
||||
* if there is a lot of stress on them (a large value in the
|
||||
* objective function sum). The edge cutting parameter is a value
|
||||
* between 0 and 1 with 0 representing no edge cutting and 1
|
||||
* representing maximal edge cutting. The default value is 32/40.
|
||||
* \member init_iterations Number of iterations, initial phase.
|
||||
* \member init_temperature Start temperature, initial phase.
|
||||
* \member init_attraction Attraction, initial phase.
|
||||
* \member init_damping_mult Damping factor, initial phase.
|
||||
* \member liquid_iterations Number of iterations in the liquid phase.
|
||||
* \member liquid_temperature Start temperature in the liquid phase.
|
||||
* \member liquid_attraction Attraction in the liquid phase.
|
||||
* \member liquid_damping_mult Multiplicatie damping factor, liquid phase.
|
||||
* \member expansion_iterations Number of iterations in the expansion phase.
|
||||
* \member expansion_temperature Start temperature in the expansion phase.
|
||||
* \member expansion_attraction Attraction, expansion phase.
|
||||
* \member expansion_damping_mult Damping factor, expansion phase.
|
||||
* \member cooldown_iterations Number of iterations in the cooldown phase.
|
||||
* \member cooldown_temperature Start temperature in the cooldown phase.
|
||||
* \member cooldown_attraction Attraction in the cooldown phase.
|
||||
* \member cooldown_damping_mult Damping fact int the cooldown phase.
|
||||
* \member crunch_iterations Number of iterations in the crunch phase.
|
||||
* \member crunch_temperature Start temperature in the crunch phase.
|
||||
* \member crunch_attraction Attraction in the crunch phase.
|
||||
* \member crunch_damping_mult Damping factor in the crunch phase.
|
||||
* \member simmer_iterations Number of iterations in the simmer phase.
|
||||
* \member simmer_temperature Start temperature in te simmer phase.
|
||||
* \member simmer_attraction Attraction in the simmer phase.
|
||||
* \member simmer_damping_mult Multiplicative damping factor in the simmer phase.
|
||||
*/
|
||||
|
||||
typedef struct igraph_layout_drl_options_t {
|
||||
igraph_real_t edge_cut;
|
||||
igraph_int_t init_iterations;
|
||||
igraph_real_t init_temperature;
|
||||
igraph_real_t init_attraction;
|
||||
igraph_real_t init_damping_mult;
|
||||
igraph_int_t liquid_iterations;
|
||||
igraph_real_t liquid_temperature;
|
||||
igraph_real_t liquid_attraction;
|
||||
igraph_real_t liquid_damping_mult;
|
||||
igraph_int_t expansion_iterations;
|
||||
igraph_real_t expansion_temperature;
|
||||
igraph_real_t expansion_attraction;
|
||||
igraph_real_t expansion_damping_mult;
|
||||
igraph_int_t cooldown_iterations;
|
||||
igraph_real_t cooldown_temperature;
|
||||
igraph_real_t cooldown_attraction;
|
||||
igraph_real_t cooldown_damping_mult;
|
||||
igraph_int_t crunch_iterations;
|
||||
igraph_real_t crunch_temperature;
|
||||
igraph_real_t crunch_attraction;
|
||||
igraph_real_t crunch_damping_mult;
|
||||
igraph_int_t simmer_iterations;
|
||||
igraph_real_t simmer_temperature;
|
||||
igraph_real_t simmer_attraction;
|
||||
igraph_real_t simmer_damping_mult;
|
||||
} igraph_layout_drl_options_t;
|
||||
|
||||
/**
|
||||
* \typedef igraph_layout_drl_default_t
|
||||
* Predefined parameter templates for the DrL layout generator
|
||||
*
|
||||
* These constants can be used to initialize a set of DrL parameters.
|
||||
* These can then be modified according to the user's needs.
|
||||
* \enumval IGRAPH_LAYOUT_DRL_DEFAULT The deafult parameters.
|
||||
* \enumval IGRAPH_LAYOUT_DRL_COARSEN Slightly modified parameters to
|
||||
* get a coarser layout.
|
||||
* \enumval IGRAPH_LAYOUT_DRL_COARSEST An even coarser layout.
|
||||
* \enumval IGRAPH_LAYOUT_DRL_REFINE Refine an already calculated layout.
|
||||
* \enumval IGRAPH_LAYOUT_DRL_FINAL Finalize an already refined layout.
|
||||
*/
|
||||
|
||||
typedef enum { IGRAPH_LAYOUT_DRL_DEFAULT = 0,
|
||||
IGRAPH_LAYOUT_DRL_COARSEN,
|
||||
IGRAPH_LAYOUT_DRL_COARSEST,
|
||||
IGRAPH_LAYOUT_DRL_REFINE,
|
||||
IGRAPH_LAYOUT_DRL_FINAL
|
||||
} igraph_layout_drl_default_t;
|
||||
|
||||
IGRAPH_EXPORT igraph_error_t igraph_layout_drl_options_init(igraph_layout_drl_options_t *options,
|
||||
igraph_layout_drl_default_t templ);
|
||||
IGRAPH_EXPORT igraph_error_t igraph_layout_drl(const igraph_t *graph, igraph_matrix_t *res,
|
||||
igraph_bool_t use_seed,
|
||||
const igraph_layout_drl_options_t *options,
|
||||
const igraph_vector_t *weights);
|
||||
|
||||
IGRAPH_EXPORT igraph_error_t igraph_layout_drl_3d(const igraph_t *graph, igraph_matrix_t *res,
|
||||
igraph_bool_t use_seed,
|
||||
const igraph_layout_drl_options_t *options,
|
||||
const igraph_vector_t *weights);
|
||||
|
||||
IGRAPH_EXPORT igraph_error_t igraph_layout_merge_dla(const igraph_vector_ptr_t *graphs,
|
||||
const igraph_matrix_list_t *coords,
|
||||
igraph_matrix_t *res);
|
||||
|
||||
IGRAPH_EXPORT igraph_error_t igraph_layout_gem(const igraph_t *graph, igraph_matrix_t *res,
|
||||
igraph_bool_t use_seed, igraph_int_t maxiter,
|
||||
igraph_real_t temp_max, igraph_real_t temp_min,
|
||||
igraph_real_t temp_init);
|
||||
|
||||
IGRAPH_EXPORT igraph_error_t igraph_layout_davidson_harel(const igraph_t *graph, igraph_matrix_t *res,
|
||||
igraph_bool_t use_seed, igraph_int_t maxiter,
|
||||
igraph_int_t fineiter, igraph_real_t cool_fact,
|
||||
igraph_real_t weight_node_dist, igraph_real_t weight_border,
|
||||
igraph_real_t weight_edge_lengths,
|
||||
igraph_real_t weight_edge_crossings,
|
||||
igraph_real_t weight_node_edge_dist);
|
||||
|
||||
/**
|
||||
* \typedef igraph_root_choice_t
|
||||
* \brief Root choice heuristic for tree visualizations.
|
||||
*
|
||||
* Used with \ref igraph_roots_for_tree_layout().
|
||||
*/
|
||||
|
||||
typedef enum {
|
||||
IGRAPH_ROOT_CHOICE_DEGREE,
|
||||
IGRAPH_ROOT_CHOICE_ECCENTRICITY
|
||||
} igraph_root_choice_t;
|
||||
|
||||
IGRAPH_EXPORT igraph_error_t igraph_roots_for_tree_layout(
|
||||
const igraph_t *graph,
|
||||
igraph_neimode_t mode,
|
||||
igraph_vector_int_t *roots,
|
||||
igraph_root_choice_t use_eccentricity);
|
||||
|
||||
IGRAPH_EXPORT igraph_error_t igraph_layout_align(const igraph_t *graph, igraph_matrix_t *layout);
|
||||
|
||||
IGRAPH_END_C_DECLS
|
||||
|
||||
#endif
|
||||
Reference in New Issue
Block a user