RTModel


NameRTModel JSON
Version 2.0 PyPI version JSON
download
home_pageNone
SummaryRTModel is a tool for microlensing event interpretation.
upload_time2024-03-26 15:16:35
maintainerNone
docs_urlNone
authorNone
requires_python<4,>=3.6
licenseGPL-3.0
keywords microlensing analysis and fitting
VCS
bugtrack_url
requirements No requirements were recorded.
Travis-CI No Travis.
coveralls test coverage No coveralls.
            # RTModel
`RTModel` is a package for modeling and interpretation of microlensing events. It uses photometric time series collected from ground and/or space telescopes to propose one or more possible models among the following:
- Single-lens-single-source microlensing (i.e. Paczynski)
- Single-lens-binary-source microlensing (with or without xallarap)
- Binary-lens-single-source microlensing (including planetary microlensing, parallax and orbital motion)

All models include the finite-size of the source(s).

The modeling strategy is based on a grid search in the parameter space for single-lens models, whereas a **template library** for binary-lens models is used including all possible geometries of the source trajectory with respect to the caustics. In addition to this global search, planets are searched where maximal deviations from a Paczynski model occurs. 

The library is in the form of a standard Python package that launches specific subprocesses for different tasks. Model fitting is executed in **parallel** exploiting available processors in the machine. The full modeling may take from one to three hours depending on the event and on the machine speed. The results of modeling are given in the form of a text **assessment file**; in addition, **final models** are made available with their parameters and covariance matrices.

`RTModel` also includes a subpackage **`RTModel.plotmodel`** that allows an immediate visualization of models and the possibility to review each individual fitting process as an animated gif.

## Attribution

A paper is in preparation describing all algorithms behind RTModel in detail.
At the moment, any use of this code for scientific publications should be acknowledged by citing this GitHub repository. 

## Installation

The easiest way to install `RTModel` is through `pip`
```
pip install RTModel
```

