You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
- if [[ "$TARGET" = test ]]; then make -j10 test && travis_wait ./test/Ising_OPV_tests.exe && travis_wait mpiexec -n 4 ./test/Ising_OPV_MPI_tests.exe; fi
48
+
- if [[ "$TARGET" = test_default ]]; then make -j10 && travis_wait mpiexec -n 4 ./Ising_OPV.exe parameters_default.txt; fi
49
+
- if [[ "$TARGET" = test_example1 ]]; then make -j10 && travis_wait mpiexec -n 4 ./Ising_OPV.exe ./examples/example1/parameters_ex1.txt; fi
50
+
- if [[ "$TARGET" = test_coverage ]]; then make -j10 test_coverage && travis_wait ./test/Ising_OPV_tests.exe && travis_wait mpiexec -n 4 ./test/Ising_OPV_MPI_tests.exe; fi
46
51
- if [[ "$TARGET" = test_coverage ]]; then coveralls --include src --exclude "googletest/*" --gcov-options '\-lp'; fi
47
-
- if [[ "$TARGET" = test ]]; then make -j10 && mpiexec -n 4 ./Ising_OPV.exe parameters_default.txt; fi
| Development |[](https://coveralls.io/github/MikeHeiber/Ising_OPV?branch=development)|
| Development |[](https://coveralls.io/github/MikeHeiber/Ising_OPV?branch=development)|
40
42
41
43
## Contact
42
44
@@ -81,7 +83,7 @@ Similar batch scripts can also be written for TORQUE or other job schedulers.
81
83
82
84
Regardless of the job scheduler, the program execution command is essentially the same.
83
85
Ising_OPV.exe takes one required input argument, which is the filename of the input parameter file.
84
-
An annotated example parameter file is provided with this package (parameters_default.txt).
86
+
An annotated default parameter file is provided with this package (parameters_default.txt).
85
87
86
88
For example, to create 10 morphologies using 10 processors with the default parameters, the command is:
87
89
@@ -91,11 +93,13 @@ Users can also import morphology sets previously generated by the Ising_OPV tool
91
93
This will import the morphologies (morphology_0.txt, morphology_1.txt, etc) and assign one to each processor.
92
94
The morphology files must be located in the working directory to be found and imported.
93
95
94
-
Finally, users can also import experimental tomogram image data, generate a morphology set from the data, and then perform further operations by enabling tomogram import in the parameter file and specifying the name of tomogram dataset.
96
+
Finally, users can also import experimental 3D tomography image data, generate a morphology set from the data, and then perform further operations by enabling tomogram import in the parameter file and specifying the name of tomogram dataset.
95
97
The tomogram metadata is imported from an XML metadata file and then that is used for interpreting a RAW binary data file that contains the image data.
98
+
The metadata format required by Ising_OPV is defined in XML schema definition file, tomogram_metadata.xsd.
96
99
Once the tomogram data is loaded, the morphology can be segmented into a number of equally size sub-volumes to form a new morphology set, and then the rest of the analysis is performed.
97
100
Again, the tomogram dataset files must be located in the working directory to be found and imported.
98
-
Also, the metadata format required by Ising_OPV is defined in XML schema definition file, tomogram_metadata.xsd.
101
+
102
+
For more detailed examples, please see the [Examples](./examples/examples.md) file.
99
103
100
104
#### Simulation Output
101
105
@@ -124,11 +128,15 @@ While this tool is designed to be primarily controlled through the parameter fil
124
128
## Citing this Work
125
129
126
130
If you find Ising_OPV to be helpful for your research, please cite the original study:
131
+
127
132
[M. C. Heiber and A. Dhinojwala, Phys. Rev. Appl. **2**, 014008 (2014).](http://journals.aps.org/prapplied/abstract/10.1103/PhysRevApplied.2.014008)[[ResearchGate]](https://www.researchgate.net/publication/264419218_Efficient_Generation_of_Model_Bulk_Heterojunction_Morphologies_for_Organic_Photovoltaic_Device_Modeling)
128
133
129
134
If your work involves investigating the effects of morphological tortuosity, please also cite the study that introduced the tortuosity features:
135
+
130
136
[M.C. Heiber, K. Kister, A. Baumann, V. Dyakonov, C. Deibel, and T.-Q. Nguyen, Phys. Rev. Appl. **8**, 054043 (2017).](https://journals.aps.org/prapplied/abstract/10.1103/PhysRevApplied.8.054043)[[ResearchGate]](https://www.researchgate.net/publication/321226076_Impact_of_Tortuosity_on_Charge-Carrier_Transport_in_Organic_Bulk_Heterojunction_Blends)
131
137
138
+
In addition, please also cite the DOI for the specific version that you used from [Zenodo.org](https://zenodo.org/search?page=1&size=20&q=conceptrecid:%22592959%22&sort=-version&all_versions=True).
139
+
132
140
## Additional Reference List
133
141
Several peer-reviewed publications discuss the development and application of this software tool:
134
142
@@ -140,7 +148,7 @@ Several peer-reviewed publications discuss the development and application of th
140
148
-[M.C. Heiber, K. Kister, A. Baumann, V. Dyakonov, C. Deibel, and T.-Q. Nguyen, Phys. Rev. Appl. **8**, 054043 (2017).](https://journals.aps.org/prapplied/abstract/10.1103/PhysRevApplied.8.054043)[[ResearchGate]](https://www.researchgate.net/publication/321226076_Impact_of_Tortuosity_on_Charge-Carrier_Transport_in_Organic_Bulk_Heterojunction_Blends)
141
149
142
150
## Acknowledgments
143
-
Thank you to Dr. Dean DeLongchamp at NIST for providing access to computing resources that support the ongoing development of v4.0.
151
+
Thank you to Dr. Dean M. DeLongchamp at NIST for providing access to computing resources that support the ongoing development of v4.0.
144
152
Development of v4.0 is supported by financial assistance award 70NANB14H012 from U.S. Department of Commerce, National Institute of Standards and Technology as part of the Center for Hierarchical Materials Design (CHiMaD).
145
153
146
154
Thank you to Klaus Kister for contributing to the development of the updated domain smoothing algorithm and the simplified morphology import procedure in v2.0 and help with testing for v3.0.
0 commit comments