{"id":24790077,"url":"https://github.com/frbcesab/chessboard","last_synced_at":"2025-10-19T12:11:22.060Z","repository":{"id":47866777,"uuid":"516373963","full_name":"FRBCesab/chessboard","owner":"FRBCesab","description":":package: Create network connections based on chess moves","archived":false,"fork":false,"pushed_at":"2023-10-16T10:12:48.000Z","size":22650,"stargazers_count":5,"open_issues_count":0,"forks_count":1,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-10-03T13:39:02.527Z","etag":null,"topics":["connectivity-matrix","directed-networks","neighborhood","network","one-dimensional-networks","r-package","spatial-networks","two-dimensional-networks","undirected-networks"],"latest_commit_sha":null,"homepage":"https://frbcesab.github.io/chessboard","language":"R","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"gpl-2.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/FRBCesab.png","metadata":{"files":{"readme":"README.Rmd","changelog":"NEWS.md","contributing":"CONTRIBUTING.md","funding":null,"license":"LICENSE.md","code_of_conduct":"CODE_OF_CONDUCT.md","threat_model":null,"audit":null,"citation":"CITATION.cff","codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null}},"created_at":"2022-07-21T13:03:21.000Z","updated_at":"2025-06-24T02:52:30.000Z","dependencies_parsed_at":"2023-10-11T13:15:09.289Z","dependency_job_id":"8a73c716-aa51-4805-ba50-d2289cd192b1","html_url":"https://github.com/FRBCesab/chessboard","commit_stats":{"total_commits":311,"total_committers":2,"mean_commits":155.5,"dds":0.003215434083601254,"last_synced_commit":"8506b8b96ed0cf61f32bc831711681ab3d340af6"},"previous_names":[],"tags_count":1,"template":false,"template_full_name":null,"purl":"pkg:github/FRBCesab/chessboard","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/FRBCesab%2Fchessboard","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/FRBCesab%2Fchessboard/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/FRBCesab%2Fchessboard/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/FRBCesab%2Fchessboard/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/FRBCesab","download_url":"https://codeload.github.com/FRBCesab/chessboard/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/FRBCesab%2Fchessboard/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":278185387,"owners_count":25944568,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","status":"online","status_checked_at":"2025-10-03T02:00:06.070Z","response_time":53,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["connectivity-matrix","directed-networks","neighborhood","network","one-dimensional-networks","r-package","spatial-networks","two-dimensional-networks","undirected-networks"],"created_at":"2025-01-29T18:14:37.215Z","updated_at":"2025-10-12T14:30:50.683Z","avatar_url":"https://github.com/FRBCesab.png","language":"R","funding_links":[],"categories":[],"sub_categories":[],"readme":"---\noutput: github_document\n---\n\n\u003c!-- README.md is generated from README.Rmd. Please edit that file --\u003e\n\n\n```{r, include = FALSE}\nknitr::opts_chunk$set(collapse  = TRUE,\n                      comment   = \"#\u003e\",\n                      fig.path  = \"man/figures/\",\n                      out.width = \"100%\")\n```\n\n\n\nchessboard \u003cimg src=\"man/figures/package-sticker.png\" align=\"right\" style=\"float:right; height:120px;\"/\u003e\n=========================================================\n\n\u003c!-- badges: start --\u003e\n[![CRAN status](https://www.r-pkg.org/badges/version/chessboard)](https://CRAN.R-project.org/package=chessboard)\n[![R CMD Check](https://github.com/frbcesab/chessboard/actions/workflows/R-CMD-check.yaml/badge.svg)](https://github.com/frbcesab/chessboard/actions/workflows/R-CMD-check.yaml)\n[![codecov](https://codecov.io/gh/FRBCesab/chessboard/branch/main/graph/badge.svg?token=qH71uWUiot)](https://app.codecov.io/gh/FRBCesab/chessboard)\n[![Website](https://github.com/frbcesab/chessboard/actions/workflows/pkgdown.yaml/badge.svg)](https://github.com/frbcesab/chessboard/actions/workflows/pkgdown.yaml)\n[![License: GPL (\u003e= 2)](https://img.shields.io/badge/License-GPL%20%28%3E%3D%202%29-blue.svg)](https://choosealicense.com/licenses/gpl-2.0/)\n[![status](https://joss.theoj.org/papers/f709edaff050ed0cb1ffb8dd4ad2a1bb/status.svg)](https://joss.theoj.org/papers/10.21105/joss.05753)\n\u003c!-- badges: end --\u003e\n\n## Table of contents\n\n\u003cp align=\"left\"\u003e\n  • \u003ca href=\"#overview\"\u003eOverview\u003c/a\u003e\u003cbr\u003e\n  • \u003ca href=\"#features\"\u003eFeatures\u003c/a\u003e\u003cbr\u003e\n  • \u003ca href=\"#installation\"\u003eInstallation\u003c/a\u003e\u003cbr\u003e\n  • \u003ca href=\"#get-started\"\u003eGet started\u003c/a\u003e\u003cbr\u003e\n  • \u003ca href=\"#long-form-documentations\"\u003eLong-form documentations\u003c/a\u003e\u003cbr\u003e\n  • \u003ca href=\"#citation\"\u003eCitation\u003c/a\u003e\u003cbr\u003e\n  • \u003ca href=\"#contributing\"\u003eContributing\u003c/a\u003e\u003cbr\u003e\n  • \u003ca href=\"#acknowledgments\"\u003eAcknowledgments\u003c/a\u003e\u003cbr\u003e\n  • \u003ca href=\"#references\"\u003eReferences\u003c/a\u003e\n\u003c/p\u003e\n\n## Overview\n\nThe package `chessboard` provides functions to work with **directed**\n(asymmetric) and **undirected** (symmetric) spatial (or non-spatial) **networks**. \nIt implements different methods to detect neighbors, all based on the chess game\n(it goes beyond the rook and the queen) to create complex connectivity scenarios.\n\n`chessboard` can handle spatial networks, but it does not explicitly use geographical\ncoordinates to find neighbors (it is not based on spatial distance). \nInstead, it identifies neighbors according to **node labels**\n(i.e. the node position on a two-dimension chessboard) and a specific method \n(pawn, fool, rook, bishop, knight, queen, wizard, etc.).\n\nIt implements the following rules to detect neighbors and create edges:\n\n- the **degree** of neighborhood: the number of adjacent nodes that will be used\nto create direct edges.\n\n- the **orientation** of neighborhood: can neighbors be detected horizontally, \nvertically and/or diagonally?\n\n- the **direction** of neighborhood: does the sampling has a main direction? \nThis can be particularly relevant for directed networks (e.g. rivers).\n\n\n\n## Features\n\nThe main purpose of `chessboard` is to create various network objects, including:\n\n- **node list**\n- **edge list**\n- **connectivity matrix**\n\n`chessboard` also provides different plotting functions (all based on the [`ggplot2`](https://ggplot2.tidyverse.org/) package):\n\n- [`gg_matrix()`](https://frbcesab.github.io/chessboard/reference/gg_matrix.html)\nplots a (connectivity) matrix\n- [`gg_chessboard()`](https://frbcesab.github.io/chessboard/reference/gg_chessboard.html) \nplots the sampling as a chessboard\n\nRead the [Visualization tools](https://frbcesab.github.io/chessboard/articles/visualization-tools.html) \nvignette for further details.\n\n![](vignettes/figures/diagramme.png)\n\nFinally, the package can also produce objects that will be used later in\nMoran's Eigenvector Maps \n([MEM](https://rdrr.io/cran/adespatial/man/mem.html), \nDray _et al._ 2006) and Asymetric Eigenvector Maps \n([AEM](https://rdrr.io/cran/adespatial/man/aem.html),\nBlanchet _et al._ 2008), methods available in the package\n[`adespatial`](https://cran.r-project.org/package=adespatial) (Dray _et al._ 2023):\n\n- **edges weights matrix**\n- **spatial weights matrix**\n- **nodes by edges matrix**\n- **edges weights vector**\n\n\n## Installation\n\nYou can install the stable version from [CRAN](https://cran.r-project.org/) with:\n\n```{r eval=FALSE}\n## Install stable version of \u003c chessboard \u003e from CRAN ----\ninstall.packages(\"chessboard\")\n```\n\n\nOr you can install the development version from [GitHub](https://github.com/) with:\n\n```{r eval=FALSE}\n## Install \u003c remotes \u003e package (if not already installed) ----\nif (!requireNamespace(\"remotes\", quietly = TRUE)) {\n  install.packages(\"remotes\")\n}\n\n## Install dev version of \u003c chessboard \u003e from GitHub ----\nremotes::install_github(\"FRBCesab/chessboard\")\n```\n\nThen you can attach the package `chessboard`:\n\n```{r eval=FALSE}\nlibrary(\"chessboard\")\n```\n\n\n\n## Get started\n\nFor an overview of the main features of `chessboard`, please read the \n[Get started](https://frbcesab.github.io/chessboard/articles/chessboard.html)\nvignette.\n\n\n\n## Long-form documentations\n\n`chessboard` provides three vignettes to learn more about the package:\n\n- the [Get started](https://frbcesab.github.io/chessboard/articles/chessboard.html)\nvignette describes the core features of the package\n- the [Chess pieces](https://frbcesab.github.io/chessboard/articles/chess-pieces.html)\nvignette details the different methods implemented in `chessboard` to detect\nneighbors\n- the [Visualization tools](https://frbcesab.github.io/chessboard/articles/visualization-tools.html)\nvignette describes the plotting functions available in `chessboard`\n\n\n\n## Citation\n\nPlease cite `chessboard` as: \n\n\u003e Casajus N, Rievrs Borges E, Tabacchi E, Fried G \u0026 Mouquet N (2023) `chessboard`: An R \npackage for creating network connections based on chess moves. \n**_Journal of Open Source Software_**, _8_, 5753. \u003chttps://doi.org/10.21105/joss.05753\u003e.\n\n\n\n## Contributing\n\nAll types of contributions are encouraged and valued. For more information, \ncheck out our [Contributor Guidelines](https://github.com/FRBCesab/chessboard/blob/main/CONTRIBUTING.md).\n\nPlease note that the `chessboard` project is released with a \n[Contributor Code of Conduct](https://contributor-covenant.org/version/2/1/CODE_OF_CONDUCT.html). \nBy contributing to this project, you agree to abide by its terms.\n\n\n\n## Acknowledgments\n\nThis package has been developed for the \n[FRB-CESAB](https://www.fondationbiodiversite.fr/en/about-the-foundation/le-cesab/) \nworking group \n[Bridge](https://www.fondationbiodiversite.fr/en/the-frb-in-action/programs-and-projects/le-cesab/bridge/) \nthat aims to better understand the role of local and regional environmental \nfactors in shaping the taxonomic and functional diversity of plant communities \nestablished along river corridors, roadside corridors and cultivated field \nmargins.\n\n\n\n## References\n\nBlanchet FG, Legendre P \u0026 Borcard D (2008) Modelling directional spatial processes \nin ecological data. **Ecological Modelling**, 215, 325-336. \ndoi: [10.1016/j.ecolmodel.2008.04.001](https://doi.org/10.1016/j.ecolmodel.2008.04.001).\n\nCsardi G \u0026 Nepusz T (2006) The igraph software package for complex network research. \n**InterJournal, Complex Systems**, 1695, 1-9. \u003chttps://igraph.org/\u003e.\n\nDray S, Bauman D, Blanchet G _et al._ (2023) `adespatial`: Multivariate Multiscale Spatial Analysis. \nR package version 0.3-21, \u003chttps://CRAN.R-project.org/package=adespatial\u003e.\n\nDray S, Legendre P \u0026 Peres-Neto PR (2006) Spatial modeling: a comprehensive \nframework for principal coordinate analysis of neighbor matrices (PCNM). \n**Ecological Modelling**, 196: 483–93. \ndoi: [10.1016/j.ecolmodel.2006.02.015](https://doi.org/10.1016/j.ecolmodel.2006.02.015).\n\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ffrbcesab%2Fchessboard","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Ffrbcesab%2Fchessboard","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ffrbcesab%2Fchessboard/lists"}