Skip to content

README.md

Latest commit

 

History

History
55 lines (34 loc) · 2.64 KB

README.md

File metadata and controls

55 lines (34 loc) · 2.64 KB

The CBBL tools repository

The CBBL tools github repo is a collection of tools that the CBBL members have developed to help dealing with usual tasks. The repository is not perfect, nor nicely updated... It represents a starting point to face some typical tasks when dealing with bioinformatics, computational chemistry, molecular simulations, etc...

This is a live repository, always to be improved. Either if you are a member of the CBBL or not, you contribution is more than welcome.

How to use the repository

Most folders contain either notebooks, small scripts, or both. The intended workflow is:

  1. Enter the folder that matches your topic.
  2. Read its local Readme.md or README.md.
  3. Run the notebooks for interactive examples or the scripts for lightweight command-line tasks.

The sequenceTools folder is now fully notebook-based. The rest of the folders keep their existing scripts and notebooks, and each active tools folder also includes:

  • report_<folder>.tex: a LaTeX summary of the methods used in that folder.

The reports now use pure LaTeX/TikZ for conceptual schemes. Notebooks in the repo should only exist when they perform the actual computational or teaching work of the folder.

How to generate the reports

The repository uses a common root .latexmkrc so that every report is compiled with latexmk using lualatex.

Prerequisites:

  • jupyter
  • latexmk
  • a TeX distribution with lualatex
  • Python packages from requirements.txt

To build every report from the root of the repo:

python build_reports.py

This runs latexmk in each top-level tools folder with the shared root .latexmkrc, using lualatex.

To build a single report manually, go to the target folder and run:

latexmk -r ../.latexmkrc -lualatex report_<folder>.tex

For example, in sequenceTools the report file is report_sequenceTools.tex.

Instructions to build the HTML site

The repo contains an HTML site that can be accessed through this link. To build the site when updating the material of the repo, you should install jupyter book and ghp-import, to make the handling of the gh-pages branch easier. In short, once installed and assuming that your local repo copy is <local_github>/Tools do the following:

cd <local_github>
jb build Tools; cd Tools; git add .; git commit -m "update"; git push; ghp-import -n -p -f _build/html