| Name | SMS-BP JSON |
| Version |
0.1.5
JSON |
| download |
| home_page | None |
| Summary | Single Molecule Simulations and Microscopy Simulations developed for the Weber Lab by Baljyot Singh Parmar |
| upload_time | 2024-09-20 22:49:18 |
| maintainer | None |
| docs_url | None |
| author | None |
| requires_python | >=3.10 |
| license | --- # License --- Copyright (c) [2024] Baljyot Singh Parmar [All rights reserved]. Redistribution and use in source and binary forms, with or without modification, are permitted provided that the following conditions are met: Redistributions of source code must retain the above copyright notice, this list of conditions and the following disclaimer. THIS SOFTWARE IS PROVIDED BY Baljyot Singh Parmar “AS IS” AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL [Baljyot Singh Parmar] BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. |
| keywords |
sms
|
| VCS |
|
| bugtrack_url |
|
| requirements |
No requirements were recorded.
|
| Travis-CI |
No Travis.
|
| coveralls test coverage |
No coveralls.
|
# This is a short doc for the Track Simulations along with cluster simulations.
-----------------------------------------
- Author: Baljyot Singh Parmar
- Affiliation at the time of writing: McGill University, Canada. Weber Lab
## 1. Installation
-------------------
1. Make sure you have anaconda installed: <https://www.anaconda.com/download>
2. Download or clone this repository.
3. In the conda prompt, navigate to the folder where you downloaded this repository using : **cd "path_to_folder"**
4. Using the **SMS_BP.yml** file, create a new environment using: **conda env create -f SMS_BP.yml**
- If you get an environment resolve error but you have anaconda installed just skip to step 6. The .yml file is for people who are using miniconda and might not have the packages already installed with the full anaconda install.
- You may want to still have a conda environment so just create a generic one if you want with the name SMS_BP or whatever you want with python>=3.10. Explicitly, **conda create -n [my_env_name] python=3.10**.
5. Activate the environment using: **conda activate SMS_BP**
6. Now we will install this package in edit mode so we can use its functionalities without invoking sys.path.append() every time.
- Run the command: **pip install -e . --config-settings editable_mode=compat**
- This will install the package in editable mode and you can now use the package in any python environment without having to append the path every time.
To start interacting with the program **cd SMS_BP** and follow the next steps.
Okay now we can run the simulation with the predefined variables. For your understanding I rather have you read a short User Guide before I tell you how to run or use this code. Namely because it will help you think of the features included and what is possible. Now I want you to go to USER_GUIDE/USER_GUIDE.pdf and read the document. If you don't care, go to section 4 of that document to get right to the running of this code.
7. This is a note on using the CLI tool properly. For the previous step I have forced you to go to the file location and run the script through python. But in the install (step 6) we also installed a CLI tool to interface with the program from anywhere (regardless of where you are in your terminal). The only condition is that you are in the SMS_BP conda environment.
- To run the CLI tool after the install we can type **run_SMS_BP [PATH_TO_CONFIG_FILE]** from anywhere assuming the path you provide is absolute.
- In the background all this is doing is running: **from SMS_BP.run_cell_simulation import main_CLI(); main_CLI()**. This is the entry point.
- Do note that the config checker is not robust so if you have prodived the wrong types or excluded some parameters which are required alongside other ones you will get an error. Read the SMS_BP/sim_config.md for details into the config file parameters.
8. If you run into any issues please create a Github issue on the repository as it will help me manage different issues with different people and also create a resource for people encountering a solved issue.
## 2. Viewing Detailed Source Code Documentation
------------------------------------------------
1. Source code documentation is provided in the code. If you don't want to read over it a detailed (auto-generated) version html/latex version is provided through [Doxygen](https://www.doxygen.nl/index.html).
2. The html version is located in **[path]/SMS_BP/docs/Doxygen/html**. To view the doc in your default browser use the (macOS) command `open docs/Doxygen/html/./include.html` assuming you are in the base SMS_BP directory. If not, append the relative path to the above command.
Raw data
{
"_id": null,
"home_page": null,
"name": "SMS-BP",
"maintainer": null,
"docs_url": null,
"requires_python": ">=3.10",
"maintainer_email": "Baljyot Singh Parmar <baljyotparmar@hotmail.com>",
"keywords": "SMS",
"author": null,
"author_email": "Baljyot Singh Parmar <baljyotparmar@hotmail.com>",
"download_url": "https://files.pythonhosted.org/packages/86/97/bd844bb3553bbd1b44f50e213555c3fb367a818939392203da7ba2f04929/sms_bp-0.1.5.tar.gz",
"platform": null,
"description": "\n\n# This is a short doc for the Track Simulations along with cluster simulations.\n-----------------------------------------\n\n- Author: Baljyot Singh Parmar\n- Affiliation at the time of writing: McGill University, Canada. Weber Lab\n\n\n\n## 1. Installation\n-------------------\n1. Make sure you have anaconda installed: <https://www.anaconda.com/download>\n2. Download or clone this repository.\n3. In the conda prompt, navigate to the folder where you downloaded this repository using : **cd \"path_to_folder\"**\n4. Using the **SMS_BP.yml** file, create a new environment using: **conda env create -f SMS_BP.yml**\n - If you get an environment resolve error but you have anaconda installed just skip to step 6. The .yml file is for people who are using miniconda and might not have the packages already installed with the full anaconda install.\n - You may want to still have a conda environment so just create a generic one if you want with the name SMS_BP or whatever you want with python>=3.10. Explicitly, **conda create -n [my_env_name] python=3.10**.\n5. Activate the environment using: **conda activate SMS_BP**\n6. Now we will install this package in edit mode so we can use its functionalities without invoking sys.path.append() every time.\n - Run the command: **pip install -e . --config-settings editable_mode=compat**\n - This will install the package in editable mode and you can now use the package in any python environment without having to append the path every time. \n\nTo start interacting with the program **cd SMS_BP** and follow the next steps.\nOkay now we can run the simulation with the predefined variables. For your understanding I rather have you read a short User Guide before I tell you how to run or use this code. Namely because it will help you think of the features included and what is possible. Now I want you to go to USER_GUIDE/USER_GUIDE.pdf and read the document. If you don't care, go to section 4 of that document to get right to the running of this code.\n\n7. This is a note on using the CLI tool properly. For the previous step I have forced you to go to the file location and run the script through python. But in the install (step 6) we also installed a CLI tool to interface with the program from anywhere (regardless of where you are in your terminal). The only condition is that you are in the SMS_BP conda environment. \n - To run the CLI tool after the install we can type **run_SMS_BP [PATH_TO_CONFIG_FILE]** from anywhere assuming the path you provide is absolute.\n - In the background all this is doing is running: **from SMS_BP.run_cell_simulation import main_CLI(); main_CLI()**. This is the entry point.\n - Do note that the config checker is not robust so if you have prodived the wrong types or excluded some parameters which are required alongside other ones you will get an error. Read the SMS_BP/sim_config.md for details into the config file parameters.\n8. If you run into any issues please create a Github issue on the repository as it will help me manage different issues with different people and also create a resource for people encountering a solved issue.\n\n## 2. Viewing Detailed Source Code Documentation\n------------------------------------------------\n1. Source code documentation is provided in the code. If you don't want to read over it a detailed (auto-generated) version html/latex version is provided through [Doxygen](https://www.doxygen.nl/index.html).\n2. The html version is located in **[path]/SMS_BP/docs/Doxygen/html**. To view the doc in your default browser use the (macOS) command `open docs/Doxygen/html/./include.html` assuming you are in the base SMS_BP directory. If not, append the relative path to the above command.\n",
"bugtrack_url": null,
"license": "--- # License --- Copyright (c) [2024] Baljyot Singh Parmar [All rights reserved]. Redistribution and use in source and binary forms, with or without modification, are permitted provided that the following conditions are met: Redistributions of source code must retain the above copyright notice, this list of conditions and the following disclaimer. THIS SOFTWARE IS PROVIDED BY Baljyot Singh Parmar \u201cAS IS\u201d AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL [Baljyot Singh Parmar] BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.",
"summary": "Single Molecule Simulations and Microscopy Simulations developed for the Weber Lab by Baljyot Singh Parmar",
"version": "0.1.5",
"project_urls": null,
"split_keywords": [
"sms"
],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "d4a22dddfece017256b23aa35c1b86e65920fb1ad8eae8c9ba23be83dfe2230f",
"md5": "20ac76612b4b2b24828f0351641cc74e",
"sha256": "0c4be893b7761b1b64cc17fef485ba7b4cb7c51224668e55be3e06dae212960a"
},
"downloads": -1,
"filename": "sms_bp-0.1.5-py3-none-any.whl",
"has_sig": false,
"md5_digest": "20ac76612b4b2b24828f0351641cc74e",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": ">=3.10",
"size": 34327,
"upload_time": "2024-09-20T22:49:14",
"upload_time_iso_8601": "2024-09-20T22:49:14.830894Z",
"url": "https://files.pythonhosted.org/packages/d4/a2/2dddfece017256b23aa35c1b86e65920fb1ad8eae8c9ba23be83dfe2230f/sms_bp-0.1.5-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": "",
"digests": {
"blake2b_256": "8697bd844bb3553bbd1b44f50e213555c3fb367a818939392203da7ba2f04929",
"md5": "88e77ce9a52e6a0fe320b1b78db82208",
"sha256": "34325b31bb971db4b8d338f42375ae686d55bcd3609f196300f4aec70fe2826f"
},
"downloads": -1,
"filename": "sms_bp-0.1.5.tar.gz",
"has_sig": false,
"md5_digest": "88e77ce9a52e6a0fe320b1b78db82208",
"packagetype": "sdist",
"python_version": "source",
"requires_python": ">=3.10",
"size": 28976483,
"upload_time": "2024-09-20T22:49:18",
"upload_time_iso_8601": "2024-09-20T22:49:18.290094Z",
"url": "https://files.pythonhosted.org/packages/86/97/bd844bb3553bbd1b44f50e213555c3fb367a818939392203da7ba2f04929/sms_bp-0.1.5.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2024-09-20 22:49:18",
"github": false,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"lcname": "sms-bp"
}
