aquila-borg


Nameaquila-borg JSON
Version 2.1.1 PyPI version JSON
download
home_page
SummaryARES/BORG engine packaged in a Python module
upload_time2023-08-15 11:58:37
maintainer
docs_urlNone
author
requires_python>=3.6
license
keywords cosmology inference simulation statistics
VCS
bugtrack_url
requirements No requirements were recorded.
Travis-CI No Travis.
coveralls test coverage No coveralls.
            ==================================================
BORG: Bayesian Origin Reconstruction from Galaxies
==================================================

Please check the individual source files for the respective contributors.

Version 2.1

Description
-----------

This is the main component of the Bayesian Large Scale Structure inference
pipeline.

A lot of complementary informations are available on the wiki https://www.aquila-consortium.org/.

Cloning all the modules
-----------------------

The ARES software is only the foundation for other modules that adds many more functionalities to the framework.

Notably, the Aquila collaboration has developped the BORG extension that encodes advanced forward model and complex likelihoods
to run inferences on galaxy clustering, lyman-alpha, and more.

To get access to the extra modules please contact Aquila consortium members, who will tell you what are the policy in places.
Once your account on bitbucket is authorized you may use the script `get-aquila-modules.sh`. The procedure is as follow:

* first change to the desired branch (i.e. develop/2.1) with `git checkout the_interesting_branch`
* clone all the adequate modules `get-aquila-modules.sh --clone`
* setup the branches for the modules `get-aquila-modules.sh --branch-set`
* Polish up your environment by installing the git hooks `get-aquila-modules.sh --hooks`

**NOTE** the git hook require the availability `clang-format` to check on the formatting. If it is not present, then it will fail
the execution.

Building
--------

There is a special command line that prepares prepares build system to compile
all tools and libraries. It resides in the root directory of the ares source
tree and is called "build.sh". By default it will build everything in the
"build" subdirectory. To get all the options please run with the option
"--help".

After the tool has bee run, you can move to the build directory and execute
"make", which will build everything.

Please pay attention warnings and error messages. The most important are color marked.
Notably some problems may occur if two versions of the same compiler are used for C and C++.
To adjust that it is sufficient to explicitly specify the compiler path with the options '--c-compiler'
and '--cxx-compiler' of "build.sh".

*Note*: When modules are present in extra/, you may prevent them from building by putting an empty file called `DO_NOT_BUILD` in the
corresponding directory folder of the concerned module. For example, to prevent `borg` from building do `touch extra/borg/DO_NOT_BUILD`
from the present directory and the build system will ignore `borg`.

Compiler compatibilities
------------------------

Tested on GCC 7.0 - 10.2.
Some performance regressions were noted with gcc 8.1.
Countermeasures have been introduced though some corner cases
may still be a bit slower. Clang is unaffected by this regression.

Note that GCC <= 6 fails because it does not support correctly C++14 features.


Documentation
-------------

Please refer to `docs/README.txt`.

The documentation is also available on https://docs.aquila-consortium.org/borg-public/2.1/

Modules
-------

The core package supports to have extensions statically linked to the core.
They have to be put in extra/ and the cmake scripts will automatically link
to it. Check 'extra/demo/' for an example.

Usage policy
------------

Please check the documentation for details on the citation requirements for using this software: https://www.aquila-consortium.org/docs/borg-public/2.1/.

Acknowledgements
----------------

This work has been funded by the following grants and institutions over the
years:

