fatld


Namefatld JSON
Version 0.1.11 PyPI version JSON
download
home_pagehttps://abohyndoe.github.io/fatld/
SummaryGenerate and characterize designs with four-and-two-level (FATL) factors
upload_time2023-08-08 16:36:54
maintainer
docs_urlNone
authorAlexandre Bohyn
requires_python>=3.8,<4.0
licenseMIT
keywords design doe
VCS
bugtrack_url
requirements No requirements were recorded.
Travis-CI No Travis.
coveralls test coverage No coveralls.
            # Four And Two Level Designs

[![PyPI version](https://badge.fury.io/py/fatld.svg)](https://badge.fury.io/py/fatld)
[![CI](https://github.com/ABohynDOE/fatld/actions/workflows/CI.yml/badge.svg)](https://github.com/ABohynDOE/fatld/actions/workflows/CI.yml)

The `fatld` package contains functionality to generate and characterize designs with four-and-two-level (FATL) factors.
Design characteristics include word length pattern, defining relation, and number of clear interactions.
For more information about the package see the documentation at [https://abohyndoe.github.io/fatld/](https://abohyndoe.github.io/fatld/).
A large collection of FATL designs can be explored interactively using a web app at [https://abohyndoe.shinyapps.io/fatldesign-selection-tool/](https://abohyndoe.shinyapps.io/fatldesign-selection-tool/).

## Usage

The package can be used from Python:

```python
>>> import fatld
>>> D = fatld.Design(runsize=32, m=1, cols=[21, 27, 29])
>>> D.wlp()
[1, 3, 3, 0, 0]
>>> D.defining_relation()
['A1cef', 'A3deg', 'A1cdeh']
>>> print("There are %s 2-2 interactions clear from any main effect or other two-factor interaction." % D.clear('2-2'))
There are 6 2-2 interactions clear from any main effect or other two-factor interaction.
>>> print("The design contains %s four-level factors and %s two-level factors" % (D.m, D.n))
The design contains 1 four-level factors and 6 two-level factors
```

For more examples see the documentation.

## Installation

The Python interface to the package is available on pypi. Installation can be done using the following command:

```bash
pip install fatld
```

## Development

All development is done in a virtual environment based on `poetry`, activate it using:

```shell
poetry shell
```

### Code style

* Try to follow the [PEP 8](https://www.python.org/dev/peps/pep-0008/) style guide. A usefull tool for automated formatting is [black](https://pypi.python.org/pypi/black). We do allow lines upto 120 characters.
* Document functions using the [Numpy docstring](https://sphinxcontrib-napoleon.readthedocs.io/en/latest/example_numpy.html#example-numpy) convention

* Linting is based on `ruff`, configuration is found in the [pyproject.toml](pyproject.toml) file.

* Tests are ran using `pytest` and a coverage report can be generated using `coverage` inside the virtual environment:

    ```shell
    coverage run -m pytest tests
    coverage report -m
    ```

### Submitting code

If you would like to contribute, please submit a pull request. (See the [Github Hello World](https://guides.github.com/activities/hello-world/) example, if you are new to Github).

By contributing to the repository you state you own the copyright to those contributions and agree to include your contributions as part of this project under the BSD license.

### Bugs reports and feature requests

To submit a bug report or feature request use the [Github issue tracker](https://github.com/ABohynDOE/fatld/issues).
Search for existing and closed issues first. If your problem or idea is not yet addressed, please open a new issue.

### Contact

For further information please contact alexandre dot bohyn at kuleuven dot be

            

Raw data

            {
    "_id": null,
    "home_page": "https://abohyndoe.github.io/fatld/",
    "name": "fatld",
    "maintainer": "",
    "docs_url": null,
    "requires_python": ">=3.8,<4.0",
    "maintainer_email": "",
    "keywords": "design,doe",
    "author": "Alexandre Bohyn",
    "author_email": "alexandre.bohyn@kuleuven.be",
    "download_url": "https://files.pythonhosted.org/packages/9b/32/b5d93501ed9d76d4f435650e40058222354c0e4533f248e2622b3646770e/fatld-0.1.11.tar.gz",
    "platform": null,
    "description": "# Four And Two Level Designs\n\n[![PyPI version](https://badge.fury.io/py/fatld.svg)](https://badge.fury.io/py/fatld)\n[![CI](https://github.com/ABohynDOE/fatld/actions/workflows/CI.yml/badge.svg)](https://github.com/ABohynDOE/fatld/actions/workflows/CI.yml)\n\nThe `fatld` package contains functionality to generate and characterize designs with four-and-two-level (FATL) factors.\nDesign characteristics include word length pattern, defining relation, and number of clear interactions.\nFor more information about the package see the documentation at [https://abohyndoe.github.io/fatld/](https://abohyndoe.github.io/fatld/).\nA large collection of FATL designs can be explored interactively using a web app at [https://abohyndoe.shinyapps.io/fatldesign-selection-tool/](https://abohyndoe.shinyapps.io/fatldesign-selection-tool/).\n\n## Usage\n\nThe package can be used from Python:\n\n```python\n>>> import fatld\n>>> D = fatld.Design(runsize=32, m=1, cols=[21, 27, 29])\n>>> D.wlp()\n[1, 3, 3, 0, 0]\n>>> D.defining_relation()\n['A1cef', 'A3deg', 'A1cdeh']\n>>> print(\"There are %s 2-2 interactions clear from any main effect or other two-factor interaction.\" % D.clear('2-2'))\nThere are 6 2-2 interactions clear from any main effect or other two-factor interaction.\n>>> print(\"The design contains %s four-level factors and %s two-level factors\" % (D.m, D.n))\nThe design contains 1 four-level factors and 6 two-level factors\n```\n\nFor more examples see the documentation.\n\n## Installation\n\nThe Python interface to the package is available on pypi. Installation can be done using the following command:\n\n```bash\npip install fatld\n```\n\n## Development\n\nAll development is done in a virtual environment based on `poetry`, activate it using:\n\n```shell\npoetry shell\n```\n\n### Code style\n\n* Try to follow the [PEP 8](https://www.python.org/dev/peps/pep-0008/) style guide. A usefull tool for automated formatting is [black](https://pypi.python.org/pypi/black). We do allow lines upto 120 characters.\n* Document functions using the [Numpy docstring](https://sphinxcontrib-napoleon.readthedocs.io/en/latest/example_numpy.html#example-numpy) convention\n\n* Linting is based on `ruff`, configuration is found in the [pyproject.toml](pyproject.toml) file.\n\n* Tests are ran using `pytest` and a coverage report can be generated using `coverage` inside the virtual environment:\n\n    ```shell\n    coverage run -m pytest tests\n    coverage report -m\n    ```\n\n### Submitting code\n\nIf you would like to contribute, please submit a pull request. (See the [Github Hello World](https://guides.github.com/activities/hello-world/) example, if you are new to Github).\n\nBy contributing to the repository you state you own the copyright to those contributions and agree to include your contributions as part of this project under the BSD license.\n\n### Bugs reports and feature requests\n\nTo submit a bug report or feature request use the [Github issue tracker](https://github.com/ABohynDOE/fatld/issues).\nSearch for existing and closed issues first. If your problem or idea is not yet addressed, please open a new issue.\n\n### Contact\n\nFor further information please contact alexandre dot bohyn at kuleuven dot be\n",
    "bugtrack_url": null,
    "license": "MIT",
    "summary": "Generate and characterize designs with four-and-two-level (FATL) factors",
    "version": "0.1.11",
    "project_urls": {
        "Homepage": "https://abohyndoe.github.io/fatld/",
        "Repository": "https://github.com/ABohynDOE/fatld"
    },
    "split_keywords": [
        "design",
        "doe"
    ],
    "urls": [
        {
            "comment_text": "",
            "digests": {
                "blake2b_256": "1816d075a063ae9b55255bc936d8c1638df7032dd32908a7aa7eec0938be6540",
                "md5": "01620ba69bc04766054eb8a4ffdc4386",
                "sha256": "9239ad2d4de330386d8ab6a0e95dd027f1959588d731b635e2f5035154247852"
            },
            "downloads": -1,
            "filename": "fatld-0.1.11-py3-none-any.whl",
            "has_sig": false,
            "md5_digest": "01620ba69bc04766054eb8a4ffdc4386",
            "packagetype": "bdist_wheel",
            "python_version": "py3",
            "requires_python": ">=3.8,<4.0",
            "size": 20179,
            "upload_time": "2023-08-08T16:36:51",
            "upload_time_iso_8601": "2023-08-08T16:36:51.750773Z",
            "url": "https://files.pythonhosted.org/packages/18/16/d075a063ae9b55255bc936d8c1638df7032dd32908a7aa7eec0938be6540/fatld-0.1.11-py3-none-any.whl",
            "yanked": false,
            "yanked_reason": null
        },
        {
            "comment_text": "",
            "digests": {
                "blake2b_256": "9b32b5d93501ed9d76d4f435650e40058222354c0e4533f248e2622b3646770e",
                "md5": "8058c5816088820761f9baa88155e4ec",
                "sha256": "f10674516c757b9c82a72853f84706814ff1d36a7cc96fa65a2ba2721df64e3d"
            },
            "downloads": -1,
            "filename": "fatld-0.1.11.tar.gz",
            "has_sig": false,
            "md5_digest": "8058c5816088820761f9baa88155e4ec",
            "packagetype": "sdist",
            "python_version": "source",
            "requires_python": ">=3.8,<4.0",
            "size": 19562,
            "upload_time": "2023-08-08T16:36:54",
            "upload_time_iso_8601": "2023-08-08T16:36:54.254720Z",
            "url": "https://files.pythonhosted.org/packages/9b/32/b5d93501ed9d76d4f435650e40058222354c0e4533f248e2622b3646770e/fatld-0.1.11.tar.gz",
            "yanked": false,
            "yanked_reason": null
        }
    ],
    "upload_time": "2023-08-08 16:36:54",
    "github": true,
    "gitlab": false,
    "bitbucket": false,
    "codeberg": false,
    "github_user": "ABohynDOE",
    "github_project": "fatld",
    "travis_ci": false,
    "coveralls": false,
    "github_actions": true,
    "requirements": [],
    "lcname": "fatld"
}
        
Elapsed time: 0.12302s