Metadata-Version: 2.4
Name: OASYS2-ESRF-EXTENSIONS
Version: 0.0.21
Summary: oasys2-esrf-extensions
Home-page: https://github.com/oasys-esrf-kit/OASYS2-ESRF-EXTENSIONS
Download-URL: https://github.com/oasys-esrf-kit/OASYS2-ESRF-EXTENSIONS
Author: Juan Reyes-Herrera, Rafael Celestre
Author-email: M Sanchez del Rio <srio@esrf.eu>
License-Expression: MIT
Project-URL: Homepage, https://github.com/oasys-esrf-kit/OASYS2-ESRF-EXTENSIONS
Project-URL: Download, https://github.com/oasys-esrf-kit/OASYS2-ESRF-EXTENSIONS
Keywords: ray tracing,wave optics,x-ray optics,oasys2
Classifier: Development Status :: 4 - Beta
Classifier: Environment :: X11 Applications :: Qt
Classifier: Environment :: Console
Classifier: Environment :: Plugins
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3 :: Only
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Programming Language :: Python :: 3.13
Classifier: Intended Audience :: Science/Research
Requires-Python: >=3.10
Description-Content-Type: text/markdown
License-File: LICENSE
Requires-Dist: oasys2>=0.0.51
Requires-Dist: shadow4>=0.1.87
Requires-Dist: pandas
Requires-Dist: numba
Requires-Dist: oasys-barc4ro>=2025.9.9
Requires-Dist: barc4shadow>=2026.07.22
Requires-Dist: barc4beams>=2026.07.22
Dynamic: download-url
Dynamic: home-page
Dynamic: license-file

# OASYS2-ESRF-Extensions
OASYS2 extensions for the ESRF

This repository contains extensions to Oasys developed at ESRF. 

## Install as user

To install the add-on as user: 

+ In the Oasys window, open "Options->Add-ons..."
+ click the button "Add more" and enter "OASYS2-ESRF-Extensions". You will see a new entry "ESRFExtensions" in the add-on list. Check it and click "OK"
+ Restart Oasys.

![addon menu](https://github.com/oasys-esrf-kit/OASYS2-ESRF-Extensions/blob/main/images/image2.png "addon menu")


Once it is installed, it should populate the widget bar on the side.

![side menu](https://github.com/oasys-esrf-kit/OASYS2-ESRF-Extensions/blob/main/images/image1.png "side menu")


## Install as developper

To install it as developper, download it from github:
```
git clone  https://github.com/oasys-esrf-kit/OASYS2-ESRF-Extensions
cd OASYS2-ESRF-Extensions
```

Then link the source code to your Oasys python (note that you must use the python that Oasys uses):  
```
python -m pip install -e . --no-deps --no-binary :all:
```

When restarting Oasys, you will see the ESRF addons there.

## Upload new version to the pypi server

First create a new version using your developper installation. Do not forget to increment the version number in setup.py

+ Then run:

```
python setup.py sdist
```

+ Followed by:

```
python -m twine upload dist/OASYS2-ESRF-Extensions-X.X.X.tar.gz
```

You need an account in pypi.org and be authorized in https://pypi.org/project/OASYS2-ESRF-Extensions/