* the DFG cluster of excellence "Origin and Structure of the Universe"
  (http://www.universe-cluster.de).
* Institut Lagrange de Paris (grant ANR-10-LABX-63, http://ilp.upmc.fr) within
  the context of the Idex SUPER subsidized by the French government through
  the Agence Nationale de la Recherche (ANR-11-IDEX-0004-02).
* BIG4 (ANR-16-CE23-0002) (https://big4.iap.fr)
* The "Programme National de Cosmologie et Galaxies" (PNCG, CNRS/INSU)
* Through the grant code ORIGIN, it has received support from
  the "Domaine d'Interet Majeur (DIM) Astrophysique et Conditions d'Apparitions
  de la Vie (ACAV)" from Ile-de-France region.

            

Raw data

            {
    "_id": null,
    "home_page": "",
    "name": "aquila-borg",
    "maintainer": "",
    "docs_url": null,
    "requires_python": ">=3.6",
    "maintainer_email": "",
    "keywords": "cosmology,inference,simulation,statistics",
    "author": "",
    "author_email": "",
    "download_url": "https://files.pythonhosted.org/packages/b5/7f/66244f049fdc769b58c73bc98f5064c87838d8b282c4703cef00efc8fba3/aquila_borg-2.1.1.tar.gz",
    "platform": null,
    "description": "==================================================\nBORG: Bayesian Origin Reconstruction from Galaxies\n==================================================\n\nPlease check the individual source files for the respective contributors.\n\nVersion 2.1\n\nDescription\n-----------\n\nThis is the main component of the Bayesian Large Scale Structure inference\npipeline.\n\nA lot of complementary informations are available on the wiki https://www.aquila-consortium.org/.\n\nCloning all the modules\n-----------------------\n\nThe ARES software is only the foundation for other modules that adds many more functionalities to the framework.\n\nNotably, the Aquila collaboration has developped the BORG extension that encodes advanced forward model and complex likelihoods\nto run inferences on galaxy clustering, lyman-alpha, and more.\n\nTo get access to the extra modules please contact Aquila consortium members, who will tell you what are the policy in places.\nOnce your account on bitbucket is authorized you may use the script `get-aquila-modules.sh`. The procedure is as follow:\n\n* first change to the desired branch (i.e. develop/2.1) with `git checkout the_interesting_branch`\n* clone all the adequate modules `get-aquila-modules.sh --clone`\n* setup the branches for the modules `get-aquila-modules.sh --branch-set`\n* Polish up your environment by installing the git hooks `get-aquila-modules.sh --hooks`\n\n**NOTE** the git hook require the availability `clang-format` to check on the formatting. If it is not present, then it will fail\nthe execution.\n\nBuilding\n--------\n\nThere is a special command line that prepares prepares build system to compile\nall tools and libraries. It resides in the root directory of the ares source\ntree and is called \"build.sh\". By default it will build everything in the\n\"build\" subdirectory. To get all the options please run with the option\n\"--help\".\n\nAfter the tool has bee run, you can move to the build directory and execute\n\"make\", which will build everything.\n\nPlease pay attention warnings and error messages. The most important are color marked.\nNotably some problems may occur if two versions of the same compiler are used for C and C++.\nTo adjust that it is sufficient to explicitly specify the compiler path with the options '--c-compiler'\nand '--cxx-compiler' of \"build.sh\".\n\n*Note*: When modules are present in extra/, you may prevent them from building by putting an empty file called `DO_NOT_BUILD` in the\ncorresponding directory folder of the concerned module. For example, to prevent `borg` from building do `touch extra/borg/DO_NOT_BUILD`\nfrom the present directory and the build system will ignore `borg`.\n\nCompiler compatibilities\n------------------------\n\nTested on GCC 7.0 - 10.2.\nSome performance regressions were noted with gcc 8.1.\nCountermeasures have been introduced though some corner cases\nmay still be a bit slower. Clang is unaffected by this regression.\n\nNote that GCC <= 6 fails because it does not support correctly C++14 features.\n\n\nDocumentation\n-------------\n\nPlease refer to `docs/README.txt`.\n\nThe documentation is also available on https://docs.aquila-consortium.org/borg-public/2.1/\n\nModules\n-------\n\nThe core package supports to have extensions statically linked to the core.\nThey have to be put in extra/ and the cmake scripts will automatically link\nto it. Check 'extra/demo/' for an example.\n\nUsage policy\n------------\n\nPlease check the documentation for details on the citation requirements for using this software: https://www.aquila-consortium.org/docs/borg-public/2.1/.\n\nAcknowledgements\n----------------\n\nThis work has been funded by the following grants and institutions over the\nyears:\n\n* the DFG cluster of excellence \"Origin and Structure of the Universe\"\n  (http://www.universe-cluster.de).\n* Institut Lagrange de Paris (grant ANR-10-LABX-63, http://ilp.upmc.fr) within\n  the context of the Idex SUPER subsidized by the French government through\n  the Agence Nationale de la Recherche (ANR-11-IDEX-0004-02).\n* BIG4 (ANR-16-CE23-0002) (https://big4.iap.fr)\n* The \"Programme National de Cosmologie et Galaxies\" (PNCG, CNRS/INSU)\n* Through the grant code ORIGIN, it has received support from\n  the \"Domaine d'Interet Majeur (DIM) Astrophysique et Conditions d'Apparitions\n  de la Vie (ACAV)\" from Ile-de-France region.\n",
    "bugtrack_url": null,
    "license": "",
    "summary": "ARES/BORG engine packaged in a Python module",
    "version": "2.1.1",
    "project_urls": null,
    "split_keywords": [
        "cosmology",
        "inference",
        "simulation",
        "statistics"
    ],
    "urls": [
        {
            "comment_text": "",
            "digests": {
                "blake2b_256": "5b27863159198b87d0f0cf271edc4bc4fd95c47a1a51d489ca2655d1a719a705",
                "md5": "8da7263f70770a4700fa6350791ff3b6",
                "sha256": "2b1cad6e6c382d79ca7a3e8cdf35a1fbbb069f095dfd049903a07daa911a317f"
            },
            "downloads": -1,
            "filename": "aquila_borg-2.1.1-cp38-cp38-manylinux_2_17_x86_64.manylinux2014_x86_64.whl",
            "has_sig": false,
            "md5_digest": "8da7263f70770a4700fa6350791ff3b6",
            "packagetype": "bdist_wheel",
            "python_version": "cp38",
            "requires_python": ">=3.6",
            "size": 16722066,
            "upload_time": "2023-08-15T11:58:55",
            "upload_time_iso_8601": "2023-08-15T11:58:55.561458Z",
            "url": "https://files.pythonhosted.org/packages/5b/27/863159198b87d0f0cf271edc4bc4fd95c47a1a51d489ca2655d1a719a705/aquila_borg-2.1.1-cp38-cp38-manylinux_2_17_x86_64.manylinux2014_x86_64.whl",
            "yanked": false,
            "yanked_reason": null
        },
        {
            "comment_text": "",
            "digests": {
                "blake2b_256": "c2b58efdaa0490e7fcd022ec069fa5dfc05eecb8d4240f37461b797f0128731c",
                "md5": "4c5c9422f22d8b8b81872cfbfb159b9e",
                "sha256": "f5fbad59d3bbfa68b00eb655693efbc974397dac4c333e0c2143b1195d82fdaa"
            },
            "downloads": -1,
            "filename": "aquila_borg-2.1.1-cp39-cp39-manylinux_2_17_x86_64.manylinux2014_x86_64.whl",
            "has_sig": false,
            "md5_digest": "4c5c9422f22d8b8b81872cfbfb159b9e",
            "packagetype": "bdist_wheel",
            "python_version": "cp39",
            "requires_python": ">=3.6",
            "size": 16724475,
            "upload_time": "2023-08-15T11:59:00",
            "upload_time_iso_8601": "2023-08-15T11:59:00.000065Z",
            "url": "https://files.pythonhosted.org/packages/c2/b5/8efdaa0490e7fcd022ec069fa5dfc05eecb8d4240f37461b797f0128731c/aquila_borg-2.1.1-cp39-cp39-manylinux_2_17_x86_64.manylinux2014_x86_64.whl",
            "yanked": false,
            "yanked_reason": null
        },
        {
            "comment_text": "",
            "digests": {
                "blake2b_256": "b57f66244f049fdc769b58c73bc98f5064c87838d8b282c4703cef00efc8fba3",
                "md5": "6416bac1694dc96e734f5c78f8f4f134",
                "sha256": "22a1f8620c3f05e419e04efd220226888e917094c89f85235cb82733e31c1a10"
            },
            "downloads": -1,
            "filename": "aquila_borg-2.1.1.tar.gz",
            "has_sig": false,
            "md5_digest": "6416bac1694dc96e734f5c78f8f4f134",
            "packagetype": "sdist",
            "python_version": "source",
            "requires_python": ">=3.6",
            "size": 6331443,
            "upload_time": "2023-08-15T11:58:37",
            "upload_time_iso_8601": "2023-08-15T11:58:37.141098Z",
            "url": "https://files.pythonhosted.org/packages/b5/7f/66244f049fdc769b58c73bc98f5064c87838d8b282c4703cef00efc8fba3/aquila_borg-2.1.1.tar.gz",
            "yanked": false,
            "yanked_reason": null
        }
    ],
    "upload_time": "2023-08-15 11:58:37",
    "github": false,
    "gitlab": false,
    "bitbucket": false,
    "codeberg": false,
    "lcname": "aquila-borg"
}
        
Elapsed time: 0.15948s