aboutsummaryrefslogtreecommitdiff
path: root/README.org
diff options
context:
space:
mode:
Diffstat (limited to 'README.org')
-rw-r--r--README.org97
1 files changed, 97 insertions, 0 deletions
diff --git a/README.org b/README.org
new file mode 100644
index 0000000..1132850
--- /dev/null
+++ b/README.org
@@ -0,0 +1,97 @@
+# guix-bioinformatics
+
+Bioinformatics packages for GNU Guix that are used in
+http://genenetwork.org/. See
+[Guix Notes](https://github.com/pjotrp/guix-notes/blob/master/HACKING.org)
+for installing and hacking GNU Guix.
+
+To easily use the packages from this repo, simply add it to your
+`channels` list in ~/.config/guix/channels.scm as described
+[here](https://guix.gnu.org/manual/en/html_node/Channels.html)
+
+ (cons*
+ (channel
+ (name 'gn-bioinformatics)
+ (url "https://git.genenetwork.org/pjotrp/guix-bioinformatics.git")
+ (branch "master"))
+ %default-channels)
+
+and run `guix pull` like normal to update your software. This is the
+recommended way to use the software from this repository and the code
+snippets in this README assume you have done so.
+
+If you want to make changes to the packages in this repo then simply set
+the GUIX_PACKAGE_PATH to point to the root of this directory
+before running Guix. E.g.
+
+ git clone https://git.genenetwork.org/pjotrp/guix-bioinformatics.git
+ export GUIX_PACKAGE_PATH=$PWD/guix-bioinformatics/
+ guix package -A cwl
+
+or using a checked out Guix repo with
+
+ env GUIX_PACKAGE_PATH=$genenetwork/guix-bioinformatics/ ./pre-inst-env guix package -A cwl
+
+Some (or most) of these package definitions should make it upstream
+into the GNU Guix repository when tested and stable.
+
+## Slurm and munge
+
+Install slurm with
+
+ guix pull
+ guix package -i slurm-llnl
+
+ ~/.guix-profile/sbin/slurmd -C -D
+ ClusterName=(null) NodeName=selinunte CPUs=4 Boards=1 SocketsPerBoard=1 CoresPerSocket=2 ThreadsPerCore=2 RealMemory=7890 TmpDisk=29909
+
+## Module system
+
+Install the module environment with
+
+ guix pull
+ guix package -i environment-modules
+
+ modulecmd --version
+ VERSION=3.2.10
+ DATE=2012-12-21
+
+## python2-numarray 1.5.2
+
+Install python2-numarray package with
+
+ guix pull
+ guix package -i python2-numarray
+
+## Common Workflow Language (CWL)
+
+Install the common workflow language tool cwltool with
+
+ guix pull
+ guix package -i python2-cwltool
+
+ cwtool --version
+ 1.0.20150916041152
+
+# Development tips
+
+## Override individual packages
+
+The cheerful way of overriding a version of a package:
+
+ (use-modules (guix) (gnu packages emacs))
+
+ (package
+ (inherit emacs)
+ (name "emacs-snapshot")
+ (source "/path/to/some-file-or-directory.tar.gz"))
+
+and then run:
+
+ guix package --install-from-file=that-file.scm
+
+
+## LICENSE
+
+These package descriptions (so-called Guix expressions) are
+distributed by the same license as GNU Guix, i.e. GPL3+