<div align="center">
# ⌛️ smiffer 🦙
[](https://www.python.org/downloads/release/python-350/)
[](https://opensource.org/licenses/MIT)
<img src="https://smiffer.mol3d.tech/ressources/img/logo_compress.png" width="40%">
Contributors: **Diego BARQUERO MORERA** and **Lucas ROUAUD**
**Documentation:** https://smiffer.mol3d.tech/
</div align="center">
This software is coded in python. It permits to produced grids, into a OpenDX format (`.dx`). With those grids, it is possible to visualize multiple physical and chemical properties around a protein. This permit to see all possible area of interaction (with proteins, ligands or lipids) around a protein.
## ⚙️ Installation
### 📦 Using pipx (recommended)
- pipx link: [https://github.com/pypa/pipx?tab=readme-ov-file#install-pipx](https://github.com/pypa/pipx?tab=readme-ov-file#install-pipx)
```bash
$ pipx install smiffer
# Checking the installation is done.
$ smiffer --help
```
> **🦊 From the GitLab repository:**
>
> ```bash
> $ git clone https://gitlab.galaxy.ibpc.fr/rouaud/smiffer.git
> $ cd smiffer/
> $ pipx install .
>
> # Checking the installation is done.
> $ smiffer --help
> ```
### 🐍 Using pip
```bash
$ python3 -m pip install smiffer
# Checking the installation is done.
$ smiffer --help
```
> **🦊 From the GitLab repository:**
>
> ```bash
> $ git clone https://gitlab.galaxy.ibpc.fr/rouaud/smiffer.git
> $ cd smiffer/
> $ python3 -m pip install .
>
> # Checking the installation is done.
> $ smiffer --help
> ```
### 🐋 Using docker
```bash
$
```
### 🛠 From scratch (not recommended)
```bash
$ git clone https://gitlab.galaxy.ibpc.fr/rouaud/smiffer.git
$ cd smiffer
# Install globaly these packages…
$ pip install -r env/requirements.txt
# Checking the installation is done.
$ python -m src.smiffer --help
```
## 🌐 External software
The APBS server can be found at next url: https://server.poissonboltzmann.org/.
## 🚀 Launching the software
### 🎥 Example
To test the program, use the following commands in `📁 smiffer/`:
```sh
$ mkdir data/output/
# Launching the software.
$ smiffer -i data1EHE.pdb \
$ -p data1EHE_parameter.yml \
$ -a data/1EHE_APBS.dx \
$ -o data/output/
# Visualize using VMD (or other like PyMol, Chimera, Mol*, etc.).
$ vmd data/1EHE.pdb data/output/*.dx
```
### 🔍 Parameters description
| **Argument** | **Mandatory?** | **Type and usage** | **Description** |
| :------------------------ | :------------: | :--------------------- | :--------------------------------------------------------------------------- |
| **`-i` or `--input`** | Yes | `--input file.pdb` | The `.pdb` file that while be used<br/>to computed the properties. |
| **`-o` or `--output`** | Yes | `--output directory` | The directory to output the results. |
| **`-p` or `--parameter`** | No | `--parameter file.yml` | The YAML parameters file. |
| **`-a` or `--apbs`** | No | `--apbs file.dx` | The already computed APBS<br/>electrostatic grid. |
| **`-h` or `--help`** | No | Flag | Display the help and exit the<br/>program. |
| **`-v` or `--version`** | No | Flag | Display the version and exit the<br/>program. |
| **`--verbose`** | No | Flag | Activated a verbose mode, so more<br/>information are going to be displayed. |
## 🙇♂️ Acknowledgement
🔍 Code reviewing: **Hubert SANTUZ**
✒️ Formula checking: **Jules MARIEN**
_This work is licensed under a [MIT License](https://opensource.org/licenses/MIT)._
[](https://opensource.org/licenses/MIT)
Raw data
{
"_id": null,
"home_page": null,
"name": "smiffer",
"maintainer": null,
"docs_url": null,
"requires_python": ">=3.5",
"maintainer_email": "Lucas ROUAUD <lucas.rouaud@gmail.com>",
"keywords": "python, chemical, grid, RNA, protein, properties, physical based computation, bioinformatic, chemoinformatic",
"author": null,
"author_email": "Diego BARQUERO MORERA <diegobarqueromorera@gmail.com>, Lucas ROUAUD <lucas.rouaud@gmail.com>",
"download_url": "https://files.pythonhosted.org/packages/63/aa/4b5c21267ccb1a324870eebefbc9a1e495a583994698420e05419820570f/smiffer-0.1.0.tar.gz",
"platform": null,
"description": "<div align=\"center\">\n\n# \u231b\ufe0f smiffer \ud83e\udd99\n\n[](https://www.python.org/downloads/release/python-350/)\n[](https://opensource.org/licenses/MIT)\n\n<img src=\"https://smiffer.mol3d.tech/ressources/img/logo_compress.png\" width=\"40%\">\n\nContributors: **Diego BARQUERO MORERA** and **Lucas ROUAUD**\n\n**Documentation:** https://smiffer.mol3d.tech/\n\n</div align=\"center\">\n\nThis software is coded in python. It permits to produced grids, into a OpenDX format (`.dx`). With those grids, it is possible to visualize multiple physical and chemical properties around a protein. This permit to see all possible area of interaction (with proteins, ligands or lipids) around a protein.\n\n## \u2699\ufe0f Installation\n\n### \ud83d\udce6 Using pipx (recommended)\n\n- pipx link: [https://github.com/pypa/pipx?tab=readme-ov-file#install-pipx](https://github.com/pypa/pipx?tab=readme-ov-file#install-pipx)\n\n```bash\n$ pipx install smiffer\n\n# Checking the installation is done.\n$ smiffer --help\n```\n\n> **\ud83e\udd8a From the GitLab repository:**\n> \n> ```bash\n> $ git clone https://gitlab.galaxy.ibpc.fr/rouaud/smiffer.git\n> $ cd smiffer/\n> $ pipx install .\n> \n> # Checking the installation is done.\n> $ smiffer --help\n> ```\n\n### \ud83d\udc0d Using pip\n\n```bash\n$ python3 -m pip install smiffer\n\n# Checking the installation is done.\n$ smiffer --help\n```\n\n> **\ud83e\udd8a From the GitLab repository:**\n> \n> ```bash\n> $ git clone https://gitlab.galaxy.ibpc.fr/rouaud/smiffer.git\n> $ cd smiffer/\n> $ python3 -m pip install .\n> \n> # Checking the installation is done.\n> $ smiffer --help\n> ```\n\n### \ud83d\udc0b Using docker\n\n```bash\n$ \n```\n\n### \ud83d\udee0 From scratch (not recommended)\n\n```bash\n$ git clone https://gitlab.galaxy.ibpc.fr/rouaud/smiffer.git\n$ cd smiffer\n\n# Install globaly these packages\u2026\n$ pip install -r env/requirements.txt\n\n# Checking the installation is done.\n$ python -m src.smiffer --help\n```\n\n## \ud83c\udf10 External software\n\nThe APBS server can be found at next url: https://server.poissonboltzmann.org/.\n\n## \ud83d\ude80 Launching the software\n\n### \ud83c\udfa5 Example\n\nTo test the program, use the following commands in `\ud83d\udcc1 smiffer/`:\n\n```sh\n$ mkdir data/output/\n\n# Launching the software.\n$ smiffer -i data1EHE.pdb \\\n$ -p data1EHE_parameter.yml \\\n$ -a data/1EHE_APBS.dx \\\n$ -o data/output/\n\n# Visualize using VMD (or other like PyMol, Chimera, Mol*, etc.).\n$ vmd data/1EHE.pdb data/output/*.dx\n```\n\n### \ud83d\udd0d Parameters description\n\n| **Argument** | **Mandatory?** | **Type and usage** | **Description** |\n| :------------------------ | :------------: | :--------------------- | :--------------------------------------------------------------------------- |\n| **`-i` or `--input`** | Yes | `--input file.pdb` | The `.pdb` file that while be used<br/>to computed the properties. |\n| **`-o` or `--output`** | Yes | `--output directory` | The directory to output the results. |\n| **`-p` or `--parameter`** | No | `--parameter file.yml` | The YAML parameters file. |\n| **`-a` or `--apbs`** | No | `--apbs file.dx` | The already computed APBS<br/>electrostatic grid. |\n| **`-h` or `--help`** | No | Flag | Display the help and exit the<br/>program. |\n| **`-v` or `--version`** | No | Flag | Display the version and exit the<br/>program. |\n| **`--verbose`** | No | Flag | Activated a verbose mode, so more<br/>information are going to be displayed. |\n\n## \ud83d\ude47\u200d\u2642\ufe0f Acknowledgement\n\n\ud83d\udd0d Code reviewing: **Hubert SANTUZ**\n\n\u2712\ufe0f Formula checking: **Jules MARIEN**\n\n_This work is licensed under a [MIT License](https://opensource.org/licenses/MIT)._\n\n[](https://opensource.org/licenses/MIT)\n",
"bugtrack_url": null,
"license": "MIT License",
"summary": "Compute possible interaction with fields arround protein or RNA.",
"version": "0.1.0",
"project_urls": {
"Documentation": "https://smiffer.mol3d.tech",
"Homepage": "https://gitlab.galaxy.ibpc.fr/rouaud/smiffer",
"Repository": "https://gitlab.galaxy.ibpc.fr/rouaud/smiffer"
},
"split_keywords": [
"python",
" chemical",
" grid",
" rna",
" protein",
" properties",
" physical based computation",
" bioinformatic",
" chemoinformatic"
],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "f7f71beeb108af97aec188c9937eed531d170165e27b65badff8f63d9b5800df",
"md5": "9fa39eeab7a2c6aeb9af19d360d2574b",
"sha256": "68ad9ccfc157326da4cf41722c81399bc36b7efcd2c8ffc26e7b885dba2b8ef5"
},
"downloads": -1,
"filename": "smiffer-0.1.0-py3-none-any.whl",
"has_sig": false,
"md5_digest": "9fa39eeab7a2c6aeb9af19d360d2574b",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": ">=3.5",
"size": 44598,
"upload_time": "2024-10-15T15:10:36",
"upload_time_iso_8601": "2024-10-15T15:10:36.832592Z",
"url": "https://files.pythonhosted.org/packages/f7/f7/1beeb108af97aec188c9937eed531d170165e27b65badff8f63d9b5800df/smiffer-0.1.0-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": "",
"digests": {
"blake2b_256": "63aa4b5c21267ccb1a324870eebefbc9a1e495a583994698420e05419820570f",
"md5": "9f0a3e23d003f2145293b254ec7dd536",
"sha256": "5f7d9f10c0a773140258be8fc3bdb125f53c122884b4033b464d6907e0f0d076"
},
"downloads": -1,
"filename": "smiffer-0.1.0.tar.gz",
"has_sig": false,
"md5_digest": "9f0a3e23d003f2145293b254ec7dd536",
"packagetype": "sdist",
"python_version": "source",
"requires_python": ">=3.5",
"size": 26229106,
"upload_time": "2024-10-15T15:10:40",
"upload_time_iso_8601": "2024-10-15T15:10:40.507352Z",
"url": "https://files.pythonhosted.org/packages/63/aa/4b5c21267ccb1a324870eebefbc9a1e495a583994698420e05419820570f/smiffer-0.1.0.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2024-10-15 15:10:40",
"github": false,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"lcname": "smiffer"
}
JSON