Currently, `RTModel` works on Linux and Windows, requiring Python >= 3.6. 
A C++ compiler compatible with C++17 standard is needed for installation.
`RTModel` also incorporates version 3.7 of [`VBBinaryLensing`](https://github.com/valboz/VBBinaryLensing).

Example Jupyter notebooks will be included in `examples/`.

## Documentation
Provisional [documentation for the use of RTModel](docs/README.md) is available and under development.

## License
`RTModel` is freely available to the community under the 
GNU Lesser General Public License Version 3 included in this repository.



            

Raw data

            {
    "_id": null,
    "home_page": null,
    "name": "RTModel",
    "maintainer": null,
    "docs_url": null,
    "requires_python": "<4,>=3.6",
    "maintainer_email": null,
    "keywords": "Microlensing analysis and fitting",
    "author": null,
    "author_email": "Valerio Bozza <valboz@sa.infn.it>",
    "download_url": "https://files.pythonhosted.org/packages/9e/f5/4b9f354c6d96fc2613a13cb9612b4b6300c96e782bab20b396a4a1503dc7/RTModel-2.0.tar.gz",
    "platform": null,
    "description": "# RTModel\r\n`RTModel` is a package for modeling and interpretation of microlensing events. It uses photometric time series collected from ground and/or space telescopes to propose one or more possible models among the following:\r\n- Single-lens-single-source microlensing (i.e. Paczynski)\r\n- Single-lens-binary-source microlensing (with or without xallarap)\r\n- Binary-lens-single-source microlensing (including planetary microlensing, parallax and orbital motion)\r\n\r\nAll models include the finite-size of the source(s).\r\n\r\nThe modeling strategy is based on a grid search in the parameter space for single-lens models, whereas a **template library** for binary-lens models is used including all possible geometries of the source trajectory with respect to the caustics. In addition to this global search, planets are searched where maximal deviations from a Paczynski model occurs. \r\n\r\nThe library is in the form of a standard Python package that launches specific subprocesses for different tasks. Model fitting is executed in **parallel** exploiting available processors in the machine. The full modeling may take from one to three hours depending on the event and on the machine speed. The results of modeling are given in the form of a text **assessment file**; in addition, **final models** are made available with their parameters and covariance matrices.\r\n\r\n`RTModel` also includes a subpackage **`RTModel.plotmodel`** that allows an immediate visualization of models and the possibility to review each individual fitting process as an animated gif.\r\n\r\n## Attribution\r\n\r\nA paper is in preparation describing all algorithms behind RTModel in detail.\r\nAt the moment, any use of this code for scientific publications should be acknowledged by citing this GitHub repository. \r\n\r\n## Installation\r\n\r\nThe easiest way to install `RTModel` is through `pip`\r\n```\r\npip install RTModel\r\n```\r\n\r\nCurrently, `RTModel` works on Linux and Windows, requiring Python >= 3.6. \r\nA C++ compiler compatible with C++17 standard is needed for installation.\r\n`RTModel` also incorporates version 3.7 of [`VBBinaryLensing`](https://github.com/valboz/VBBinaryLensing).\r\n\r\nExample Jupyter notebooks will be included in `examples/`.\r\n\r\n## Documentation\r\nProvisional [documentation for the use of RTModel](docs/README.md) is available and under development.\r\n\r\n## License\r\n`RTModel` is freely available to the community under the \r\nGNU Lesser General Public License Version 3 included in this repository.\r\n\r\n\r\n",
    "bugtrack_url": null,
    "license": "GPL-3.0",
    "summary": "RTModel is a tool for microlensing event interpretation.",
    "version": "2.0",
    "project_urls": {
        "Homepage": "https://github.com/valboz/RTModel"
    },
    "split_keywords": [
        "microlensing",
        "analysis",
        "and",
        "fitting"
    ],
    "urls": [
        {
            "comment_text": "",
            "digests": {
                "blake2b_256": "28e64d994631f8a9a9e93647e66f964da925a64708eaffc8761397f9f45b8039",
                "md5": "7de23bd2cd18bae19d3b98d955382949",
                "sha256": "5ccf61303430ec7d3ddf98bae879761b540c18358e270f96225219ecbadea0e6"
            },
            "downloads": -1,
            "filename": "RTModel-2.0-py3-none-any.whl",
            "has_sig": false,
            "md5_digest": "7de23bd2cd18bae19d3b98d955382949",
            "packagetype": "bdist_wheel",
            "python_version": "py3",
            "requires_python": "<4,>=3.6",
            "size": 750369,
            "upload_time": "2024-03-26T15:16:33",
            "upload_time_iso_8601": "2024-03-26T15:16:33.167457Z",
            "url": "https://files.pythonhosted.org/packages/28/e6/4d994631f8a9a9e93647e66f964da925a64708eaffc8761397f9f45b8039/RTModel-2.0-py3-none-any.whl",
            "yanked": false,
            "yanked_reason": null
        },
        {
            "comment_text": "",
            "digests": {
                "blake2b_256": "9ef54b9f354c6d96fc2613a13cb9612b4b6300c96e782bab20b396a4a1503dc7",
                "md5": "e03bb19a7b7d1394671fd55ee22f8b95",
                "sha256": "eca099db721cc995cce212b9fcdd106959e06b71a0f4324ce14419f464033da2"
            },
            "downloads": -1,
            "filename": "RTModel-2.0.tar.gz",
            "has_sig": false,
            "md5_digest": "e03bb19a7b7d1394671fd55ee22f8b95",
            "packagetype": "sdist",
            "python_version": "source",
            "requires_python": "<4,>=3.6",
            "size": 749031,
            "upload_time": "2024-03-26T15:16:35",
            "upload_time_iso_8601": "2024-03-26T15:16:35.096681Z",
            "url": "https://files.pythonhosted.org/packages/9e/f5/4b9f354c6d96fc2613a13cb9612b4b6300c96e782bab20b396a4a1503dc7/RTModel-2.0.tar.gz",
            "yanked": false,
            "yanked_reason": null
        }
    ],
    "upload_time": "2024-03-26 15:16:35",
    "github": true,
    "gitlab": false,
    "bitbucket": false,
    "codeberg": false,
    "github_user": "valboz",
    "github_project": "RTModel",
    "travis_ci": false,
    "coveralls": false,
    "github_actions": false,
    "lcname": "rtmodel"
}
        
Elapsed time: 0.33496s