Codebase list xrayutilities / a2aa653
Update upstream source from tag 'upstream/1.7.1' Update to upstream version '1.7.1' with Debian dir ec67325d8b1bc23c13f48f62f79b2c90ef769ec3 Picca Frédéric-Emmanuel 3 years ago
45 changed file(s) with 141 addition(s) and 890 deletion(s). Raw diff Collapse all Expand all
0 v1.7.1, 2021-01-02
1
2 * harmonize dependency versions between README and setup.py
3 * remove PDF documentation and other generatable content from the GIT
4 repository
5 * new azure pipeline for documentation generation
6 * new azure pipeline for wheel generation (issue #111)
7
08 v1.7.0, 2020-12-08
19
210 * allow string decoding to fail in tif headers
+0
-32
CONTRIBUTING.md less more
0 Contributions and feedback of all kind are welcome! Please see below how to
1 best reach us or contribute.
2
3 Submitting an issue
4 ===================
5
6 If you have questions about the use of the package please consider contacting
7 us via the [mailing list][1]
8
9 If you find a bug or have concrete suggestions for improvements feel free to
10 open an issue on the [Github issue tracker][2].
11
12 Submitting an patch/pull request
13 ================================
14
15 Patches and pull requests can also be submitted via Github.
16
17 Styleguide
18 ----------
19
20 In order to keep the code readable we try to follow the [PEP8 Style Guide][3]
21
22 Consider checking your contribution with the [PEP8 style checker][4]
23
24 Noteable exceptions are docstrings which sometimes would get misformated when
25 PEP8 is followed strictly. For docstrings we follow the [numpydoc style][5].
26
27 [1]: https://sourceforge.net/p/xrayutilities/mailman/xrayutilities-users
28 [2]: https://github.com/dkriegner/xrayutilities/issues
29 [3]: https://www.python.org/dev/peps/pep-0008/
30 [4]: https://pypi.org/project/pycodestyle/
31 [5]: http://numpydoc.readthedocs.io
22
33 # documentation files
44 include README.md
5 include xrayutilities.pdf
65 recursive-include doc/source *
76
87 # examples
00 Metadata-Version: 2.1
11 Name: xrayutilities
2 Version: 1.7.0
2 Version: 1.7.1
33 Summary: package for x-ray diffraction data evaluation
4 Home-page: http://xrayutilities.sourceforge.net
4 Home-page: https://xrayutilities.sourceforge.io
55 Author: Eugen Wintersberger, Dominik Kriegner
66 Author-email: eugen.wintersberger@desy.de, dominik.kriegner@gmail.com
77 Maintainer: Dominik Kriegner
1010 Description: xrayutilities
1111 =============
1212
13
1314 [![Build Status](https://dev.azure.com/dominikkriegner/xrayutilities/_apis/build/status/dkriegner.xrayutilities?repoName=dkriegner%2Fxrayutilities&branchName=master)](https://dev.azure.com/dominikkriegner/xrayutilities/_build/latest?definitionId=1&repoName=dkriegner%2Fxrayutilities&branchName=master)
14
1515
1616 xrayutilities is a collection of scripts used to analyze and simulate x-ray
1717 diffraction data. It consists of a Python package and several routines coded
2222 diffraction is included.
2323
2424
25 Copyright (C) 2009-2020 Dominik Kriegner <dominik.kriegner@gmail.com>
25 Copyright (C) 2009-2021 Dominik Kriegner <dominik.kriegner@gmail.com>
2626
2727 Copyright (C) 2009-2013 Eugen Wintersberger <eugen.wintersberger@desy.de>
2828
4545 * *lib/xrayutilities*: directory with the sources for the Python package
4646 * *tests*: directory with the unittest scripts
4747 * *setup.py*: setuptools install script used for the package installation
48 * *xrayutilities.pdf*: pdf-file with documentation of the package
4948
5049
5150 Installation (pip)
110109 - sphinx (optional - only when you want to build the documentation)
111110 - numpydoc (optional - only when you want to build the documentation)
112111 - rst2pdf (optional - only when you want to build the documentation)
112 - sphinx_rtd_theme (optional - only when you want to build the documentation)
113 - svglib (optional - only when you want to build the pdf documentation)
113114
114115 refer to your operating system documentation to find out how to install
115116 those packages. On Microsoft Windows refer to the Documentation for the
171172 git pull
172173
173174 or download the new tarball from sourceforge
174 (http://sf.net/projects/xrayutilities) if any code changed during the update you
175 (https://sf.net/projects/xrayutilities) if any code changed during the update you
175176 need to reinstall the Python package. Thats easiest achieved by
176177
177178 pip install .
193194 Documentation
194195 =============
195196
196 Documentation for xrayutilities is found in the *xrayutilities.pdf* file or on the
197 webpage http://xrayutilities.sourceforge.io
197 Documentation for xrayutilities is found on the webpage
198 https://xrayutilities.sourceforge.io
198199
199200 The API-documentation can also be browsed by
200201
207208 Classifier: Programming Language :: Python :: 3.6
208209 Classifier: Programming Language :: Python :: 3.7
209210 Classifier: Programming Language :: Python :: 3.8
211 Classifier: Programming Language :: Python :: 3.9
210212 Classifier: Topic :: Scientific/Engineering :: Physics
211213 Classifier: Intended Audience :: Science/Research
212214 Classifier: Development Status :: 5 - Production/Stable
215217 Description-Content-Type: text/markdown
216218 Provides-Extra: plot
217219 Provides-Extra: fit
218 Provides-Extra: lzma
00 xrayutilities
11 =============
22
3
34 [![Build Status](https://dev.azure.com/dominikkriegner/xrayutilities/_apis/build/status/dkriegner.xrayutilities?repoName=dkriegner%2Fxrayutilities&branchName=master)](https://dev.azure.com/dominikkriegner/xrayutilities/_build/latest?definitionId=1&repoName=dkriegner%2Fxrayutilities&branchName=master)
4
55
66 xrayutilities is a collection of scripts used to analyze and simulate x-ray
77 diffraction data. It consists of a Python package and several routines coded
1212 diffraction is included.
1313
1414
15 Copyright (C) 2009-2020 Dominik Kriegner <dominik.kriegner@gmail.com>
15 Copyright (C) 2009-2021 Dominik Kriegner <dominik.kriegner@gmail.com>
1616
1717 Copyright (C) 2009-2013 Eugen Wintersberger <eugen.wintersberger@desy.de>
1818
3535 * *lib/xrayutilities*: directory with the sources for the Python package
3636 * *tests*: directory with the unittest scripts
3737 * *setup.py*: setuptools install script used for the package installation
38 * *xrayutilities.pdf*: pdf-file with documentation of the package
3938
4039
4140 Installation (pip)
10099 - sphinx (optional - only when you want to build the documentation)
101100 - numpydoc (optional - only when you want to build the documentation)
102101 - rst2pdf (optional - only when you want to build the documentation)
102 - sphinx_rtd_theme (optional - only when you want to build the documentation)
103 - svglib (optional - only when you want to build the pdf documentation)
103104
104105 refer to your operating system documentation to find out how to install
105106 those packages. On Microsoft Windows refer to the Documentation for the
161162 git pull
162163
163164 or download the new tarball from sourceforge
164 (http://sf.net/projects/xrayutilities) if any code changed during the update you
165 (https://sf.net/projects/xrayutilities) if any code changed during the update you
165166 need to reinstall the Python package. Thats easiest achieved by
166167
167168 pip install .
183184 Documentation
184185 =============
185186
186 Documentation for xrayutilities is found in the *xrayutilities.pdf* file or on the
187 webpage http://xrayutilities.sourceforge.io
187 Documentation for xrayutilities is found on the webpage
188 https://xrayutilities.sourceforge.io
188189
189190 The API-documentation can also be browsed by
190191
+0
-58
azure-pipelines.yml less more
0 name: $(BuildDefinitionName)_$(Date:yyyyMMdd)$(Rev:.rr)
1
2 resources:
3 repositories:
4 - repository: tox
5 type: github
6 endpoint: github
7 name: tox-dev/azure-pipelines-template
8 ref: master
9
10 jobs:
11 - template: run-tox-env.yml@tox
12 parameters:
13 tox_version: 'tox tox-wheel'
14 jobs:
15 py39:
16 before:
17 - task: Cache@2
18 inputs:
19 key: testdata20190812
20 path: $(System.DefaultWorkingDirectory)/tests/data
21 cacheHitVar: TESTDATA_RESTORED
22 displayName: Cache test data
23 - script: |
24 curl -s -L https://sourceforge.net/projects/xrayutilities/files/xrayutilities-testdata-20190812.tar.gz -o xu_testdata.tar.gz
25 tar xzf xu_testdata.tar.gz -C tests
26 condition: ne(variables.TESTDATA_RESTORED, 'true')
27 displayName: Download test data
28 after:
29 - publish: $(System.DefaultWorkingDirectory)/dist/
30 artifact: Python $(Agent.JobName) wheel package
31 image: [linux, windows, macOs]
32 py38:
33 image: [linux, windows, macOs]
34 after:
35 - publish: $(System.DefaultWorkingDirectory)/dist/
36 artifact: Python $(Agent.JobName) wheel package
37 py37:
38 image: [linux, windows, macOs]
39 after:
40 - publish: $(System.DefaultWorkingDirectory)/dist/
41 artifact: Python $(Agent.JobName) wheel package
42 py36:
43 image: [linux, windows, macOs]
44 after:
45 - publish: $(System.DefaultWorkingDirectory)/dist/
46 artifact: Python $(Agent.JobName) wheel package
47 coverage:
48 with_toxenv: 'coverage'
49 for_envs: [py36, py37, py38, py39]
50
51 schedules:
52 - cron: "0 12 * * 0"
53 displayName: Weekly build
54 branches:
55 include:
56 - master
57 always: true
+0
-59
doc/README_sf.rst less more
0
1 xrayutilities
2 =============
3
4 **a package with useful scripts for X-ray diffraction**
5
6
7 Copyright (C) 2009-2020 Dominik Kriegner <dominik.kriegner@gmail.com>
8
9 Copyright (C) 2009-2013 Eugen Wintersberger <eugen.wintersberger@desy.de>
10
11
12 Obtaining the source code
13 =========================
14
15 The sources are hosted on
16 `github.com
17 <https://github.com/dkriegner/xrayutilities>`_ in are made available
18 as tarballs from time to time on
19 `github
20 <https://github.com/dkriegner/xrayutilities/releases>`_ and
21 `sourceforge.net
22 <https://sourceforge.net/projects/xrayutilities/files/>`_
23
24 Download the latest tarball or use:
25
26 git clone https://github.com/dkriegner/xrayutilities.git
27
28
29 to clone the git repository. If you would like to have commit rights
30 contact one of the administrators.
31
32
33 Installation
34 ============
35
36 Installing xrayutilities is a two step process. A few notes on how to install
37 on the various can be found in the README shipped with the package's sources.
38
39 1. installing required third party software
40 requirements are:
41
42 - C-compiler
43 - h5py (for HDF5 file access)
44 - scipy
45 - numpy
46 - matplotlib (optionally)
47
48 refer to your operating system documentation to find out how to install
49 those packages. On Windows we suggest to use Python(x,y)
50
51 2. install *xrayutilities* using
52
53 pip install .
54
55
56 For details of how to setup your Python installation to find xrayutilities
57 after the installation please refer to the documention.
58
3232 # coming with Sphinx (named 'sphinx.ext.*') or your custom ones.
3333 extensions = [
3434 'sphinx.ext.autodoc',
35 'sphinx.ext.autosummary',
3635 'sphinx.ext.coverage',
3736 'sphinx.ext.mathjax',
3837 'sphinx.ext.viewcode',
5352
5453 # General information about the project.
5554 project = 'xrayutilities'
56 copyright = '2020, Dominik Kriegner, Eugen Wintersberger'
55 copyright = '2021, Dominik Kriegner, Eugen Wintersberger'
5756
5857 # The version info for the project you're documenting, acts as replacement for
5958 # |version| and |release|, also used in various other places throughout the
6160 #
6261 moduleroot = os.path.join('..', '..', 'lib', 'xrayutilities')
6362 with open(os.path.join(moduleroot, 'VERSION')) as version_file:
64 fullversion = version_file.read().strip()
63 fullversion = version_file.read().strip().replace('\n', '.')
6564 # The short X.Y version.
6665 version = re.match(r'^(\d+\.)?(\d+)?', fullversion).group()
6766 # The full version, including alpha/beta/rc tags.
366365 # pdf_fit_background_mode = 'scale'
367366
368367
369 # my additions for pre-processing the docstring
370368 def process_docstring(app, what, name, obj, options, lines):
369 """my additions for pre-processing the docstring"""
371370 # insert note block
372371 for i in range(len(lines)):
373372 lines[i] = re.sub(r'^\s*Note:', r'.. note::', lines[i])
374373
374 def skip(app, what, name, obj, would_skip, options):
375 """always document __init__ and __call__ functions"""
376 if name in ["__init__", "__call__"]:
377 return False
378 return would_skip
375379
376380 def setup(app):
377381 app.connect('autodoc-process-docstring', process_docstring)
382 app.connect("autodoc-skip-member", skip)
55 Examples
66 ========
77
8 In the following a few code-snippets are shown which should help you getting started with *xrayutilities*. Not all of the codes shown in the following will be run-able as stand-alone script. For fully running scripts look in the `examples <https://github.com/dkriegner/xrayutilities/tree/master/examples>`_ directory in the download found `here <https://sourceforge.net/projects/xrayutilities>`_.
8 In the following a few code-snippets are shown which should help you getting started with *xrayutilities*. Not all of the codes shown in the following will be run-able as stand-alone script. For fully running scripts look in the `examples <https://github.com/dkriegner/xrayutilities/tree/master/examples>`_ or in the `download <https://sourceforge.net/projects/xrayutilities>`_.
99
1010
1111 Reading data from data files
575575 # levels can be changed in the config file as well
576576 verbosity = 1
577577
578 # default wavelength in Angstrom,
578 # default wavelength in angstrom,
579579 wavelength = MoKa1 # Molybdenum K alpha1 radiation (17479.374eV)
580580
581581 # default energy in eV
664664
665665 * sample tilt angle in degree
666666 * sample tilt azimuth in degree
667 * and the x-ray wavelength in Angstrom
667 * and the x-ray wavelength in angstrom
668668
669669 .. literalinclude:: example_xu_ccd_parameter_hkl.py
670670 :linenos:
193193 * **sphinx** the Python documentation generator
194194 * **numpydoc** sphinx-extension needed to parse the API-documention
195195 * **rst2pdf** pdf-generation using sphinx
196 * **sphinx_rtd_theme** sphinx theme used
197 * **svglib** library needed by rst2pdf to include svg images into the pdf documentation
196198
197199 After installing all required packages you can continue with installing and
198200 building the C library.
+0
-7
doc/source/modules.rst less more
0 xrayutilities
1 =============
2
3 .. toctree::
4 :maxdepth: 4
5
6 xrayutilities
55 Simulation examples
66 ===================
77
8 In the following a few code-snippets are shown which should help you getting started with reflectivity and diffraction simulations using *xrayutilities*. All simulations in *xrayutilities* are for layers systems and currently there are no plans to extend this to other geometries. Note that not all of the codes shown in the following will be run-able as stand-alone scripts. For fully running scripts look in the `examples <https://github.com/dkriegner/xrayutilities/tree/master/examples>`_ directory in the download found `here <https://sourceforge.net/projects/xrayutilities>`_.
8 In the following a few code-snippets are shown which should help you getting started with reflectivity and diffraction simulations using *xrayutilities*. All simulations in *xrayutilities* are for layers systems and currently there are no plans to extend this to other geometries. Note that not all of the codes shown in the following will be run-able as stand-alone scripts. For fully running scripts look in the `examples <https://github.com/dkriegner/xrayutilities/tree/master/examples>`_ directory in the `download <https://sourceforge.net/projects/xrayutilities>`_.
99
1010 Building Layer stacks for simulations
1111 -------------------------------------
357357
358358 Powder diffraction patterns can be calculated using :class:`~xrayutilities.simpack.powdermodel.PowderModel`. A specialized class for the definition of powdered materials named :class:`~xrayutilities.simpack.smaterials.Powder` exists. The class constructor takes the materials volume and several material parameters specific for the powder material. Among them are `crystallite_size_gauss` and `strain_gauss` which can be used to include the effect of finite crystallite size and microstrain. Texture modelled by the March-Dollase pole density offers the `preferred_orientation` direction parameter as well as a `preferred_orientation_factor` variable.
359359
360 The :class:`~xrayutilities.simpack.powdermodel.PowderModel` internally uses :class:`~xrayutilities.simpack.powder.PowderDiffraction` for its calculations which is based on the fundamental parameters approach as implemented and documented `here <http://dx.doi.org/10.6028/jres.120.014.c>`_ and `here <http://dx.doi.org/10.6028/jres.120.014>`_.
360 The :class:`~xrayutilities.simpack.powdermodel.PowderModel` internally uses :class:`~xrayutilities.simpack.powder.PowderDiffraction` for its calculations which is based on the fundamental parameters approach. The fundamental parameters approach code used here can was originally implemented and documented here: `http://dx.doi.org/10.6028/jres. 120.014.c <http://dx.doi.org/10.6028/jres.120.014.c>`_ and `http://dx.doi.org/10.6028/jres.120.014 <http://dx.doi.org/10.6028/jres.120.014>`_.
361361
362362 Several setup specific parameters should be adjusted by a user-specific configuration file or by supplying the appropriate parameters using the `fpsettings` argument of :class:`~xrayutilities.simpack.powdermodel.PowderModel`.
363363
+0
-37
doc/source/xrayutilities.analysis.rst less more
0 xrayutilities.analysis package
1 ==============================
2
3 Submodules
4 ----------
5
6 xrayutilities.analysis.line\_cuts module
7 ----------------------------------------
8
9 .. automodule:: xrayutilities.analysis.line_cuts
10 :members:
11 :undoc-members:
12 :show-inheritance:
13
14 xrayutilities.analysis.misc module
15 ----------------------------------
16
17 .. automodule:: xrayutilities.analysis.misc
18 :members:
19 :undoc-members:
20 :show-inheritance:
21
22 xrayutilities.analysis.sample\_align module
23 -------------------------------------------
24
25 .. automodule:: xrayutilities.analysis.sample_align
26 :members:
27 :undoc-members:
28 :show-inheritance:
29
30 Module contents
31 ---------------
32
33 .. automodule:: xrayutilities.analysis
34 :members:
35 :undoc-members:
36 :show-inheritance:
+0
-133
doc/source/xrayutilities.io.rst less more
0 xrayutilities.io package
1 ========================
2
3 Submodules
4 ----------
5
6 xrayutilities.io.cbf module
7 ---------------------------
8
9 .. automodule:: xrayutilities.io.cbf
10 :members:
11 :undoc-members:
12 :show-inheritance:
13
14 xrayutilities.io.desy\_tty08 module
15 -----------------------------------
16
17 .. automodule:: xrayutilities.io.desy_tty08
18 :members:
19 :undoc-members:
20 :show-inheritance:
21
22 xrayutilities.io.edf module
23 ---------------------------
24
25 .. automodule:: xrayutilities.io.edf
26 :members:
27 :undoc-members:
28 :show-inheritance:
29
30 xrayutilities.io.fastscan module
31 --------------------------------
32
33 .. automodule:: xrayutilities.io.fastscan
34 :members:
35 :undoc-members:
36 :show-inheritance:
37
38 xrayutilities.io.filedir module
39 -------------------------------
40
41 .. automodule:: xrayutilities.io.filedir
42 :members:
43 :undoc-members:
44 :show-inheritance:
45
46 xrayutilities.io.helper module
47 ------------------------------
48
49 .. automodule:: xrayutilities.io.helper
50 :members:
51 :undoc-members:
52 :show-inheritance:
53
54 xrayutilities.io.ill\_numor module
55 ----------------------------------
56
57 .. automodule:: xrayutilities.io.ill_numor
58 :members:
59 :undoc-members:
60 :show-inheritance:
61
62 xrayutilities.io.imagereader module
63 -----------------------------------
64
65 .. automodule:: xrayutilities.io.imagereader
66 :members:
67 :undoc-members:
68 :show-inheritance:
69
70 xrayutilities.io.panalytical\_xml module
71 ----------------------------------------
72
73 .. automodule:: xrayutilities.io.panalytical_xml
74 :members:
75 :undoc-members:
76 :show-inheritance:
77
78 xrayutilities.io.pdcif module
79 -----------------------------
80
81 .. automodule:: xrayutilities.io.pdcif
82 :members:
83 :undoc-members:
84 :show-inheritance:
85
86 xrayutilities.io.rigaku\_ras module
87 -----------------------------------
88
89 .. automodule:: xrayutilities.io.rigaku_ras
90 :members:
91 :undoc-members:
92 :show-inheritance:
93
94 xrayutilities.io.rotanode\_alignment module
95 -------------------------------------------
96
97 .. automodule:: xrayutilities.io.rotanode_alignment
98 :members:
99 :undoc-members:
100 :show-inheritance:
101
102 xrayutilities.io.seifert module
103 -------------------------------
104
105 .. automodule:: xrayutilities.io.seifert
106 :members:
107 :undoc-members:
108 :show-inheritance:
109
110 xrayutilities.io.spec module
111 ----------------------------
112
113 .. automodule:: xrayutilities.io.spec
114 :members:
115 :undoc-members:
116 :show-inheritance:
117
118 xrayutilities.io.spectra module
119 -------------------------------
120
121 .. automodule:: xrayutilities.io.spectra
122 :members:
123 :undoc-members:
124 :show-inheritance:
125
126 Module contents
127 ---------------
128
129 .. automodule:: xrayutilities.io
130 :members:
131 :undoc-members:
132 :show-inheritance:
+0
-93
doc/source/xrayutilities.materials.rst less more
0 xrayutilities.materials package
1 ===============================
2
3 Submodules
4 ----------
5
6 xrayutilities.materials.atom module
7 -----------------------------------
8
9 .. automodule:: xrayutilities.materials.atom
10 :members:
11 :undoc-members:
12 :show-inheritance:
13
14 xrayutilities.materials.cif module
15 ----------------------------------
16
17 .. automodule:: xrayutilities.materials.cif
18 :members:
19 :undoc-members:
20 :show-inheritance:
21
22 xrayutilities.materials.database module
23 ---------------------------------------
24
25 .. automodule:: xrayutilities.materials.database
26 :members:
27 :undoc-members:
28 :show-inheritance:
29
30 xrayutilities.materials.elements module
31 ---------------------------------------
32
33 .. automodule:: xrayutilities.materials.elements
34 :members:
35 :undoc-members:
36 :show-inheritance:
37
38 xrayutilities.materials.heuslerlib module
39 -----------------------------------------
40
41 .. automodule:: xrayutilities.materials.heuslerlib
42 :members:
43 :undoc-members:
44 :show-inheritance:
45
46 xrayutilities.materials.material module
47 ---------------------------------------
48
49 .. automodule:: xrayutilities.materials.material
50 :members:
51 :undoc-members:
52 :show-inheritance:
53
54 xrayutilities.materials.plot module
55 -----------------------------------
56
57 .. automodule:: xrayutilities.materials.plot
58 :members:
59 :undoc-members:
60 :show-inheritance:
61
62 xrayutilities.materials.predefined\_materials module
63 ----------------------------------------------------
64
65 .. automodule:: xrayutilities.materials.predefined_materials
66 :members:
67 :undoc-members:
68 :show-inheritance:
69
70 xrayutilities.materials.spacegrouplattice module
71 ------------------------------------------------
72
73 .. automodule:: xrayutilities.materials.spacegrouplattice
74 :members:
75 :undoc-members:
76 :show-inheritance:
77
78 xrayutilities.materials.wyckpos module
79 --------------------------------------
80
81 .. automodule:: xrayutilities.materials.wyckpos
82 :members:
83 :undoc-members:
84 :show-inheritance:
85
86 Module contents
87 ---------------
88
89 .. automodule:: xrayutilities.materials
90 :members:
91 :undoc-members:
92 :show-inheritance:
+0
-61
doc/source/xrayutilities.math.rst less more
0 xrayutilities.math package
1 ==========================
2
3 Submodules
4 ----------
5
6 xrayutilities.math.algebra module
7 ---------------------------------
8
9 .. automodule:: xrayutilities.math.algebra
10 :members:
11 :undoc-members:
12 :show-inheritance:
13
14 xrayutilities.math.fit module
15 -----------------------------
16
17 .. automodule:: xrayutilities.math.fit
18 :members:
19 :undoc-members:
20 :show-inheritance:
21
22 xrayutilities.math.functions module
23 -----------------------------------
24
25 .. automodule:: xrayutilities.math.functions
26 :members:
27 :undoc-members:
28 :show-inheritance:
29
30 xrayutilities.math.misc module
31 ------------------------------
32
33 .. automodule:: xrayutilities.math.misc
34 :members:
35 :undoc-members:
36 :show-inheritance:
37
38 xrayutilities.math.transforms module
39 ------------------------------------
40
41 .. automodule:: xrayutilities.math.transforms
42 :members:
43 :undoc-members:
44 :show-inheritance:
45
46 xrayutilities.math.vector module
47 --------------------------------
48
49 .. automodule:: xrayutilities.math.vector
50 :members:
51 :undoc-members:
52 :show-inheritance:
53
54 Module contents
55 ---------------
56
57 .. automodule:: xrayutilities.math
58 :members:
59 :undoc-members:
60 :show-inheritance:
+0
-113
doc/source/xrayutilities.rst less more
0 xrayutilities package
1 =====================
2
3 Subpackages
4 -----------
5
6 .. toctree::
7 :maxdepth: 4
8
9 xrayutilities.analysis
10 xrayutilities.io
11 xrayutilities.materials
12 xrayutilities.math
13 xrayutilities.simpack
14
15 Submodules
16 ----------
17
18 xrayutilities.config module
19 ---------------------------
20
21 .. automodule:: xrayutilities.config
22 :members:
23 :undoc-members:
24 :show-inheritance:
25
26 xrayutilities.exception module
27 ------------------------------
28
29 .. automodule:: xrayutilities.exception
30 :members:
31 :undoc-members:
32 :show-inheritance:
33
34 xrayutilities.experiment module
35 -------------------------------
36
37 .. automodule:: xrayutilities.experiment
38 :members:
39 :undoc-members:
40 :show-inheritance:
41
42 xrayutilities.gridder module
43 ----------------------------
44
45 .. automodule:: xrayutilities.gridder
46 :members:
47 :undoc-members:
48 :show-inheritance:
49
50 xrayutilities.gridder2d module
51 ------------------------------
52
53 .. automodule:: xrayutilities.gridder2d
54 :members:
55 :undoc-members:
56 :show-inheritance:
57
58 xrayutilities.gridder3d module
59 ------------------------------
60
61 .. automodule:: xrayutilities.gridder3d
62 :members:
63 :undoc-members:
64 :show-inheritance:
65
66 xrayutilities.mpl\_helper module
67 --------------------------------
68
69 .. automodule:: xrayutilities.mpl_helper
70 :members:
71 :undoc-members:
72 :show-inheritance:
73
74 xrayutilities.normalize module
75 ------------------------------
76
77 .. automodule:: xrayutilities.normalize
78 :members:
79 :undoc-members:
80 :show-inheritance:
81
82 xrayutilities.q2ang\_fit module
83 -------------------------------
84
85 .. automodule:: xrayutilities.q2ang_fit
86 :members:
87 :undoc-members:
88 :show-inheritance:
89
90 xrayutilities.utilities module
91 ------------------------------
92
93 .. automodule:: xrayutilities.utilities
94 :members:
95 :undoc-members:
96 :show-inheritance:
97
98 xrayutilities.utilities\_noconf module
99 --------------------------------------
100
101 .. automodule:: xrayutilities.utilities_noconf
102 :members:
103 :undoc-members:
104 :show-inheritance:
105
106 Module contents
107 ---------------
108
109 .. automodule:: xrayutilities
110 :members:
111 :undoc-members:
112 :show-inheritance:
+0
-77
doc/source/xrayutilities.simpack.rst less more
0 xrayutilities.simpack package
1 =============================
2
3 Submodules
4 ----------
5
6 xrayutilities.simpack.darwin\_theory module
7 -------------------------------------------
8
9 .. automodule:: xrayutilities.simpack.darwin_theory
10 :members:
11 :undoc-members:
12 :show-inheritance:
13
14 xrayutilities.simpack.fit module
15 --------------------------------
16
17 .. automodule:: xrayutilities.simpack.fit
18 :members:
19 :undoc-members:
20 :show-inheritance:
21
22 xrayutilities.simpack.helpers module
23 ------------------------------------
24
25 .. automodule:: xrayutilities.simpack.helpers
26 :members:
27 :undoc-members:
28 :show-inheritance:
29
30 xrayutilities.simpack.models module
31 -----------------------------------
32
33 .. automodule:: xrayutilities.simpack.models
34 :members:
35 :undoc-members:
36 :show-inheritance:
37
38 xrayutilities.simpack.mosaicity module
39 --------------------------------------
40
41 .. automodule:: xrayutilities.simpack.mosaicity
42 :members:
43 :undoc-members:
44 :show-inheritance:
45
46 xrayutilities.simpack.powder module
47 -----------------------------------
48
49 .. automodule:: xrayutilities.simpack.powder
50 :members:
51 :undoc-members:
52 :show-inheritance:
53
54 xrayutilities.simpack.powdermodel module
55 ----------------------------------------
56
57 .. automodule:: xrayutilities.simpack.powdermodel
58 :members:
59 :undoc-members:
60 :show-inheritance:
61
62 xrayutilities.simpack.smaterials module
63 ---------------------------------------
64
65 .. automodule:: xrayutilities.simpack.smaterials
66 :members:
67 :undoc-members:
68 :show-inheritance:
69
70 Module contents
71 ---------------
72
73 .. automodule:: xrayutilities.simpack
74 :members:
75 :undoc-members:
76 :show-inheritance:
+0
-32
doc/webpage.patch less more
0 --- build/sphinx/html/index.html.orig 2019-10-09 09:52:01.373904470 +0200
1 +++ build/sphinx/html/index.html 2019-10-09 09:52:53.711409533 +0200
2 @@ -57,7 +57,7 @@
3
4
5
6 - <img src="_static/xray-logo.png" class="logo" alt="Logo"/>
7 + <img src="_static/xray-logo.png" class="logo" alt="Logo" style="width: 100%; max-width:265px;"/>
8
9 </a>
10
11 @@ -165,6 +165,13 @@
12
13 <div class="section" id="welcome-to-xrayutilities-s-documentation">
14 <h1>Welcome to xrayutilities’s documentation!<a class="headerlink" href="#welcome-to-xrayutilities-s-documentation" title="Permalink to this headline">¶</a></h1>
15 +<a class="reference external image-reference" href="https://pypi.python.org/pypi/xrayutilities/"><img alt="Latest Version" style="max-height: 25px; max-width:114px;" src="https://img.shields.io/pypi/v/xrayutilities.svg"/></a>
16 +<a class="reference external image-reference" href="https://github.com/dkriegner/xrayutilities"><img alt="Git-repo on github" style="max-height: 25px; max-width:144px;" src="https://img.shields.io/badge/development-GIT-green.svg"/></a>
17 +<a class="reference external image-reference" href="https://pypi.python.org/pypi/xrayutilities/"><img alt="Supported Python versions" style="max-height: 25px; max-width:193px;" src="https://img.shields.io/pypi/pyversions/xrayutilities.svg" /></a>
18 +<a class="reference external image-reference" href="https://pypi.python.org/pypi/xrayutilities/"><img alt="Development Status" style="max-height: 25px; max-width:114px;" src="https://img.shields.io/pypi/status/xrayutilities.svg" /></a>
19 +<a class="reference external image-reference" href="https://pypi.python.org/pypi/xrayutilities/"><img alt="License" style="max-height: 25px; max-width:119px;" src="https://img.shields.io/pypi/l/xrayutilities.svg" /></a>
20 +<a class="reference external image-reference" href="https://dev.azure.com/dominikkriegner/xrayutilities/_build?definitionId=1"><img alt="Test status" style="max-height: 25px" src="https://dev.azure.com/dominikkriegner/xrayutilities/_apis/build/status/dkriegner.xrayutilities?repoName=dkriegner%2Fxrayutilities&branchName=master" /></a>
21 +
22 <p>If you look for downloading the package go to <a class="reference external" href="https://sourceforge.net/projects/xrayutilities">Sourceforge</a> or <a class="reference external" href="https://github.com/dkriegner/xrayutilities">GitHub</a> (source distribution) or the <a class="reference external" href="https://pypi.python.org/pypi/xrayutilities">Python package index</a> (MS Windows binary).</p>
23 <p>Read more about <em>xrayutilities</em> below or in <a class="reference external" href="http://dx.doi.org/10.1107/S0021889813017214">Journal of Applied Crystallography 2013, Volume 46, 1162-1170</a></p>
24 </div>
25 @@ -724,4 +732,4 @@
26
27
28 </body>
29 -</html>
30 \ No newline at end of file
31 +</html>
3939 m = xu.simpack.SpecularReflectivityModel(ls)
4040 pos, eldens = m.densityprofile(500)
4141
42 # slice the layerstack into an Amorphous sublayer at every 0.1 Angstrom.
42 # slice the layerstack into an Amorphous sublayer at every 0.1 angstrom.
4343 # at the top a vacuum layer is added
4444 sls = xu.simpack.effectiveDensitySlicing(ls, 0.1)
4545 ms = xu.simpack.SpecularReflectivityModel(sls)
2626 """dummy main function to enable multiprocessing on windows"""
2727 cryst_size = 40e-9 # meter
2828
29 # create Fe BCC (space group nr. 229 Im3m) with a=2.87Angstrom although
29 # create Fe BCC (space group nr. 229 Im3m) with a = 2.87 angstrom although
3030 # this is already predefined as xu.materials.Fe we will repeat here for
3131 # educational purposes
3232 FeBCC = xu.materials.Crystal(
3838
3939 for energy in [8041]: # eV
4040
41 lam = xu.en2lam(energy) # e in eV -> lam in Angstroem
41 lam = xu.en2lam(energy) # e in eV -> lam in angstrom
4242 print(' %d eV = %8.4f A' % (energy, lam))
4343 print('------------------------------------------------------------------'
4444 '-----------------')
+0
-30
examples/xrayutilities_user.conf less more
0 # XRAYUTILITIES user configuration
1 # default values for some properties of xrayutilities may be set
2 # the syntax follows the one of the ConfigParser Python module,
3 # which is similar to .ini files
4
5 # if you want to use this user-specific config file you need to place it in
6 # ~/.xrayutilities.conf
7 # or the local directory
8 # ./xrayutilities.conf
9
10 # The config file with the default parameters is found in the Python installation
11 # path of xrayutilities. It is however not recommended to change things there,
12 # instead the user-specific config file
13
14 # begin of xrayutilities configuration
15 [xrayutilities]
16
17 # verbosity level of information and debugging outputs
18 # 0: no output
19 # 1: very import notes for users
20 # 2: less import notes for users (e.g. intermediate results)
21 # 3: debuging output (e.g. print everything, which could be interesing)
22 verbosity=1
23
24 # default wavelength in Angstrom,
25 # wavelength=1.5406
26
27 # default energy in eV
28 # if energy is given wavelength settings will be ignored
29 # energy=8048
4242
4343 # load package version
4444 with open(os.path.join(__path__[0], 'VERSION')) as version_file:
45 __version__ = version_file.read().strip()
45 __version__ = version_file.read().strip().replace('\n', '.')
490490 matplotlib figure used for plotting the error default: None (creates
491491 own figure)
492492 wl : float or str
493 wavelength of the experiment in Angstrom (default: config.WAVELENGTH)
493 wavelength of the experiment in angstrom (default: config.WAVELENGTH)
494494 value does not really matter here but does affect the scaling of the
495495 error
496496 plotlog : bool
873873 flag to tell if to return fit object with final parameters and detector
874874 directions
875875 wl : float or str
876 wavelength of the experiment in Angstrom (default: 1)
876 wavelength of the experiment in angstrom (default: 1)
877877 value does not really matter here but does affect the scaling of the
878878 error
879879 debug : bool
938938 delta must be an numpy array or list of len(*dAngles) used angles
939939 are than *args - delta
940940 wl : float or str, optional
941 x-ray wavelength in angstroem (default: 1 (since it does not matter
941 x-ray wavelength in angstrom (default: 1 (since it does not matter
942942 here))
943943 deg : bool, optional
944944 flag to tell if angles are passed as degree (default: True)
11081108 detector circles e.g. ['z+', 'y-'] would mean a detector arm with a
11091109 two rotations
11101110 wl : float or str
1111 wavelength of the experiment in Angstroem
1111 wavelength of the experiment in angstrom
11121112
11131113 Returns
11141114 -------
16541654 UB : array-like, optional
16551655 orientation matrix of the sample
16561656 wl : float or str, optional
1657 x-ray wavelength in angstroem
1657 x-ray wavelength in angstrom
16581658 deg : bool, optional
16591659 flag to tell if angles are passed as degree (default: True)
16601660
100100 kwargs : dict, optional
101101 optional keyword arguments
102102 wl : float or str, optional
103 wavelength of the x-rays in Angstroem
103 wavelength of the x-rays in angstrom
104104 en : float or str, optional
105105 energy of the x-rays in electronvolt
106106 UB : array-like, optional
474474 matrix for conversion from (hkl) coordinates to Q of sample used to
475475 determine not Q but (hkl) (default: self.UB)
476476 wl : float or str, optional
477 x-ray wavelength in angstroem (default: self._wl)
477 x-ray wavelength in angstrom (default: self._wl)
478478 en : float, optional
479479 x-ray energy in eV (default is converted self._wl). both wavelength
480480 and energy can also be an array which enables the QConversion for
554554 matrix for conversion from (hkl) coordinates to Q of sample used to
555555 determine not Q but (hkl) (default: self.UB)
556556 wl : float or str, optional
557 x-ray wavelength in angstroem (default: self._wl)
557 x-ray wavelength in angstrom (default: self._wl)
558558 en : float, optional
559559 x-ray energy in eV (default is converted self._wl). both wavelength
560560 and energy can also be an array which enables the QConversion for
758758 region of interest for the detector pixels; e.g. [100, 900]
759759 (default: self._linear_roi)
760760 wl : float or str, optional
761 x-ray wavelength in angstroem (default: self._wl)
761 x-ray wavelength in angstrom (default: self._wl)
762762 en : float, optional
763763 x-ray energy in eV (default is converted self._wl). both wavelength
764764 and energy can also be an array which enables the QConversion for
10081008 region of interest for the detector pixels; e.g.
10091009 [100, 900, 200, 800] (default: self._area_roi)
10101010 wl : float or str, optional
1011 x-ray wavelength in angstroem (default: self._wl)
1011 x-ray wavelength in angstrom (default: self._wl)
10121012 en : float, optional
10131013 x-ray energy in eV (default is converted self._wl). both wavelength
10141014 and energy can also be an array which enables the QConversion for
13341334 inplane reference direction (ipdir points into the primary beam
13351335 direction at zero angles)
13361336 ndir : list or tuple or array-like
1337 surface normal of your sample (ndir points in a direction
1338 perpendicular to the primary beam and the innermost detector
1339 rotation axis)
1337 surface normal of your sample. ndir points in a direction
1338 perpendicular to the primary beam, how it is orientated in real
1339 space is determined by the parameter sampleor (see below).
13401340
13411341 keyargs : dict, optional
13421342 optional keyword arguments
13431343 qconv : QConversion, optional
13441344 QConversion object to use for the Ang2Q conversion
13451345 sampleor : {'det', 'sam', '[xyz][+-]'}, optional
1346 sample orientation specifies the orientation of the sample surface
1347 with respect to the coordinate system in which the goniometer
1348 rotations are given. You can use the [xyz][+-] syntax to specify
1349 the nominal surface orientation (when all goniometer angles are
1350 zero). In addition two special values 'det' and 'sam' are
1351 available, which will let the code determine the orientation from
1352 either the inner most detector or sample rotation. Default is
1353 'det'.
1346 determines the sample surface orientation with respect to the
1347 coordinate system in which the goniometer rotations are given. You
1348 can use the [xyz][+-] syntax to specify the nominal surface
1349 orientation (when all goniometer angles are zero). In addition two
1350 special values 'det' and 'sam' are available, which will let the
1351 code determine the orientation from either the inner most detector
1352 or sample rotation. 'det' means the surface is in the plane spanned
1353 by the inner most detector rotation (rotation around primary beam
1354 is ignored) and perpendicular to the primary beam. 'sam' means the
1355 surface orientation is along the innermost sample circles rotation
1356 direction (in this case this should be the azimuth motor to yield
1357 the expected results). Default is 'det'.
1358 Restrictions: the given direction can not be along the primary
1359 beam. If one needs that case, let the maintainer know. Currently
1360 this case is caught and a different axis is automatically used as
1361 z-axis.
13541362 wl : float or str
1355 wavelength of the x-rays in Angstroem (default: 1.5406A)
1363 wavelength of the x-rays in angstrom (default: 1.5406A)
13561364 en : float or str
13571365 energy of the x-rays in eV (default: 8048eV == 1.5406A ).
13581366 the en keyword overrules the wl keyword
14211429 self.ndir[1],
14221430 self.ndir[2])
14231431 ostr += "energy: %f (eV)\n" % self._en
1424 ostr += "wavelength: %f (Anstrom)\n" % (self._wl)
1432 ostr += "wavelength: %f (angstrom)\n" % (self._wl)
14251433 ostr += self._A2QConversion.__str__()
14261434
14271435 return ostr
15621570 delta must be an numpy array or list of length 2. used angles are
15631571 than ``(om, tt) - delta``
15641572 wl : float or str, optional
1565 x-ray wavelength in angstroem (default: self._wl)
1573 x-ray wavelength in angstrom (default: self._wl)
15661574 en : float or str, optional
15671575 x-ray energy in eV (default: converted self._wl)
15681576 deg : bool, optional
17521760 matrix for conversion from (hkl) coordinates to Q of sample used to
17531761 determine not Q but (hkl) (default: identity matrix)
17541762 wl : float or str, optional
1755 x-ray wavelength in angstroem (default: self._wl)
1763 x-ray wavelength in angstrom (default: self._wl)
17561764 deg : bool, optional
17571765 flag to tell if angles are passed as degree (default: True)
17581766
21042112 matrix for conversion from (hkl) coordinates to Q of sample used to
21052113 determine not Q but (hkl) (default: identity matrix)
21062114 wl : float or str, optional
2107 x-ray wavelength in angstroem (default: self._wl)
2115 x-ray wavelength in angstrom (default: self._wl)
21082116 deg : bool, optional
21092117 flag to tell if angles are passed as degree (default: True)
21102118
23482356 matrix for conversion from (hkl) coordinates to Q of sample used to
23492357 determine not Q but (hkl) (default: identity matrix)
23502358 wl : float or str, optional
2351 x-ray wavelength in angstroem (default: self._wl)
2359 x-ray wavelength in angstrom (default: self._wl)
23522360 deg : bool, optional
23532361 flag to tell if angles are passed as degree (default: True)
23542362
24212429 matrix for conversion from (hkl) coordinates to Q of sample used to
24222430 determine not Q but (hkl) (default: identity matrix)
24232431 wl : float or str, optional
2424 x-ray wavelength in angstroem (default: self._wl)
2432 x-ray wavelength in angstrom (default: self._wl)
24252433 deg : bool, optional
24262434 flag to tell if angles are passed as degree (default: True)
24272435
158158 Parameters
159159 ----------
160160 radius: float
161 atomic radius in Angstrom
161 atomic radius in angstrom
162162 """
163163 if not isinstance(radius, (float, int)):
164164 raise TypeError("radius parameter must be a number!")
4848 X, Y, Z : str or Element
4949 elements
5050 a : float
51 cubic lattice parameter in Angstroem
51 cubic lattice parameter in angstrom
5252 biso : list of floats, optional
5353 Debye Waller factors for X, Y, Z elements
5454 occ : list of floats, optional
7676 X, Y, Z : str or Element
7777 elements
7878 a : float
79 cubic lattice parameter in Angstroem
79 cubic lattice parameter in angstrom
8080 b2dis : float
8181 amount of B2-type disorder (0: fully ordered, 1: fully disordered)
8282 biso : list of floats, optional
111111 X, Y, Z : str or Element
112112 elements
113113 a : float
114 cubic lattice parameter in Angstroem
114 cubic lattice parameter in angstrom
115115 a2dis : float
116116 amount of A2-type disorder (0: fully ordered, 1: fully disordered)
117117 biso : list of floats, optional
151151 X, Y, Z : str or Element
152152 elements
153153 a : float
154 cubic lattice parameter in Angstroem
154 cubic lattice parameter in angstrom
155155 do3disxy : float
156156 amount of DO_3-type disorder between X and Y atoms (0: fully ordered,
157157 1: fully disordered)
195195 X, Y, Z : str or Element
196196 elements
197197 a : float
198 cubic lattice parameter in Angstroem
198 cubic lattice parameter in angstrom
199199
200200 Returns
201201 -------
221221 X, Y, Z : str or Element
222222 elements
223223 a, c : float
224 tetragonal lattice parameters in Angstroem
224 tetragonal lattice parameters in angstrom
225225
226226 Returns
227227 -------
246246 X, Y, Z : str or Element
247247 elements
248248 a, c : float
249 tetragonal lattice parameters in Angstroem
249 tetragonal lattice parameters in angstrom
250250
251251 Returns
252252 -------
272272 X, Y, Z : str or Element
273273 elements
274274 a, c : float
275 hexagonal lattice parameters in Angstroem
275 hexagonal lattice parameters in angstrom
276276
277277 Returns
278278 -------
505505
506506 Parameters
507507 ----------
508 D : array-like
508 D : array-like
509509 transformation matrix (3x3)
510 t : array-like
510 t : array-like
511511 translation vector (3)
512 m : float, optional
513 +1 (default) or -1 to indicate time reversal in magnetic groups
512 m : int, optional
513 indicates time reversal in magnetic groups. +1 (default, no time
514 reveral) or -1
514515 """
515516 self._W = numpy.zeros((4, 4))
516517 self._W[:3, :3] = numpy.asarray(D)
14061406 Hurst factor defining the fractal dimension of the roughness (0..1,
14071407 very slow for H != 1 or H != 0.5), default: 1
14081408 vert_correl : float, optional
1409 vertical correlation length in (Angstrom), 0 means full replication
1409 vertical correlation length in angstrom, 0 means full replication
14101410 vert_nu : float, optional
14111411 exponent in the vertical correlation function
14121412 method : int, optional
15321532 Parameters
15331533 ----------
15341534 lam : float
1535 x-ray wavelength in Angstrom
1535 x-ray wavelength in angstrom
15361536 delta : list or array-like
15371537 vector with the 1-n values (N+1 components, 1st component..layer at
15381538 the free surface, last component..substrate)
19621962 Parameters
19631963 ----------
19641964 layerstack : initial LayerStack, can contain only Amorhous layers!
1965 step : thickness (in Angstrom) of the slices in the returned
1965 step : thickness (in angstrom) of the slices in the returned
19661966 LayerStack
1967 roughness : roughness of the created sublayers (in Angstrom)
1967 roughness : roughness of the created sublayers (in angstrom)
19681968 cutoff : layers with relative weights below this value will be ignored
19691969
19701970 Returns
3131 qz : array-like
3232 vector of the qz values (offset from the Bragg peak)
3333 RL : float
34 lateral block radius in Angstrom
34 lateral block radius in angstrom
3535 RV : float
36 vertical block radius in Angstrom
36 vertical block radius in angstrom
3737 Delta : float
3838 root mean square misorientation of the grains in degree
3939 hx : float
8080 # in the axial convolver the parameters slit_length_source can not be equal to
8181 # slit_length_target!
8282
83 # in this file SI units (m) are used for wavelengths, while by default Angstrom
83 # in this file SI units (m) are used for wavelengths, while by default angstrom
8484 # are used in the remaining of the package
8585
8686 import atexit
11921192 spect = numpy.array((
11931193 xx.emiss_wavelengths, xx.emiss_intensities,
11941194 xx.emiss_lor_widths, xx.emiss_gauss_widths))
1195 # convert to Angstroms, like Topas
1195 # convert to angstroms, like Topas
11961196 spect[0] *= 1e10 * self.length_scale_m
1197 spect[2] *= 1e13 * self.length_scale_m # milli-Angstroms
1198 spect[3] *= 1e13 * self.length_scale_m # milli-Angstroms
1197 spect[2] *= 1e13 * self.length_scale_m # milli-angstroms
1198 spect[3] *= 1e13 * self.length_scale_m # milli-angstroms
11991199 nm = 1e9 * self.length_scale_m
12001200 items = ["emission and broadening:"]
12011201 items.append("spectrum=\n" + str(spect.transpose()))
3939 keyword arguments.
4040
4141 Note:
42 After the end-of-use it is advisable to call the `close()` method to
43 cleanup the multiprocessing calculation!
42 After the end-of-use it is advisable to call the `close()` method
43 to cleanup the multiprocessing calculation!
4444
4545 Parameters
4646 ----------
5656 loaded from the config file.
5757 I0 : float, optional
5858 scaling factor for the simulation result
59
5960
6061 In particular interesting in fpsettings might be:
6162 {'displacement': {'specimen_displacement': z-displacement of the sample
244244 an xrayutilties material describing optical and crystal properties of
245245 the thin film
246246 thickness : float
247 film thickness in Angstrom
247 film thickness in angstrom
248248 """
249249
250250 _valid_init_kwargs = {'roughness': 'root mean square roughness',
262262 an xrayutilties material describing optical and crystal properties
263263 of the thin film
264264 thickness : float
265 film thickness in Angstrom
265 film thickness in angstrom
266266 kwargs : dict
267267 optional keyword arguments with further layer properties.
268268 roughness : float, optional
269 root mean square roughness of the top interface in Angstrom
269 root mean square roughness of the top interface in angstrom
270270 density : float, optional
271271 density of the material in kg/m^3; If not specified the density of
272272 the material will be used.
7777
7878 def lam2en(inp):
7979 """
80 converts the input wavelength in Angstrom to an energy in eV
80 converts the input wavelength in angstrom to an energy in eV
8181
8282 Parameters
8383 ----------
8484 inp : float or str
85 wavelength in Angstrom
85 wavelength in angstrom
8686
8787 Returns
8888 -------
102102
103103 def en2lam(inp):
104104 """
105 converts the input energy in eV to a wavelength in Angstrom
105 converts the input energy in eV to a wavelength in angstrom
106106
107107 Parameters
108108 ----------
112112 Returns
113113 -------
114114 float
115 wavlength in Angstrom
115 wavlength in angstrom
116116
117117 Examples
118118 --------
162162 Parameters
163163 ----------
164164 wl : float, array-like or str
165 wavelength; If scalar or array the wavelength in Angstrom will be
165 wavelength; If scalar or array the wavelength in angstrom will be
166166 returned unchanged, string with emission name is converted to
167167 wavelength
168168
169169 Returns
170170 -------
171171 float or array-like
172 wavelength in Angstrom
172 wavelength in angstrom
173173 """
174174
175175 if isinstance(wl, numbers.Number):
1818 info_all = 2
1919 debug = 3
2020
21 # default wavelength in Angstrom
21 # default wavelength in angstrom
2222 wavelength = CuKa1
2323
2424 # default energy in eV
00 Metadata-Version: 2.1
11 Name: xrayutilities
2 Version: 1.7.0
2 Version: 1.7.1
33 Summary: package for x-ray diffraction data evaluation
4 Home-page: http://xrayutilities.sourceforge.net
4 Home-page: https://xrayutilities.sourceforge.io
55 Author: Eugen Wintersberger, Dominik Kriegner
66 Author-email: eugen.wintersberger@desy.de, dominik.kriegner@gmail.com
77 Maintainer: Dominik Kriegner
1010 Description: xrayutilities
1111 =============
1212
13
1314 [![Build Status](https://dev.azure.com/dominikkriegner/xrayutilities/_apis/build/status/dkriegner.xrayutilities?repoName=dkriegner%2Fxrayutilities&branchName=master)](https://dev.azure.com/dominikkriegner/xrayutilities/_build/latest?definitionId=1&repoName=dkriegner%2Fxrayutilities&branchName=master)
14
1515
1616 xrayutilities is a collection of scripts used to analyze and simulate x-ray
1717 diffraction data. It consists of a Python package and several routines coded
2222 diffraction is included.
2323
2424
25 Copyright (C) 2009-2020 Dominik Kriegner <dominik.kriegner@gmail.com>
25 Copyright (C) 2009-2021 Dominik Kriegner <dominik.kriegner@gmail.com>
2626
2727 Copyright (C) 2009-2013 Eugen Wintersberger <eugen.wintersberger@desy.de>
2828
4545 * *lib/xrayutilities*: directory with the sources for the Python package
4646 * *tests*: directory with the unittest scripts
4747 * *setup.py*: setuptools install script used for the package installation
48 * *xrayutilities.pdf*: pdf-file with documentation of the package
4948
5049
5150 Installation (pip)
110109 - sphinx (optional - only when you want to build the documentation)
111110 - numpydoc (optional - only when you want to build the documentation)
112111 - rst2pdf (optional - only when you want to build the documentation)
112 - sphinx_rtd_theme (optional - only when you want to build the documentation)
113 - svglib (optional - only when you want to build the pdf documentation)
113114
114115 refer to your operating system documentation to find out how to install
115116 those packages. On Microsoft Windows refer to the Documentation for the
171172 git pull
172173
173174 or download the new tarball from sourceforge
174 (http://sf.net/projects/xrayutilities) if any code changed during the update you
175 (https://sf.net/projects/xrayutilities) if any code changed during the update you
175176 need to reinstall the Python package. Thats easiest achieved by
176177
177178 pip install .
193194 Documentation
194195 =============
195196
196 Documentation for xrayutilities is found in the *xrayutilities.pdf* file or on the
197 webpage http://xrayutilities.sourceforge.io
197 Documentation for xrayutilities is found on the webpage
198 https://xrayutilities.sourceforge.io
198199
199200 The API-documentation can also be browsed by
200201
207208 Classifier: Programming Language :: Python :: 3.6
208209 Classifier: Programming Language :: Python :: 3.7
209210 Classifier: Programming Language :: Python :: 3.8
211 Classifier: Programming Language :: Python :: 3.9
210212 Classifier: Topic :: Scientific/Engineering :: Physics
211213 Classifier: Intended Audience :: Science/Research
212214 Classifier: Development Status :: 5 - Production/Stable
215217 Description-Content-Type: text/markdown
216218 Provides-Extra: plot
217219 Provides-Extra: fit
218 Provides-Extra: lzma
00 CHANGES.txt
1 CONTRIBUTING.md
21 LICENSE.txt
32 MANIFEST.in
43 README.md
5 azure-pipelines.yml
64 setup.py
7 xrayutilities.pdf
8 doc/README_sf.rst
9 doc/webpage.patch
105 doc/source/conf.py
116 doc/source/example_xu_ccd_parameter.py
127 doc/source/example_xu_ccd_parameter_hkl.py
1510 doc/source/examples.rst
1611 doc/source/favicon.ico
1712 doc/source/index.rst
18 doc/source/modules.rst
1913 doc/source/simulations.rst
20 doc/source/xrayutilities.analysis.rst
21 doc/source/xrayutilities.io.rst
22 doc/source/xrayutilities.materials.rst
23 doc/source/xrayutilities.math.rst
24 doc/source/xrayutilities.rst
25 doc/source/xrayutilities.simpack.rst
2614 doc/source/pics/fit_xrd.svg
2715 doc/source/pics/line_cut_intdir.png
2816 doc/source/pics/line_cut_radial.png
8068 examples/xrayutilities_read_spec.py
8169 examples/xrayutilities_reflection_strength.py
8270 examples/xrayutilities_show_reciprocal_space_plane.py
83 examples/xrayutilities_user.conf
8471 examples/data/BaF2.cif
8572 examples/data/Calcite.cif
8673 examples/data/LaB6_d500_si_psd.xye.bz2
184171 src/qconversion.c
185172 src/qconversion.h
186173 src/xrayutilities.h
187 tests/README.txt
188174 tests/__init__.py
189175 tests/test_HXRD.py
190176 tests/test_NonCOP.py
00 numpy>=1.9.2
1 scipy>=0.11.0
1 scipy>=0.13.0
22 h5py
33
44 [fit]
55 lmfit>=1.0.1
66
7 [lzma]
8 lzma
9
107 [plot]
118 matplotlib>=3.1.0
1313 # along with this program; if not, see <http://www.gnu.org/licenses/>.
1414 #
1515 # Copyright (C) 2009 Eugen Wintersberger <eugen.wintersberger@desy.de>
16 # Copyright (C) 2010-2020 Dominik Kriegner <dominik.kriegner@gmail.com>
16 # Copyright (C) 2010-2021 Dominik Kriegner <dominik.kriegner@gmail.com>
1717
1818 import glob
1919 import os.path
140140 sources=glob.glob(os.path.join('src', '*.c')))
141141
142142 with open('lib/xrayutilities/VERSION') as version_file:
143 version = version_file.read().strip()
143 version = version_file.read().strip().replace('\n', '.')
144144
145145 try:
146146 import sphinx
178178 "Programming Language :: Python :: 3.6",
179179 "Programming Language :: Python :: 3.7",
180180 "Programming Language :: Python :: 3.8",
181 "Programming Language :: Python :: 3.9",
181182 "Topic :: Scientific/Engineering :: Physics",
182183 "Intended Audience :: Science/Research",
183184 "Development Status :: 5 - Production/Stable",
197198 },
198199 python_requires='~=3.6',
199200 setup_requires=['numpy', 'scipy', 'h5py'],
200 install_requires=['numpy>=1.9.2', 'scipy>=0.11.0', 'h5py'],
201 install_requires=['numpy>=1.9.2', 'scipy>=0.13.0', 'h5py'],
201202 extras_require={
202203 'plot': ["matplotlib>=3.1.0"],
203204 'fit': ["lmfit>=1.0.1"],
204 'lzma': ["lzma"],
205205 },
206206 include_dirs=[numpy.get_include()],
207207 ext_modules=[extmodul],
208208 cmdclass=cmdclass,
209 url="http://xrayutilities.sourceforge.net",
209 url="https://xrayutilities.sourceforge.io",
210210 license="GPLv2",
211211 script_args=args
212212 )
275275 " of investigated crystal (9)\n"
276276 " sampledis ....... sample displacement vector in same unit as the\n"
277277 " detector distance\n"
278 " lambda .......... wavelength of the used x-rays in Angstroem\n"
278 " lambda .......... wavelength of the used x-rays in angstrom\n"
279279 " nthreads ........ number of threads to use in parallel section of the\n"
280280 " code\n"
281281 " flags ........... integer flags to select sub-function\n"
12011201 * of investigated crystal (3, 3)
12021202 * sampledis ....... sample displacement vector, same units as the
12031203 * detector distance
1204 * lambda .......... wavelength of the used x-rays in Angstroem (Npoints,)
1204 * lambda .......... wavelength of the used x-rays in angstrom (Npoints,)
12051205 * nthreads ........ number of threads to use in parallel section of
12061206 * the code
12071207 * flags ........... integer with flags: (1: has_translations;
13991399 * tilt ............ tilt of the detector direction from dir
14001400 * UB .............. orientation matrix and reciprocal space conversion
14011401 * of investigated crystal (3, 3)
1402 * lambda .......... wavelength of the used x-rays in Angstroem (Npoints,)
1402 * lambda .......... wavelength of the used x-rays in angstrom (Npoints,)
14031403 * Npoints ......... number of points to calculate
14041404 * Ns .............. number of sample axes
14051405 * Nd .............. number of detector axes
15161516 * of investigated crystal (3, 3)
15171517 * sampledis ....... sample displacement vector, same units as the
15181518 * detector distance
1519 * lambda .......... wavelength of the used x-rays in Angstroem (Npoints,)
1519 * lambda .......... wavelength of the used x-rays in angstrom (Npoints,)
15201520 * Npoints ......... number of points to calculate
15211521 * Ns .............. number of sample axes
15221522 * Nd .............. number of detector axes
16331633 * tilt ............ tilt of the detector direction from dir
16341634 * UB .............. orientation matrix and reciprocal space conversion
16351635 * of investigated crystal (3, 3)
1636 * lambda .......... wavelength of the used x-rays in Angstroem (Npoints,)
1636 * lambda .......... wavelength of the used x-rays in angstrom (Npoints,)
16371637 * Npoints ......... number of points to calculate
16381638 * Ns .............. number of sample axes
16391639 * Nd .............. number of detector axes
17461746 * of investigated crystal (3, 3)
17471747 * sampledis ....... sample displacement vector, same units as the
17481748 * detector distance
1749 * lambda .......... wavelength of the used x-rays in Angstroem (Npoints,)
1749 * lambda .......... wavelength of the used x-rays in angstrom (Npoints,)
17501750 * Npoints ......... number of points to calculate
17511751 * Ns .............. number of sample axes
17521752 * Nd .............. number of detector axes
+0
-27
tests/README.txt less more
0 xrayutilities unittests
1 =======================
2
3 To run ALL the unittests execute in the package root
4
5 python setup.py test
6
7 or
8
9 python -m unittest discover
10
11
12 Individual tests can be run by
13
14 python -m unitest <testfile>
15
16
17 Additional test data
18 --------------------
19
20 To run specific tests (file parsers) additional test data files are needed.
21 If those files are not present the tests are skipped. Because of their size
22 they are shipped seperately and can be downloaded at
23 https://sourceforge.net/projects/xrayutilities/files/
24
25 The latest 'testdata' tarball has to be unpacked and placed in the
26 'tests' directory, which will place all data under 'tests/data'.
xrayutilities.pdf less more
Binary diff not shown