Release Notes¶
Version 1.0.8 Stable¶
11-07-2023¶
New¶
Separated pyemaps simulations backend into standalone python package.
pyemaps package installation automatically installs backend python package. as one of its depedencies.
Made pyemaps source code ready for open source and community contribution. We invite you to become pyemaps contributor, contact support@emlabsoftware.com for further information.
Improvements¶
Bug fixes related to DigitalMicrograph (DM) integration and added DM python script sample code, as shown in Rendering by Third Party Tools
Version 1.0.7 Stable¶
07-07-2023¶
New¶
Annular dark field (ADF) for an experimental diffraction image. This new feature is only available in full and paid package.
See generateADF and sample code adf.py for usage details.
GUI server is now setup for easy and fast access to the latest pyemaps for a subscription fee. Go to: https://emaps.emlabsolutions.com
Improvements¶
Bug fixes
Updated EMC control when x-axis input is the default of (0,0,0) when pyemaps will calculate the value. This value is then updated in the output control for kinematical and dynamic diffraction simulations, as well as stereodiagram.
Version 1.0.6 Stable¶
05-27-2023¶
Improvements¶
Large angle CBED image generation sample code si_lacbed.py added.
Bug fixes
Version 1.0.5 Stable¶
05-12-2023¶
New¶
Large angle CBED pattern generation.
Calculated diffracted beams for dynamic diffraction simulation or Bloch session.
See generateBloch for details.
Improvements¶
Optimization in bloch image generation for multiple sample thickness.
Version 1.0.4 Stable¶
05-07-2023¶
Improvements¶
Incremental memory performance improvement in Bloch simulation.
getBeams function folded into getSCMatrix as one of its return elements. See sample code si_scm.py for demonstration of the usage changes.
Bug fixes.
Version 1.0.3 Stable¶
04-23-2023¶
Improvements¶
A major memory improvement in dynamic diffraction simulation(Bloch), resulting a large performance improvement in Bloch simulation.
Bloch simulation functions related to scattering matrix calculation and its associated computations re-organized as follows:
getEigen function is folded into getSCMatrix call starting from Stable verion 1.0.3
See documents for details of the changes for each functions. Also, the sample code si_scm.py shows the usage changes.
More performance improvement are coming up, stay tuned.
Version 1.0.2 Stable¶
04-02-2023¶
New¶
In preview:
Diffraction pattern database builder.
Version 1.0.1 Stable¶
02-16-2023¶
Improvements¶
Bug fixes in single simulation display functions and other incremental improvements.
Send your suggestions and comments to support@emlabsoftware.com.
Version 1.0.0 Stable¶
02-07-2023¶
The first stable version!
Improvements¶
Bug fixes in dynamic diffraction simulations. The temporary file name collision issue discovered during some multiprocess executions is now fixed. We’d like to thank our users for reporting the issue.
Send your suggestions and comments to support@emlabsoftware.com.
Version 0.6.2 Beta¶
01-15-2023¶
Improvements¶
Bug fixes.
Display function parameters naming changes to be more consistent. Specifically, ishow and kshow parameters are now becoming iShow and kShow as show below:
showDif(.., iShow=True, kShow = True)
- In additional each of the display functions
showDif
showBloch
showStereo
gains an optional boolean input parameter bClose with default of False. This input controls whether the display windows close or not after all displays are completed. Default value, if not set, is False. In which case, users must close the display windows manuallly for each display, failure to do so may result in too many display windows.
showBloch(.., bClose=True,..)
Setting bClose to True is useful where the display functions are called to preventing too many display windows open.
The electronic micropscope control class - EMControl or EMC fills attributes with default values if not set.
Version 0.6.1 Beta¶
01-05-2023¶
Improvements¶
Bug fixes.
Display will keep the figures windows open for each display. Users are now responsible to close them.
Version 0.6.0 Beta¶
12-11-2022¶
Improvements¶
Diffraction simulation result list objects DPList and BImgList can now be sorted by its controls objects in their builtin sorting function shown in the following code snippet:
from pyemaps import DPList dpl = DPList(name) .... # more code here # sorting the images by their associated controls dpl.sort()
See sample code si_dif.py and si_bloch.py for more details on how to use the function and display them in the sorting order.
For stereodiagram results where there is no builtin result objects, users can build a python list of control and result pair and apply python style sorting on the list as follows:
slist.sort(key=lambda x: x[0])
Refer to si_stereo.py.
Enhanced Bloch simulation memory management, bloch simulation exception handling and result accuracies.
Version 0.5.0 Beta¶
11-30-2022¶
Improvements¶
Documentation impreovements.
Kinematic diffraction pattern: Kikuchi and HOLZ lines intensities data added and rendered as opacities of the lines.
More control parameters added to EMControls as optional attributes. See pyemaps.emcontrols module for more details.
Version 0.4.9 Beta¶
11-26-2022¶
Improvements¶
Bug fixes.
- Display module enhancements:
Added layout option of table format. For example, showDif(dpl, …, layout=’table’) will result in rendering of kinematic diffraction pattern dpl in a m x n table format where n is less or equal to 3.
Note
If layout input is ommitted or set to ‘individual’, the functions will render each image individually in sequence as before.
cShow option is also added to the display functions to show control parameters on the final figure if it is set to True which is also the default. Otherwise, no control parameters will be displayed.
Note
Due to space constraints, control parameters with default values will be ommitted from the final rendering, even if cShow is set to True.
Version 0.4.8 Beta¶
11-19-2022¶
Improvements¶
Crystal volume limit increased to 1200.
Dynamic diffraction simulation expanded to handle larger number of diffracted beams up to 5000.
Warning
The increase can result in much longer simulation time. In some cases with large diffracted beams numbers near the limit, it may mean 30 minutes or longer. The simulation time varies depending your system.
More build-in crystal data added because of the above expansions. Additional built-in crystals:
'BiMnO3'
'CoSb3_Skutterudite'
'Pentacene'
Version 0.4.7 Beta¶
11-14-2022¶
New¶
Reorganized dynamic diffraction simulation into sessions with:
beginBloch. Starts a Bloch wave dynamic diffraction session.
endBloch. Ends a dynamic diffraction session.
These methods enable pyemaps to retain simulation in memory while preventing repeatitive computations, making pyemaps more efficient. Dynamic simulation data can be retrieved during session include:
getBlochImages. Retrieves bloch images and/or save the images into raw image files.
getSCMatrix. Gets scattering matrix at a selected sampling point.
getEigen. Gets eigen values at a selected sampling point.
getBeams. Retrieves diagnization Miller indexes at each sampling point.
printIBDetails. Prints miscellenous data such as incidental beams and a list of sampling points etc.
Note
generateBloch is kept for backward compatibility purposes. This function is now equivalent to calling: