# Four And Two Level Designs
[](https://badge.fury.io/py/fatld)
[](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[](https://badge.fury.io/py/fatld)\n[](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"
}
JSON
