cosmopharm 0.0.26__tar.gz → 0.0.27__tar.gz

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (23) hide show
  1. {cosmopharm-0.0.26 → cosmopharm-0.0.27}/LICENSE +20 -20
  2. {cosmopharm-0.0.26/src/cosmopharm.egg-info → cosmopharm-0.0.27}/PKG-INFO +150 -150
  3. {cosmopharm-0.0.26 → cosmopharm-0.0.27}/README.md +173 -173
  4. {cosmopharm-0.0.26 → cosmopharm-0.0.27}/setup.cfg +50 -50
  5. {cosmopharm-0.0.26 → cosmopharm-0.0.27}/setup.py +17 -17
  6. {cosmopharm-0.0.26 → cosmopharm-0.0.27}/src/cosmopharm/__init__.py +2 -2
  7. {cosmopharm-0.0.26 → cosmopharm-0.0.27}/src/cosmopharm/actmodels/actmodel.py +118 -118
  8. {cosmopharm-0.0.26 → cosmopharm-0.0.27}/src/cosmopharm/actmodels/cosmo.py +152 -152
  9. {cosmopharm-0.0.26 → cosmopharm-0.0.27}/src/cosmopharm/components.py +31 -31
  10. {cosmopharm-0.0.26 → cosmopharm-0.0.27}/src/cosmopharm/equilibrium/__init__.py +2 -2
  11. {cosmopharm-0.0.26 → cosmopharm-0.0.27}/src/cosmopharm/equilibrium/lle.py +178 -178
  12. {cosmopharm-0.0.26 → cosmopharm-0.0.27}/src/cosmopharm/equilibrium/sle.py +244 -244
  13. {cosmopharm-0.0.26 → cosmopharm-0.0.27}/src/cosmopharm/utils/__init__.py +3 -3
  14. {cosmopharm-0.0.26 → cosmopharm-0.0.27}/src/cosmopharm/utils/convert.py +58 -58
  15. {cosmopharm-0.0.26 → cosmopharm-0.0.27}/src/cosmopharm/utils/helpers.py +36 -36
  16. {cosmopharm-0.0.26 → cosmopharm-0.0.27}/src/cosmopharm/utils/lle_scanner.py +188 -188
  17. {cosmopharm-0.0.26 → cosmopharm-0.0.27}/src/cosmopharm/utils/spacing.py +246 -246
  18. {cosmopharm-0.0.26 → cosmopharm-0.0.27/src/cosmopharm.egg-info}/PKG-INFO +150 -150
  19. {cosmopharm-0.0.26 → cosmopharm-0.0.27}/src/cosmopharm/actmodels/__init__.py +0 -0
  20. {cosmopharm-0.0.26 → cosmopharm-0.0.27}/src/cosmopharm.egg-info/SOURCES.txt +0 -0
  21. {cosmopharm-0.0.26 → cosmopharm-0.0.27}/src/cosmopharm.egg-info/dependency_links.txt +0 -0
  22. {cosmopharm-0.0.26 → cosmopharm-0.0.27}/src/cosmopharm.egg-info/requires.txt +0 -0
  23. {cosmopharm-0.0.26 → cosmopharm-0.0.27}/src/cosmopharm.egg-info/top_level.txt +0 -0
@@ -1,21 +1,21 @@
1
- MIT License
2
-
3
- Copyright (c) 2024 Ivan Antolovic <Ivan.Antolovic@tu-berlin.de>, Martin Klajmon <Martin.Klajmon@vscht.cz>
4
-
5
- Permission is hereby granted, free of charge, to any person obtaining a copy
6
- of this software and associated documentation files (the "Software"), to deal
7
- in the Software without restriction, including without limitation the rights
8
- to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
9
- copies of the Software, and to permit persons to whom the Software is
10
- furnished to do so, subject to the following conditions:
11
-
12
- The above copyright notice and this permission notice shall be included in all
13
- copies or substantial portions of the Software.
14
-
15
- THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
16
- IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
17
- FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
18
- AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
19
- LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
20
- OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
1
+ MIT License
2
+
3
+ Copyright (c) 2024 Ivan Antolovic <Ivan.Antolovic@tu-berlin.de>, Martin Klajmon <Martin.Klajmon@vscht.cz>
4
+
5
+ Permission is hereby granted, free of charge, to any person obtaining a copy
6
+ of this software and associated documentation files (the "Software"), to deal
7
+ in the Software without restriction, including without limitation the rights
8
+ to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
9
+ copies of the Software, and to permit persons to whom the Software is
10
+ furnished to do so, subject to the following conditions:
11
+
12
+ The above copyright notice and this permission notice shall be included in all
13
+ copies or substantial portions of the Software.
14
+
15
+ THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
16
+ IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
17
+ FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
18
+ AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
19
+ LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
20
+ OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
21
21
  SOFTWARE.
