Differences
This shows you the differences between two versions of the page.
Both sides previous revision Previous revision Next revision | Previous revision | ||
public:user_software:user_software [2011-10-18 09:49] – Lars Bahren | public:user_software:user_software [2017-03-08 15:27] (current) – external edit 127.0.0.1 | ||
---|---|---|---|
Line 1: | Line 1: | ||
~~NOTOC~~ | ~~NOTOC~~ | ||
- | ====== User Software ====== | + | ====== |
- | [[# | + | < |
+ | <div style=" | ||
+ | </ | ||
- | ==== Code repository ==== | + | __TOC__: |
- | - [[# | + | - [[#Code repository]] |
- | | + | * [[# |
- | | + | |
- | | + | |
+ | | ||
+ | - **Software packages** | ||
+ | * [[CR-Tools]] | ||
+ | * [[DAL|Data Access Library]] (DAL) | ||
+ | * [[http:// | ||
+ | * [[LOPES-Eventbrowser]] | ||
+ | * < | ||
+ | * [[http:// | ||
+ | * [[Pulsar Tools]] | ||
+ | * < | ||
+ | - [[Building an individual package]] | ||
+ | - [[# | ||
+ | - [[Reorganization of the software collection]] | ||
+ | |||
+ | ==== Code repository ==== | ||
=== Organization of the repository === | === Organization of the repository === | ||
< | < | ||
- | lus.lofar.org/ | + | usg.lofar.org/ |
|-- code | |-- code | ||
| |-- branches | | |-- branches | ||
| `-- trunk | | `-- trunk | ||
- | | | + | | |
| | | | ||
| | | | ||
Line 30: | Line 47: | ||
=== Checking out code === | === Checking out code === | ||
- | As read-only access to the repository is not restricted in any ways, you can obtain a working copy of the source code by running | + | You can obtain a working copy of the source code by running |
- | <code bash> | + | * __using Subversion...__ |
- | svn co http://lus.lofar.org/ | + | svn co http://usg.lofar.org/ |
- | </ | + | * __using Git...__ <code bash> |
+ | git svn clone http:// | ||
+ | </ | ||
+ | git svn clone -r < | ||
+ | cd lofarsoft | ||
+ | git svn rebase | ||
+ | </ | ||
- | In case you not only want a working version of the source code, but also of the various documents, you do have two options to options of retrieval: | + | In case you not only want a working version of the source code, but also of the various documents:< |
- | - Check out everything in a single go: <code bash> | + | |
- | svn co http:// | + | |
- | </ | + | |
- | - Check out a slightly cleaned-up version, omitting the '' | + | |
mkdir usg | mkdir usg | ||
cd usg | cd usg | ||
- | svn co http://lus.lofar.org/ | + | svn co http://usg.lofar.org/ |
- | svn co http://lus.lofar.org/ | + | svn co http://usg.lofar.org/ |
</ | </ | ||
- | === Updating your working copy === | + | Note: Release versions of the Pulsar tools (as used on CEP2 and CEP3) can be obtained from the URL (for example):< |
- | + | svn co http:// | |
- | Go to the '' | + | |
- | < | + | |
- | make update | + | |
</ | </ | ||
- | In the simplest case this might be nothing but a wrapper around the '' | + | This will download |
- | Then build your target, for example " | + | === Bootstrapping |
- | <code bash> | + | |
- | make dal | + | Once the checkout from the central repository has completed, you are left with a directory structure as described above. The next step now is to get to the point where it is possible to build (and subsequently install) packages in the software collection... |
- | </code> | + | |
+ | As the LUS uses the CMake cross-platform makefile generator to handle the configuration of the code base, the most important thing to check is whether or not a suitable version of CMake is available on your platform -- this check is carried out through the bootstrap script in the top-level directory of the working copy: | ||
- | You can also just build the target folder leaving everything else untouched using | ||
<code bash> | <code bash> | ||
- | cd dal | + | ./bootstrap |
- | make rebuild_cache && make && make install | + | |
</ | </ | ||
- | === Write access | + | The the main job of the '' |
- | While (by design) the user software repository is world-wide readable, write access is being restricted to a list of registered users. The basic procedure for getting added to that list -- which basically relies on a combination of a '' | + | === Updating your working copy === |
- | The information which needs to be provided by the user is a combination | + | As with the case of retrieving your working working copy from the central repository, this step is very much depending on the tool used locally for version control: |
- | * Using '' | + | * __Subversion__ |
- | * Using '' | + | |
- | If none of the above mentioned tools are available, use can be made of an [[http:// | + | * __Git__ |
- | + | git checkout master | |
- | Depending on the command line tool being used, the output will contain the full string | + | git svn rebase |
- | <file> | + | </code> If however you prefer to directly merge the upstream changes into your feature/ |
- | lbaehren: | + | |
- | $apr1$9H8IBSvy$yswI9jLosDkDx1a6.12345 | + | |
- | </file> | + | |
- | ==== Software packages ==== | ||
- | * The [[DAL|Data Access Library]] (DAL) is a library that abstracts the underlying file format from the user when working with radio astronomy data. Underlying formats may include HDF5, AIPS++/CASA tables, FITS or specific raw formats. This library is available to both the C/C++ developer and the Python user via the " | + | ==== Local installation ==== |
- | * [[CR-Tools]] | + | {{public: |
- | * [[Pulsar Tools]] | + | |
- | * [[pyBDSM]] | + |