Skip to main content
  • Home
  • Development
  • Documentation
  • Donate
  • Operational login
  • Browse the archive

swh logo
SoftwareHeritage
Software
Heritage
Archive
Features
  • Search

  • Downloads

  • Save code now

  • Add forge now

  • Help

https://github.com/fenderglass/Ragout
05 April 2024, 18:02:13 UTC
  • Code
  • Branches (21)
  • Releases (0)
  • Visits
    • Branches
    • Releases
    • HEAD
    • refs/heads/chr_map
    • refs/heads/devel
    • refs/heads/gh-pages
    • refs/heads/ismb_2014
    • refs/heads/master
    • refs/heads/path_cover
    • refs/heads/py3
    • refs/heads/rr_devel
    • refs/heads/tree_infer
    • refs/remotes/origin/devel
    • refs/tags/1.0
    • refs/tags/1.1
    • refs/tags/2.0
    • refs/tags/2.1
    • refs/tags/2.1.1
    • refs/tags/2.2
    • refs/tags/2.3
    • refs/tags/v0.1b
    • refs/tags/v0.2b
    • refs/tags/v0.3b
    • refs/tags/v1.2
    No releases to show
  • e0f14d1
  • /
  • docs
  • /
  • INSTALL.md
Raw File Download
Take a new snapshot of a software origin

If the archived software origin currently browsed is not synchronized with its upstream version (for instance when new commits have been issued), you can explicitly request Software Heritage to take a new snapshot of it.

Use the form below to proceed. Once a request has been submitted and accepted, it will be processed as soon as possible. You can then check its processing state by visiting this dedicated page.
swh spinner

Processing "take a new snapshot" request ...

Permalinks

To reference or cite the objects present in the Software Heritage archive, permalinks based on SoftWare Hash IDentifiers (SWHIDs) must be used.
Select below a type of object currently browsed in order to display its associated SWHID and permalink.

  • content
  • directory
  • revision
  • snapshot
origin badgecontent badge Iframe embedding
swh:1:cnt:498e2b67ed3d678cffed2dc868207f8261e29129
origin badgedirectory badge Iframe embedding
swh:1:dir:3037c690460c627533dbc6a2314e7a9afc4a3e8e
origin badgerevision badge
swh:1:rev:bd35cb59f602ed33794dc1697a1503375eabef80
origin badgesnapshot badge
swh:1:snp:12412e9d5850529b00b9f75cc3a4b47d1a47cc92
Citations

This interface enables to generate software citations, provided that the root directory of browsed objects contains a citation.cff or codemeta.json file.
Select below a type of object currently browsed in order to generate citations for them.

  • content
  • directory
  • revision
  • snapshot
Generate software citation in BibTex format (requires biblatex-software package)
Generating citation ...
Generate software citation in BibTex format (requires biblatex-software package)
Generating citation ...
Generate software citation in BibTex format (requires biblatex-software package)
Generating citation ...
Generate software citation in BibTex format (requires biblatex-software package)
Generating citation ...
Tip revision: bd35cb59f602ed33794dc1697a1503375eabef80 authored by Mikhail Kolmogorov on 05 March 2015, 20:35:08 UTC
added extra condition in split_by_instance
Tip revision: bd35cb5
INSTALL.md
Installation instructions for Ragout
====================================

Availability
------------
Ragout was tested under Mac OS and Linux. While it should work
under Windows, we currently do not provide an official support.


Build requirements
------------------
* C++ compiler with C++0x support (GCC 4.6+ / Clang 3.2+ / Apple Clang 4.2+)
* GNU make / Cmake (for building Sibelia)


Runtime depenencies
-------------------

* Python 2.7
* Sibelia [http://github.com/bioinf/Sibelia] or Progresssive Cactus [http://github.com/glennhickey/progressiveCactus]


Binary distribution
-------------------

While we recommend to build Ragout from source on each machine, you also can
use pre-compiled binaries which are available for Linux and Mac OS from 
Releases page on Github: https://github.com/fenderglass/Ragout/releases

In this case, you do not need any installation procedures. If you are unsure,
which version (binary or source) you have downloaded, you can check for
binary files in "lib" directory. If they exist - you have obtained a binary
version, otherwise it is source.


Building
--------

1. To build Ragout native modules, type:
    
        make

2. To build and install Sibelia, use:

        python scripts/install-sibelia.py

If you already have Sibelia installed, you can skip second step.

After this, you can test your installation by running:

    python ragout.py --help

If no errors occured, installation was successful and you can start using Ragout!


progressiveCactus
-----------------

Ragout can use both Sibelia and Progressive Cactus for synteny block decomposition.
Cactus support is still in early stage, however you already can try it with genomes,
that are too big for Sibelia.

First, download and build Progressive Cactus: https://github.com/glennhickey/progressiveCactus
Then set "CACTUS_INSTALL" environment variable pointing to Cactus installation directory:

    export CACTUS_INSTALL=path_to_cactus


Troubleshooting
---------------

Q: Tons of errors during compilation, possibly with 
"unrecognized command line option '-std=c++0x'" message:

A: Probably your compiler is too old and does not support C++0x. Minimum
versions of GCC and Clang are mentioned at the beginnig of this documtent.


Q: "libstdc++.so.6: version `CXXABI_1.3.5' not found" when running
or something similar

A: Ensure, that version of libc++ which was used to compile Ragout is similar
to one which is used to run it. You can specify an extra search path
to a specific library by setting "LD_LIBRARY_PATH" variable.

back to top

Software Heritage — Copyright (C) 2015–2025, The Software Heritage developers. License: GNU AGPLv3+.
The source code of Software Heritage itself is available on our development forge.
The source code files archived by Software Heritage are available under their own copyright and licenses.
Terms of use: Archive access, API— Contact— JavaScript license information— Web API