@@ -1,150 +1,150 @@
1
- Metadata-Version: 2.1
2
- Name: cosmopharm
3
- Version: 0.0.26
4
- Summary: Predictive modeling for drug-polymer compatibility in pharmaceutical formulations using COSMO-SAC.
5
- Home-page: https://github.com/ivanantolo/cosmopharm,
6
- Author: Ivan Antolovic
7
- Author-email: Ivan.Antolovic@tu-berlin.de
8
- Maintainer: Martin Klajmon
9
- Maintainer-email: Martin.Klajmon@vscht.cz
10
- License: MIT
11
- Keywords: Drug-Polymer Compatibility,Amorphous Solid Dispersions,Pharmaceutical Formulation,COSMO-SAC Model,Solubility Prediction,Miscibility Analysis,Phase Behavior Prediction,Pharmaceutical Sciences,Drug Formulation Research,Polymer Science,Predictive Modeling in Pharma,Drug Development Tools,Biopharmaceuticals
12
- Classifier: Development Status :: 3 - Alpha
13
- Classifier: Intended Audience :: Science/Research
14
- Classifier: Intended Audience :: Healthcare Industry
15
- Classifier: Intended Audience :: Developers
16
- Classifier: Intended Audience :: Education
17
- Classifier: License :: OSI Approved :: MIT License
18
- Classifier: Topic :: Scientific/Engineering
19
- Classifier: Topic :: Scientific/Engineering :: Bio-Informatics
20
- Classifier: Topic :: Scientific/Engineering :: Chemistry
21
- Classifier: Programming Language :: Python :: 3
22
- Classifier: Programming Language :: Python :: 3 :: Only
23
- Classifier: Programming Language :: Python :: 3.8
24
- Classifier: Programming Language :: Python :: 3.9
25
- Classifier: Programming Language :: Python :: 3.10
26
- Classifier: Programming Language :: Python :: 3.11
27
- Classifier: Programming Language :: Python :: 3.12
28
- Classifier: Programming Language :: Python :: 3.13
29
- Requires-Python: >=3.8
30
- Description-Content-Type: text/markdown
31
- License-File: LICENSE
32
- Requires-Dist: numpy>=1.15
33
- Requires-Dist: pandas>=1.0
34
- Requires-Dist: scipy>=1.4
35
- Requires-Dist: openpyxl>=3.0
36
- Provides-Extra: examples
37
- Requires-Dist: matplotlib>=3.0; extra == "examples"
38
-
39
- # COSMOPharm
40
-
41
- Welcome to the COSMOPharm package, accompanying [our paper in *Molecular Pharmaceutics*](https://doi.org/10.1021/acs.molpharmaceut.4c00342). This project and its associated publication offer insights and a practical toolkit for researching drug-polymer and drug-solvent systems, aiming to provide the scientific community with the means to reproduce our findings and further the development of COSMO-SAC-based models.
42
-
43
- <p align="center">
44
- <!-- <img src="https://github.com/usnistgov/COSMOSAC/raw/master/JCTC2020.PNG" alt="TOC Figure" width="500"> -->
45
- <img src="https://raw.githubusercontent.com/ivanantolo/cosmopharm/main/TOC.png" alt="TOC Figure">
46
- </p>
47
-
48
- ## About
49
-
50
- COSMOPharm is a Python package designed to streamline the predictive modeling of drug-polymer compatibility, crucial for the development of pharmaceutical amorphous solid dispersions. Apart from that, it can also be used for the miscibility/solubility of drugs with/in common solvents. Leveraging the COSMO-SAC (Conductor-like Screening Model Segment Activity Coefficient) model, COSMOPharm offers a robust platform for scientists and researchers to predict solubility, miscibility, and phase behavior in drug formulation processes.
51
-
52
- ## Features
53
-
54
- - **Compatibility Prediction**: Utilize open-source COSMO-SAC model for prediction of drug-polymer compatibility.
55
- - **Solubility Calculation**: Calculate drug-polymer solubilities to guide the selection of suitable polymers for drug formulations.
56
- - **Miscibility and Phase Behavior Analysis**: Analyze the miscibility of drug-polymer pairs and understand their phase behavior under various conditions.
57
- - **User-friendly Interface**: Easy-to-use functions and comprehensive documentation to facilitate research and development in pharmaceutical sciences.
58
-
59
- ## Installation
60
-
61
- Install COSMOPharm with pip:
62
-
63
- `pip install cosmopharm`
64
-
65
- Ensure you have installed the `cCOSMO` library as per instructions on the [COSMOSAC GitHub page](https://github.com/usnistgov/COSMOSAC).
66
-
67
- ## Quick Start
68
-
69
- Get started with COSMOPharm using the minimal example below, which demonstrates how to calculate the solubility of a drug in a polymer. This example succinctly showcases the use of COSMOPharm for solubility calculations:
70
-
71
-
72
- ```python
73
- import matplotlib.pyplot as plt
74
- import cCOSMO
75
- from cosmopharm import SLE, COSMOSAC
76
- from cosmopharm.utils import create_components, read_params
77
-
78
- # Define components
79
- names = ['SIM','PLGA50']
80
- params_file = "data/sle/table_params.xlsx"
81
-
82
- # Load parameters and create components
83
- parameters = read_params(params_file)
84
- mixture = create_components(names, parameters)
85
-
86
- # Initialize COSMO-SAC model - replace paths with your local paths to COSMO profiles
87
- db = cCOSMO.DelawareProfileDatabase(
88
- "./profiles/_import_methods/UD/complist.txt",
89
- "./profiles/_import_methods/UD/sigma3/")
90
-
91
- for name in names:
92
- iden = db.normalize_identifier(name)
93
- db.add_profile(iden)
94
- COSMO = cCOSMO.COSMO3(names, db)
95
-
96
- # Setup the COSMO-SAC model with components
97
- actmodel = COSMOSAC(COSMO, mixture=mixture)
98
-
99
- # Calculate solubility (SLE)
100
- sle = SLE(actmodel=actmodel)
101
- solubility = sle.solubility(mix='real')
102
-
103
- # Output the solubility
104
- print(solubility[['T', 'w', 'x']].to_string(index=False))
105
-
106
- # Plot results
107
- plt.plot(*solubility[['w','T']].values.T,'.-', label='Solubility (w)')
108
-
109
- # Settings
110
- plt.xlim(0,1)
111
- plt.ylim(300,500)
112
- # Adding title and labels
113
- plt.title('Solubility vs. Temperature')
114
- plt.ylabel("T / K")
115
- xlabel = {'w':'Weight', 'x':'Mole'}
116
- plt.xlabel(f"Weight fraction {mixture[0].name}")
117
- plt.legend()
118
- # Save the figure to a PNG or PDF file
119
- plt.savefig('solubility_plot.png') # Saves the plot as a PNG file
120
- # plt.savefig('solubility_plot.pdf') # Saves the plot as a PDF file
121
- plt.show()
122
- ```
123
-
124
- For a more comprehensive demonstration, including advanced functionalities and plotting results, please see the [example_usage.py](https://github.com/ivanantolo/cosmopharm/blob/main/example_usage.py) script in this repository. This detailed example walks through the process of setting up COSMOPharm, initializing models, and visualizing the results of solubility and miscibility calculations.
125
-
126
- ## Contributing
127
-
128
- Contributions are welcome! Please refer to our [GitHub repository](https://github.com/ivanantolo/cosmopharm) for more information.
129
-
130
- ## Citation
131
-
132
- We appreciate citations to our work as they help acknowledge and spread our research contributions. If you use COSMOPharm in your research, please cite the associated paper as follows:
133
-
134
- ```bibtex
135
- @article{Antolovic2024COSMOPharm,
136
- title={COSMOPharm: Drug--Polymer Compatibility of Pharmaceutical Amorphous Solid Dispersions from COSMO-SAC},
137
- author={Antolovic, Ivan and Vrabec, Jadran and Klajmon, Martin},
138
- journal={Molecular Pharmaceutics},
139
- year={2024},
140
- volume={1}, # Will be adjusted accordingly
141
- issue={1}, # Will be adjusted accordingly
142
- month={3}, # Will be adjusted accordingly
143
- pages={1--10}, # Will be adjusted accordingly
144
- doi={10.1021/acs.molpharmaceut.3c12345} # Will be adjusted accordingly
145
- }
146
- ```
147
-
148
- ## License
149
-
150
- COSMOPharm is released under the MIT License. For more details, see the [LICENSE](https://github.com/ivanantolo/cosmopharm/LICENSE) file.
1
+ Metadata-Version: 2.1
2
+ Name: cosmopharm
3
+ Version: 0.0.27
4
+ Summary: Predictive modeling for drug-polymer compatibility in pharmaceutical formulations using COSMO-SAC.
5
+ Home-page: https://github.com/ivanantolo/cosmopharm,
6
+ Author: Ivan Antolovic
7
+ Author-email: Ivan.Antolovic@tu-berlin.de
8
+ Maintainer: Martin Klajmon
9
+ Maintainer-email: Martin.Klajmon@vscht.cz
10
+ License: MIT
11
+ Keywords: Drug-Polymer Compatibility,Amorphous Solid Dispersions,Pharmaceutical Formulation,COSMO-SAC Model,Solubility Prediction,Miscibility Analysis,Phase Behavior Prediction,Pharmaceutical Sciences,Drug Formulation Research,Polymer Science,Predictive Modeling in Pharma,Drug Development Tools,Biopharmaceuticals
12
+ Classifier: Development Status :: 3 - Alpha
13
+ Classifier: Intended Audience :: Science/Research
14
+ Classifier: Intended Audience :: Healthcare Industry
15
+ Classifier: Intended Audience :: Developers
16
+ Classifier: Intended Audience :: Education
17
+ Classifier: License :: OSI Approved :: MIT License
18
+ Classifier: Topic :: Scientific/Engineering
19
+ Classifier: Topic :: Scientific/Engineering :: Bio-Informatics
20
+ Classifier: Topic :: Scientific/Engineering :: Chemistry
21
+ Classifier: Programming Language :: Python :: 3
22
+ Classifier: Programming Language :: Python :: 3 :: Only
23
+ Classifier: Programming Language :: Python :: 3.8
24
+ Classifier: Programming Language :: Python :: 3.9
25
+ Classifier: Programming Language :: Python :: 3.10
26
+ Classifier: Programming Language :: Python :: 3.11
27
+ Classifier: Programming Language :: Python :: 3.12
28
+ Classifier: Programming Language :: Python :: 3.13
29
+ Requires-Python: >=3.8
30
+ Description-Content-Type: text/markdown
31
+ License-File: LICENSE
32
+ Requires-Dist: numpy>=1.15
33
+ Requires-Dist: pandas>=1.0
34
+ Requires-Dist: scipy>=1.4
35
+ Requires-Dist: openpyxl>=3.0
36
+ Provides-Extra: examples
37
+ Requires-Dist: matplotlib>=3.0; extra == "examples"
38
+
39
+ # COSMOPharm
40
+
41
+ Welcome to the COSMOPharm package, accompanying [our paper in *Molecular Pharmaceutics*](https://doi.org/10.1021/acs.molpharmaceut.4c00342). This project and its associated publication offer insights and a practical toolkit for researching drug-polymer and drug-solvent systems, aiming to provide the scientific community with the means to reproduce our findings and further the development of COSMO-SAC-based models.
42
+
43
+ <p align="center">
44
+ <!-- <img src="https://github.com/usnistgov/COSMOSAC/raw/master/JCTC2020.PNG" alt="TOC Figure" width="500"> -->
45
+ <img src="https://raw.githubusercontent.com/ivanantolo/cosmopharm/main/TOC.png" alt="TOC Figure">
46
+ </p>
47
+
48
+ ## About
49
+
50
+ COSMOPharm is a Python package designed to streamline the predictive modeling of drug-polymer compatibility, crucial for the development of pharmaceutical amorphous solid dispersions. Apart from that, it can also be used for the miscibility/solubility of drugs with/in common solvents. Leveraging the COSMO-SAC (Conductor-like Screening Model Segment Activity Coefficient) model, COSMOPharm offers a robust platform for scientists and researchers to predict solubility, miscibility, and phase behavior in drug formulation processes.
51
+
52
+ ## Features
53
+
54
+ - **Compatibility Prediction**: Utilize open-source COSMO-SAC model for prediction of drug-polymer compatibility.
55
+ - **Solubility Calculation**: Calculate drug-polymer solubilities to guide the selection of suitable polymers for drug formulations.
56
+ - **Miscibility and Phase Behavior Analysis**: Analyze the miscibility of drug-polymer pairs and understand their phase behavior under various conditions.
57
+ - **User-friendly Interface**: Easy-to-use functions and comprehensive documentation to facilitate research and development in pharmaceutical sciences.
58
+
59
+ ## Installation
60
+
61
+ Install COSMOPharm with pip:
62
+
63
+ `pip install cosmopharm`
64
+
65
+ Ensure you have installed the `cCOSMO` library as per instructions on the [COSMOSAC GitHub page](https://github.com/usnistgov/COSMOSAC).
66
+
67
+ ## Quick Start
68
+
69
+ Get started with COSMOPharm using the minimal example below, which demonstrates how to calculate the solubility of a drug in a polymer. This example succinctly showcases the use of COSMOPharm for solubility calculations:
70
+
71
+
72
+ ```python
73
+ import matplotlib.pyplot as plt
74
+ import cCOSMO
75
+ from cosmopharm import SLE, COSMOSAC
76
+ from cosmopharm.utils import create_components, read_params
77
+
78
+ # Define components
79
+ names = ['SIM','PLGA50']
80
+ params_file = "data/sle/table_params.xlsx"
81
+
82
+ # Load parameters and create components
83
+ parameters = read_params(params_file)
84
+ mixture = create_components(names, parameters)
85
+
86
+ # Initialize COSMO-SAC model - replace paths with your local paths to COSMO profiles
87
+ db = cCOSMO.DelawareProfileDatabase(
88
+ "./profiles/_import_methods/UD/complist.txt",
89
+ "./profiles/_import_methods/UD/sigma3/")
90
+
91
+ for name in names:
92
+ iden = db.normalize_identifier(name)
93
+ db.add_profile(iden)
94
+ COSMO = cCOSMO.COSMO3(names, db)
95
+
96
+ # Setup the COSMO-SAC model with components
97
+ actmodel = COSMOSAC(COSMO, mixture=mixture)
98
+
99
+ # Calculate solubility (SLE)
100
+ sle = SLE(actmodel=actmodel)
101
+ solubility = sle.solubility(mix='real')
102
+
103
+ # Output the solubility
104
+ print(solubility[['T', 'w', 'x']].to_string(index=False))
105
+
106
+ # Plot results
107
+ plt.plot(*solubility[['w','T']].values.T,'.-', label='Solubility (w)')
108
+
109
+ # Settings
110
+ plt.xlim(0,1)
111
+ plt.ylim(300,500)
112
+ # Adding title and labels
113
+ plt.title('Solubility vs. Temperature')
114
+ plt.ylabel("T / K")
115
+ xlabel = {'w':'Weight', 'x':'Mole'}
116
+ plt.xlabel(f"Weight fraction {mixture[0].name}")
117
+ plt.legend()
118
+ # Save the figure to a PNG or PDF file
119
+ plt.savefig('solubility_plot.png') # Saves the plot as a PNG file
120
+ # plt.savefig('solubility_plot.pdf') # Saves the plot as a PDF file
121
+ plt.show()
122
+ ```
123
+
124
+ For a more comprehensive demonstration, including advanced functionalities and plotting results, please see the [example_usage.py](https://github.com/ivanantolo/cosmopharm/blob/main/example_usage.py) script in this repository. This detailed example walks through the process of setting up COSMOPharm, initializing models, and visualizing the results of solubility and miscibility calculations.
125
+
126
+ ## Contributing
127
+
128
+ Contributions are welcome! Please refer to our [GitHub repository](https://github.com/ivanantolo/cosmopharm) for more information.
129
+
130
+ ## Citation
131
+
132
+ We appreciate citations to our work as they help acknowledge and spread our research contributions. If you use COSMOPharm in your research, please cite the associated paper as follows:
133
+
134
+ ```bibtex
135
+ @article{Antolovic2024COSMOPharm,
136
+ title={COSMOPharm: Drug--Polymer Compatibility of Pharmaceutical Amorphous Solid Dispersions from COSMO-SAC},
137
+ author={Antolovic, Ivan and Vrabec, Jadran and Klajmon, Martin},
138
+ journal={Molecular Pharmaceutics},
139
+ year={2024},
140
+ volume={1}, # Will be adjusted accordingly
141
+ issue={1}, # Will be adjusted accordingly
142
+ month={3}, # Will be adjusted accordingly
143
+ pages={1--10}, # Will be adjusted accordingly
144
+ doi={10.1021/acs.molpharmaceut.3c12345} # Will be adjusted accordingly
145
+ }
146
+ ```
147
+
148
+ ## License
149
+
150
+ COSMOPharm is released under the MIT License. For more details, see the [LICENSE](https://github.com/ivanantolo/cosmopharm/LICENSE) file.