-
Notifications
You must be signed in to change notification settings - Fork 13
Commit
This commit does not belong to any branch on this repository, and may belong to a fork outside of the repository.
- Loading branch information
Showing
1 changed file
with
35 additions
and
35 deletions.
There are no files selected for viewing
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -1,35 +1,35 @@ | ||
![PorousMaterials.jl](assets/PMlogo.png) | ||
A pure-[Julia](https://julialang.org/) package for classical molecular modeling of adsorption in porous crystals such as metal-organic frameworks (MOFs). | ||
|
||
🔨 Compute the potential energy of a molecule at particular position and orientation inside of a porous crystal | ||
|
||
🔨 Write a potential energy grid of a molecule inside a porous material to visualize binding sites | ||
|
||
🔨 Compute the Henry coefficient of a gas in a porous crystal | ||
|
||
🔨 Run grand-canonical Monte Carlo simulations of gas adsorption in a porous crystal | ||
|
||
Designed for high-throughput computations to minimize input files and querying results from output files. User-friendly. Instructive error messages thrown when they should be. Well-documented. Easy to install. | ||
|
||
*In development, please contribute, post issues 🐛, and improve!* | ||
|
||
## Installation | ||
|
||
1. Download and install the [Julia programming language](https://julialang.org/), v1.5 or higher. | ||
|
||
2. In Julia, open the package manager (using `]`) and enter the following: | ||
|
||
```julia | ||
pkg> add PorousMaterials | ||
``` | ||
|
||
3. In Julia, load all functions in `PorousMaterials.jl` into the namespace: | ||
|
||
```julia | ||
julia> using PorousMaterials # that's it | ||
``` | ||
|
||
## Tests | ||
Run the tests in the script `tests/runtests.jl` manually or by `] test PorousMaterials` in the Julia REPL. | ||
|
||
Direct tests for Henry coefficients and grand-canonical Monte Carlo simulations take much longer and must be run separately; they are found in `tests/henry.jl` and `tests/gcmc_long.jl`. | ||
![PorousMaterials.jl](assets/PMlogo.png) | ||
A pure-[Julia](https://julialang.org/) package for classical molecular modeling of adsorption in porous crystals such as metal-organic frameworks (MOFs). | ||
|
||
🔨 Compute the potential energy of a molecule at particular position and orientation inside of a porous crystal | ||
|
||
🔨 Write a potential energy grid of a molecule inside a porous material to visualize binding sites | ||
|
||
🔨 Compute the Henry coefficient of a gas in a porous crystal | ||
|
||
🔨 Run grand-canonical Monte Carlo simulations of gas adsorption in a porous crystal | ||
|
||
Designed for high-throughput computations to minimize input files and querying results from output files. User-friendly. Instructive error messages thrown when they should be. Well-documented. Easy to install. | ||
|
||
*In development, please contribute, post issues 🐛, and improve!* | ||
|
||
## Installation | ||
|
||
1. Download and install the [Julia programming language](https://julialang.org/), v1.5 or higher. | ||
|
||
2. In Julia, open the package manager (using `]`) and enter the following: | ||
|
||
```julia | ||
pkg> add PorousMaterials | ||
``` | ||
|
||
3. In Julia, load all functions in `PorousMaterials.jl` into the namespace: | ||
|
||
```julia | ||
julia> using PorousMaterials # that's it | ||
``` | ||
|
||
## Tests | ||
Run the tests in the script `tests/runtests.jl` manually or by `] test PorousMaterials` in the Julia REPL. | ||
|
||
Direct tests for Henry coefficients and grand-canonical Monte Carlo simulations take much longer and must be run separately; they are found in `tests/henry.jl` and `tests/gcmc_long.jl`. |