# Welcome to MacSyFinder’s documentation!

Note

A new version of MacSyFinder (v2) is available, see here for an overview of the novelties. The search engine was changed, and some bugs/unwanted behaviors corrected. MacSyFinder’s models for v2 are very similar, yet not compatible with those from v1. See here for details on how to carry your models to v2.

The search engine of v2 being much different from that of v1, we strongly suggest to test whether the results are relevant by simply “translating” the models from v1 to v2, or if the models need to be adapted to correctly function with v2.

MacSyFinder is a program to model and detect macromolecular systems, genetic pathways… in protein datasets. In prokaryotes, these systems have often evolutionarily conserved properties:

- they are made of conserved components,

- they are encoded in compact loci (conserved genetic architecture).

The user models these systems with MacSyFinder to reflect these conserved features, and to allow their efficient detection.

Criteria for systems detection include component content (quorum), and genomic co-localization. Each component corresponds to a hidden Markov model (HMM) protein profile to perform sequence similarity searches with the program Hmmer.

In order to model macromolecular systems, the user:

> - builds or gather from databanks HMM protein profiles for components of interest,

> - defines decision rules for each system in a dedicated XML grammar (see Macromolecular models).

Note

If you use MacSyFinder v2, please cite:

Néron, Bertrand; Denise, Rémi; Coluzzi, Charles; Touchon, Marie; Rocha, Eduardo P.C.; Abby, Sophie S. MacSyFinder v2: Improved modelling and search engine to identify molecular systems in genomes. Peer Community Journal, Volume 3 (2023), article no. e28. doi : 10.24072/pcjournal.250. https://peercommunityjournal.org/articles/10.24072/pcjournal.250/

If you use MacSyFinder v1, please cite:

Abby SS, Néron B, Ménager H, Touchon M, Rocha EPC (2014). MacSyFinder: A Program to Mine Genomes for Molecular Systems with an Application to CRISPR-Cas Systems. PLoS ONE 9(10): e110726. doi:10.1371/journal.pone.0110726

## User Guide

- User Guide
  - Running MacSyFinder
  - MacSyFinder functioning
  - Frequently Asked Questions

## Modeller Guide

- Modeller Guide
  - Modelling Systems with MacSyFinder
  - Carrying models from v1 to v2
  - Frequently Asked Questions

## Developer Guide

- Developer Guide
  - Installation
  - MacSyFinder implementation overview
  - MacSyFinder API documentation

# Indices and tables

- Index

- Module Index

- Search Page