Home Examples Screenshots User manual Bluesky logo
OghmaNano Simulate organic/Perovskite Solar Cells, OFETs, and OLEDs DOWNLOAD

Materials database

This database primarily contains n/k data and PL emission spectra. However it also contains some electrical information and some thermal information. Each subdirectory within the materials database identifies the material name. In each sub directory there are two key files \(alpha.csv\) and \(n.csv\), these files are standard text files can be opened with any text editor such as wordpad. Alpha.csv contains the absorption coefficient of the material while n.csv contains the the refractive index. The first column of the file contains the wavelength in \(m\) (not \(cm\) or \(nm\)), and the second column of the file contains the absorption coefficient in \(m^{-1}\) (for alpha.csv) and the real part of the refractive index (i.e. n) in au (for n.csv). The data.json defines the material color and any known electrical or thermal data. If the material is used in emissive optical simulations the emission spectra of the material will be stored in a file called \(emission.csv\). An example material directory, in this case Alq3 can be seen in figure 15.2, a description of these files can be found in 15.1.

File manager window showing the Alq3 material directory with files alpha.csv, data.json, mat.bib, n.csv, and emission.csv
An example of a Materials database item for Alq3, showing the files alpha.csv, data.json, mat.bib, n.csv, and emission.csv.
File name Description
data.json JSON file containing information about the material (e.g. LUMO/HOMO levels).
alpha.csv Wavelength (m) vs absorption coefficient (m-1).
n.csv Wavelength (m) vs refractive index (a.u.).
emission.csv* Wavelength (m) vs PL emission (a.u.).
mat.bib BibTeX file containing references for the material.
Summary of the files making up each material in the materials database. *The file emission.csv is only required if the material forms part of an emissive layer of an OLED or other light-emitting device.

Adding new materials - the hard way

If you wish to add materials to the database which do not come as standard with the model you can do it in the following way: Simply copy an existing material directory (say oghma_local\(\backslash\)materials\(\backslash\)oxieds\(\backslash\)ito) to a new directory (say oghma_local\(\backslash\)materials\(\backslash\)oxieds\(\backslash\)mynewmaterial). Then replace alpha.csv and n.csv with your data for the new material. You can ignore the data.json file, although if you know the energy levels you can add the values in the file.

If you don’t have data to hand for your material, but you do have a paper containing the data, you use the program Engauge Digitizer, written by Mark Mitchell https://github.com/markummitchell/engauge-digitizer to export data from publications. After you have finished updating the new material directory, whenever a new simulation is generated the new material files will automatically be copied into the active simulation directory ready for use.

Adding new materials - the easy way

To add a new material go to the database ribbon and click on Materials database as shown in figure 15.3.

OghmaNano Databases ribbon with the Materials database icon highlighted in red
Opening the Materials database from the Databases ribbon.

Then click add material in the top right of the window, this will bring up a dialogue box which will ask you to give a name for your new material, this is visible in figure [fig:materialadd3]. In this case we called the material my_new_material.

OghmaNano Materials database window showing the Add Material button highlighted
Adding a new material to the Materials database using the Add Material button.
Dialog window in OghmaNano prompting for a new material name, with example 'my_new_material'
Naming a new material in the Materials database dialog.

Once you have clicked OK the new material will appear see Figure [fig:materialadd4], open it by double clicking on it. This will bring up an empty material window with no data. See Figure [fig:materialadd5].

OghmaNano Materials database window showing the newly created material 'my_new_material' highlighted in red
The new material my_new_material added to the Materials database.
OghmaNano Material editor window for a newly created material, showing empty data tabs for Absorption, Refractive index, Basic, Electrical parameters, and Thermal parameters
The Material editor window for the newly created material my_new_material, initially empty of data.

To import data to the material use the Import data from file button situated on the top left of the material window see Figure [fig:materialadd5] this will bring up the import data wizard which is shown in Figure 15.4. To use this wizard follow these steps:

  1. Open the file you want to import. The file must be a plain text file or a CSV file.
  2. Once the file has been loaded it will be displayed in the text box on the left.
  3. Select the units of the x-axis of the original file.
  4. Select the units of the y-axis of the original file.
  5. The file will appear converted into SI units in the right-hand text box.
  6. If you are happy with the conversion, click Import data and the data will be saved.

This process can be seen in 15.4, once done the imported data will appear in the material as shown on the top left of 15.8. In this example absorption data was imported, for the material to be used in a simulation the refractive index (real part) will also need to be imported.

OghmaNano data importer window showing steps to import material data with labelled regions a) to f)
The Data importer window in OghmaNano, showing the workflow for importing material data: a) open data file, b) preview of the imported file, c) select x-axis units, d) select y-axis units, e) converted file in SI units, f) import the data.
OghmaNano Material editor showing imported absorption spectrum data for my_new_material
Absorption spectrum
OghmaNano Material editor showing the basic material parameters tab
Basic parameters
OghmaNano Material editor showing electrical parameters for my_new_material
Electrical parameters
OghmaNano Material editor showing thermal parameters for my_new_material
Thermal parameters

But I have a data in nm/n/k format

Usually OghamNano only accepts data input in SI units and usually only accepts input in one format. This is to reduce the overall number of lines of code and reduce maintenance. However, I have been asked to make the model accept data of format: wavelength (nm), refractive index (au), k (au), as shown in Figure 15.9. OghmaNano will be able to read this file if you simply copy it into your_home_directory\(\backslash\)oghma_local\(\backslash\)materials and give it a file extension .nk, so for example ito.nk. Where your_home_directory is simply your Windows home directory. It is usually located on the C:\(\backslash\)Users on a home PC but the location can change if you are on a corporate PC. Once you have dragged the file into your_home_directory\(\backslash\)oghma_local\(\backslash\)materials it will appear as a material in the model. See Figure 15.10. You can see that the .nk file in Figure 15.10 is greyed out, this is because it is a non standard OghamNano file, that OghmaNano can read but not edit.

Example of a wavelength/n/k data file format used in OghmaNano, showing columns for wavelength (nm), refractive index (n), and extinction coefficient (k)
An example of a .nk file containing wavelength, refractive index (n), and extinction coefficient (k) data.
OghmaNano Materials database showing a greyed-out .nk file entry, indicating wavelength/n/k data in a non-native format
An example of a .nk file in the Materials database. The entry is greyed out to indicate that, while readable, it is not in native OghmaNano format.