| Name | pynusinov JSON |
| Version |
0.0.3b2
JSON |
| download |
| home_page | None |
| Summary | Python implementation of models of the ultraviolet radiation spectrum of the Sun |
| upload_time | 2024-09-14 16:12:21 |
| maintainer | None |
| docs_url | None |
| author | None |
| requires_python | >=3.7 |
| license | None |
| keywords |
solar radiation model
euv
fuv
|
| VCS |
|
| bugtrack_url |
|
| requirements |
No requirements were recorded.
|
| Travis-CI |
No Travis.
|
| coveralls test coverage |
No coveralls.
|
# pynusinov
<!--Basic information-->
Implementation of models of the ultraviolet radiation spectra of the Sun described by A.A. Nusinov.
Aeronomic models of variations in the radiation flux in the region of extreme (EUV) and far (FUV) ultraviolet radiation.
If you use this package, please, cite in your research the following paper:
1. Nusinov, A.A., Kazachevskaya, T.V., Katyushina, V.V. - Solar Extreme and Far Ultraviolet Radiation Modeling for Aeronomic
Calculations. Remote Sens. 2021, 13, 1454. https://doi.org/10.3390/rs13081454
# User's guide
<!--Users guide-->
## Installation
The following command is used to install the package:
```
python -m pip install pynusinov
```
pynusinov is the name of the package.
The package contains two classes: Euvt2021 and Fuvt2021.
## Fuvt2021
Implementation of the Nusinov model for calculating the spectrum of far ultraviolet radiation from the Sun (FUV)
in the wavelength range 115-242 nm. The model is based on the idea of a linear dependence of radiation fluxes in
1 nm wide intervals on the intensity in the Lyman-alpha hydrogen line (l = 121.6 nm).
Input parameters:
- flow in the Lyman-alpha line Nla (in units of 10^15 m^-2 * s^-1). You can set one or more Nla values.
Use a list to pass multiple values.
Output parameters:
- xarray dataset
```
<xarray.Dataset> Size: 6kB
Dimensions: (band_center: 127, lyman_alpha_composite: 1, band_number: 127)
Coordinates:
* band_center (band_center) float64 1kB 115.5 116.5 ... 240.5 241.5
* lyman_alpha_composite (lyman_alpha_composite) float64 8B <Nl input values>
* band_number (band_number) int64 1kB 0 1 2 3 4 ... 123 124 125 126
Data variables:
fuv_flux_spectra (band_center, lyman_alpha_composite) float64 1kB 1...
lband (band_number) int64 1kB 115 116 117 ... 239 240 241
uband (band_number) int64 1kB 116 117 118 ... 240 241 242
fuv_band_width (band_number) float64 1kB 1.0 1.0 1.0 ... 1.0 1.0 1.0
```
## Usage example
- import the pynusinov package;
- create an instance of the Fuvt2021 class;
- perform calculations with the created instance.
The following is an example of performing the described steps:
```
>>> # importing a package with the alias p
>>> import pynusinov as p
>>> # creating an instance of the Fuvt2021 class
>>> ex = p.Fuvt2021()
>>> # calculate the spectra values at Nla = 3.31 (10^15) using get_spectra()
>>> spectra = ex.get_spectra(3.31)
>>> # output the resulting FUV-spectra
>>> print(spectra['fuv_flux_spectra'])
<xarray.DataArray 'fuv_flux_spectra' (band_center: 127, lyman_alpha_composite: 1)> Size: 1kB
array([[1.0226240e+13],
[1.3365010e+13],
...
[4.5222314e+16],
[5.3300029e+16]])
Coordinates:
* band_center (band_center) float64 1kB 115.5 116.5 ... 240.5 241.5
* lyman_alpha_composite (lyman_alpha_composite) float64 8B 3.31
```
If you need to calculate the spectrum for several Na values, pass them using a list:
```
>>> # calculate the spectrum values at Nl_1 = 3.31 (10^15) and Nl_2 = 7.12 (10^15) using get_spectra()
>>> spectra = ex.get_spectra([3.31, 7.12])
>>> # output the resulting FUV-spectrum
>>> print(spectra['fuv_flux_spectra'])
<xarray.DataArray 'fuv_flux_spectra' (band_center: 127, lyman_alpha_composite: 2)> Size: 2kB
array([[1.0226240e+13, 1.7099480e+13],
[1.3365010e+13, 1.7826520e+13],
...
[4.5222314e+16, 4.7239328e+16],
[5.3300029e+16, 5.5418008e+16]])
Coordinates:
* band_center (band_center) float64 1kB 115.5 116.5 ... 240.5 241.5
* lyman_alpha_composite (lyman_alpha_composite) float64 16B 3.31 7.12
```
## Euvt2021
Implementation of the Nusinov model for calculating the spectra of the extreme ultraviolet radiation of the Sun (EUV)
in the wavelength range of 10-105 nm. This model calculates the ultraviolet spectra for an individual wavelength or
a wavelength interval. The model is based on the idea of a linear dependence of radiation fluxes in intervals
of unequal width on the intensity in the HeI helium line (l = 58.4 nm).
Input parameters:
- the flow in the HeI line Nl (in units of 10^15 m^-2 * s^-1)
Output parameters:
- xarray dataset
For calculations of the model by interval wavelength and by wavelength interval xarray is different:
```
# wavelength interval
<xarray.Dataset> Size: 968B
Dimensions: (band_center: 20, lyman_alpha_composite: 1,
band_number: 20)
Coordinates:
* band_center (band_center) float64 160B 7.5 12.5 ... 97.5 102.5
* lyman_alpha_composite (lyman_alpha_composite) float64 8B <Nl input values>
* band_number (band_number) int64 160B 0 1 2 3 4 ... 15 16 17 18 19
Data variables:
euv_flux_spectra (band_center, lyman_alpha_composite) float64 160B ...
lband (band_number) int64 160B 5 10 15 20 ... 85 90 95 100
uband (band_number) int64 160B 10 15 20 25 ... 95 100 105
center (band_number) float64 160B 7.5 12.5 ... 97.5 102.5
# wavelength line
<xarray.Dataset> Size: 264B
Dimensions: (line: 16, lyman_alpha_composite: 1)
Coordinates:
* line (line) float64 128B 25.6 28.4 30.4 ... 102.6 103.2
* lyman_alpha_composite (lyman_alpha_composite) float64 8B <Nl input values>
Data variables:
euv_flux_spectra (line, lyman_alpha_composite) float64 128B ...
```
## Usage example
This class contains two methods for calculating the spectrum:
- get_spectral_bands() for calculating the spectrum in a wavelength interval;
- get_spectral_lines() for calculating the spectrum for an individual wavelength.
The steps of work are similar to the steps described for the Fuvt2021 class.
Below is an example of working with the Fuvt2021 class:
1. get_spectral_lines()
```
>>> # importing a package with the alias p
>>> import pynusinov as p
>>> # creating an instance of the Euvt2021 class
>>> ex = p.Euvt2021()
>>> # calculate the spectrum values at Nl = 3.31 (10^15) using get_spectral_lines()
>>> spectra = ex.get_spectral_lines(3.31)
>>> # output the resulting EUV-spectra
>>> print(spectra['euv_flux_spectra'])
<xarray.DataArray 'euv_flux_spectra' (line: 16, lyman_alpha_composite: 1)> Size: 128B
array([[ 1.07475700e+13],
[-3.48013400e+11],
...
[ 3.01426805e+13],
[ 5.22986620e+12]])
Coordinates:
* line (line) float64 128B 25.6 28.4 30.4 ... 102.6 103.2
* lyman_alpha_composite (lyman_alpha_composite) float64 8B 3.31
```
If you need to calculate the spectrum for several Na values, pass them using a list:
```
>>> # calculate the spectrum values at Nl_1 = 3.31 (10^15) and Nl_2 = 7.12 (10^15) using get_spectral_lines()
>>> spectra = ex.get_spectral_lines([3.31, 7.12])
>>> # output the resulting EUV-spectrum
>>> print(spectra['euv_flux_spectra'])
<xarray.DataArray 'euv_flux_spectra' (line: 16, lyman_alpha_composite: 2)> Size: 256B
array([[ 1.07475700e+13, 6.92348800e+13],
[-3.48013400e+11, 1.29777664e+13],
...
[ 3.01426805e+13, 9.21014720e+13],
[ 5.22986620e+12, 1.51018048e+13]])
Coordinates:
* line (line) float64 128B 25.6 28.4 30.4 ... 102.6 103.2
* lyman_alpha_composite (lyman_alpha_composite) float64 16B 3.31 7.12
```
2. get_spectral_bands()
```
>>> # importing a package with the alias p
>>> import pynusinov as p
>>> # creating an instance of the Euvt2021 class
>>> ex = p.Euvt2021()
>>> # calculate the spectrum values at Nl = 3.31 (10^15) using get_spectral_bands()
>>> spectra = ex.get_spectral_bands(3.31)
>>> # output the resulting EUV-spectra
>>> print(spectra['euv_flux_spectra'])
<xarray.DataArray 'euv_flux_spectra' (band_center: 20, lyman_alpha_composite: 1)> Size: 160B
array([[2.52122700e+12],
[2.59186240e+12],
...
[5.73289352e+13],
[9.57620734e+13]])
Coordinates:
* band_center (band_center) float64 160B 7.5 12.5 ... 97.5 102.5
* lyman_alpha_composite (lyman_alpha_composite) float64 8B 3.31
```
If you need to calculate the spectrum for several Na values, pass them using a list:
```
>>> # calculate the spectrum values at Nl_1 = 3.31 (10^15) and Nl_2 = 7.12 (10^15) using get_spectral_bands()
>>> spectra = ex.get_spectral_bands([3.31, 7.12])
>>> # output the resulting EUV-spectrum
>>> print(spectra['euv_flux_spectra'])
<xarray.DataArray 'euv_flux_spectra' (band_center: 20, lyman_alpha_composite: 2)> Size: 320B
array([[2.52122700e+12, 3.44494080e+13],
[2.59186240e+12, 2.14175296e+13],
...
[5.73289352e+13, 1.07909581e+14],
[9.57620734e+13, 2.62794074e+14]])
Coordinates:
* band_center (band_center) float64 160B 7.5 12.5 ... 97.5 102.5
* lyman_alpha_composite (lyman_alpha_composite) float64 16B 3.31 7.12
```
Raw data
{
"_id": null,
"home_page": null,
"name": "pynusinov",
"maintainer": null,
"docs_url": null,
"requires_python": ">=3.7",
"maintainer_email": null,
"keywords": "Solar radiation model, EUV, FUV",
"author": null,
"author_email": "Anton Tatarnikov <tatarnikoffanton@yandex.ru>, Oleg Zolotov <ovz.office@gmail.com>",
"download_url": "https://files.pythonhosted.org/packages/d1/ec/ee778725e475eff8ea336b8a1094fcae19c6155138c79a84e0dbd6972262/pynusinov-0.0.3b2.tar.gz",
"platform": null,
"description": "# pynusinov\r\n<!--Basic information-->\r\nImplementation of models of the ultraviolet radiation spectra of the Sun described by A.A. Nusinov. \r\nAeronomic models of variations in the radiation flux in the region of extreme (EUV) and far (FUV) ultraviolet radiation.\r\n\r\nIf you use this package, please, cite in your research the following paper:\r\n\r\n1. Nusinov, A.A., Kazachevskaya, T.V., Katyushina, V.V. - Solar Extreme and Far Ultraviolet Radiation Modeling for Aeronomic\r\nCalculations. Remote Sens. 2021, 13, 1454. https://doi.org/10.3390/rs13081454\r\n\r\n# User's guide\r\n\r\n<!--Users guide-->\r\n\r\n## Installation\r\n\r\nThe following command is used to install the package:\r\n\r\n```\r\npython -m pip install pynusinov\r\n```\r\n\r\npynusinov is the name of the package.\r\n\r\nThe package contains two classes: Euvt2021 and Fuvt2021.\r\n\r\n## Fuvt2021\r\n\r\nImplementation of the Nusinov model for calculating the spectrum of far ultraviolet radiation from the Sun (FUV)\r\nin the wavelength range 115-242 nm. The model is based on the idea of a linear dependence of radiation fluxes in\r\n1 nm wide intervals on the intensity in the Lyman-alpha hydrogen line (l = 121.6 nm).\r\n\r\nInput parameters:\r\n- flow in the Lyman-alpha line Nla (in units of 10^15 m^-2 * s^-1). You can set one or more Nla values.\r\nUse a list to pass multiple values.\r\n\r\nOutput parameters:\r\n- xarray dataset\r\n\r\n```\r\n<xarray.Dataset> Size: 6kB\r\nDimensions: (band_center: 127, lyman_alpha_composite: 1, band_number: 127)\r\nCoordinates:\r\n * band_center (band_center) float64 1kB 115.5 116.5 ... 240.5 241.5\r\n * lyman_alpha_composite (lyman_alpha_composite) float64 8B <Nl input values>\r\n * band_number (band_number) int64 1kB 0 1 2 3 4 ... 123 124 125 126\r\nData variables:\r\n fuv_flux_spectra (band_center, lyman_alpha_composite) float64 1kB 1...\r\n lband (band_number) int64 1kB 115 116 117 ... 239 240 241\r\n uband (band_number) int64 1kB 116 117 118 ... 240 241 242\r\n fuv_band_width (band_number) float64 1kB 1.0 1.0 1.0 ... 1.0 1.0 1.0\r\n```\r\n\r\n## Usage example\r\n\r\n- import the pynusinov package;\r\n- create an instance of the Fuvt2021 class;\r\n- perform calculations with the created instance.\r\n\r\nThe following is an example of performing the described steps:\r\n\r\n```\r\n>>> # importing a package with the alias p\r\n>>> import pynusinov as p\r\n>>> # creating an instance of the Fuvt2021 class\r\n>>> ex = p.Fuvt2021()\r\n>>> # calculate the spectra values at Nla = 3.31 (10^15) using get_spectra()\r\n>>> spectra = ex.get_spectra(3.31)\r\n>>> # output the resulting FUV-spectra\r\n>>> print(spectra['fuv_flux_spectra'])\r\n\r\n<xarray.DataArray 'fuv_flux_spectra' (band_center: 127, lyman_alpha_composite: 1)> Size: 1kB\r\narray([[1.0226240e+13],\r\n [1.3365010e+13],\r\n...\r\n [4.5222314e+16],\r\n [5.3300029e+16]])\r\nCoordinates:\r\n * band_center (band_center) float64 1kB 115.5 116.5 ... 240.5 241.5\r\n * lyman_alpha_composite (lyman_alpha_composite) float64 8B 3.31\r\n```\r\n\r\nIf you need to calculate the spectrum for several Na values, pass them using a list:\r\n\r\n```\r\n>>> # calculate the spectrum values at Nl_1 = 3.31 (10^15) and Nl_2 = 7.12 (10^15) using get_spectra()\r\n>>> spectra = ex.get_spectra([3.31, 7.12])\r\n>>> # output the resulting FUV-spectrum\r\n>>> print(spectra['fuv_flux_spectra'])\r\n\r\n<xarray.DataArray 'fuv_flux_spectra' (band_center: 127, lyman_alpha_composite: 2)> Size: 2kB\r\narray([[1.0226240e+13, 1.7099480e+13],\r\n [1.3365010e+13, 1.7826520e+13],\r\n...\r\n [4.5222314e+16, 4.7239328e+16],\r\n [5.3300029e+16, 5.5418008e+16]])\r\nCoordinates:\r\n * band_center (band_center) float64 1kB 115.5 116.5 ... 240.5 241.5\r\n * lyman_alpha_composite (lyman_alpha_composite) float64 16B 3.31 7.12\r\n```\r\n\r\n## Euvt2021\r\n\r\nImplementation of the Nusinov model for calculating the spectra of the extreme ultraviolet radiation of the Sun (EUV)\r\nin the wavelength range of 10-105 nm. This model calculates the ultraviolet spectra for an individual wavelength or \r\na wavelength interval. The model is based on the idea of a linear dependence of radiation fluxes in intervals\r\nof unequal width on the intensity in the HeI helium line (l = 58.4 nm). \r\n\r\nInput parameters:\r\n- the flow in the HeI line Nl (in units of 10^15 m^-2 * s^-1)\r\n\r\nOutput parameters:\r\n- xarray dataset\r\n\r\nFor calculations of the model by interval wavelength and by wavelength interval xarray is different:\r\n\r\n```\r\n# wavelength interval\r\n<xarray.Dataset> Size: 968B\r\nDimensions: (band_center: 20, lyman_alpha_composite: 1,\r\n band_number: 20)\r\nCoordinates:\r\n * band_center (band_center) float64 160B 7.5 12.5 ... 97.5 102.5\r\n * lyman_alpha_composite (lyman_alpha_composite) float64 8B <Nl input values>\r\n * band_number (band_number) int64 160B 0 1 2 3 4 ... 15 16 17 18 19\r\nData variables:\r\n euv_flux_spectra (band_center, lyman_alpha_composite) float64 160B ...\r\n lband (band_number) int64 160B 5 10 15 20 ... 85 90 95 100\r\n uband (band_number) int64 160B 10 15 20 25 ... 95 100 105\r\n center (band_number) float64 160B 7.5 12.5 ... 97.5 102.5\r\n\r\n\r\n# wavelength line\r\n<xarray.Dataset> Size: 264B\r\nDimensions: (line: 16, lyman_alpha_composite: 1)\r\nCoordinates:\r\n * line (line) float64 128B 25.6 28.4 30.4 ... 102.6 103.2\r\n * lyman_alpha_composite (lyman_alpha_composite) float64 8B <Nl input values>\r\nData variables:\r\n euv_flux_spectra (line, lyman_alpha_composite) float64 128B ...\r\n```\r\n\r\n## Usage example\r\n\r\nThis class contains two methods for calculating the spectrum:\r\n- get_spectral_bands() for calculating the spectrum in a wavelength interval;\r\n- get_spectral_lines() for calculating the spectrum for an individual wavelength.\r\n\r\nThe steps of work are similar to the steps described for the Fuvt2021 class. \r\n\r\nBelow is an example of working with the Fuvt2021 class:\r\n\r\n1. get_spectral_lines()\r\n```\r\n>>> # importing a package with the alias p\r\n>>> import pynusinov as p\r\n>>> # creating an instance of the Euvt2021 class\r\n>>> ex = p.Euvt2021()\r\n>>> # calculate the spectrum values at Nl = 3.31 (10^15) using get_spectral_lines()\r\n>>> spectra = ex.get_spectral_lines(3.31)\r\n>>> # output the resulting EUV-spectra\r\n>>> print(spectra['euv_flux_spectra'])\r\n\r\n<xarray.DataArray 'euv_flux_spectra' (line: 16, lyman_alpha_composite: 1)> Size: 128B\r\narray([[ 1.07475700e+13],\r\n [-3.48013400e+11],\r\n... \r\n [ 3.01426805e+13],\r\n [ 5.22986620e+12]])\r\nCoordinates:\r\n * line (line) float64 128B 25.6 28.4 30.4 ... 102.6 103.2\r\n * lyman_alpha_composite (lyman_alpha_composite) float64 8B 3.31\r\n```\r\n\r\nIf you need to calculate the spectrum for several Na values, pass them using a list:\r\n\r\n```\r\n>>> # calculate the spectrum values at Nl_1 = 3.31 (10^15) and Nl_2 = 7.12 (10^15) using get_spectral_lines()\r\n>>> spectra = ex.get_spectral_lines([3.31, 7.12])\r\n>>> # output the resulting EUV-spectrum\r\n>>> print(spectra['euv_flux_spectra'])\r\n\r\n<xarray.DataArray 'euv_flux_spectra' (line: 16, lyman_alpha_composite: 2)> Size: 256B\r\narray([[ 1.07475700e+13, 6.92348800e+13],\r\n [-3.48013400e+11, 1.29777664e+13],\r\n...\r\n [ 3.01426805e+13, 9.21014720e+13],\r\n [ 5.22986620e+12, 1.51018048e+13]])\r\nCoordinates:\r\n * line (line) float64 128B 25.6 28.4 30.4 ... 102.6 103.2\r\n * lyman_alpha_composite (lyman_alpha_composite) float64 16B 3.31 7.12\r\n```\r\n\r\n2. get_spectral_bands()\r\n```\r\n>>> # importing a package with the alias p\r\n>>> import pynusinov as p\r\n>>> # creating an instance of the Euvt2021 class\r\n>>> ex = p.Euvt2021()\r\n>>> # calculate the spectrum values at Nl = 3.31 (10^15) using get_spectral_bands()\r\n>>> spectra = ex.get_spectral_bands(3.31)\r\n>>> # output the resulting EUV-spectra\r\n>>> print(spectra['euv_flux_spectra'])\r\n\r\n<xarray.DataArray 'euv_flux_spectra' (band_center: 20, lyman_alpha_composite: 1)> Size: 160B\r\narray([[2.52122700e+12],\r\n [2.59186240e+12],\r\n...\r\n [5.73289352e+13],\r\n [9.57620734e+13]])\r\nCoordinates:\r\n * band_center (band_center) float64 160B 7.5 12.5 ... 97.5 102.5\r\n * lyman_alpha_composite (lyman_alpha_composite) float64 8B 3.31\r\n```\r\n\r\nIf you need to calculate the spectrum for several Na values, pass them using a list:\r\n\r\n```\r\n>>> # calculate the spectrum values at Nl_1 = 3.31 (10^15) and Nl_2 = 7.12 (10^15) using get_spectral_bands()\r\n>>> spectra = ex.get_spectral_bands([3.31, 7.12])\r\n>>> # output the resulting EUV-spectrum\r\n>>> print(spectra['euv_flux_spectra'])\r\n\r\n<xarray.DataArray 'euv_flux_spectra' (band_center: 20, lyman_alpha_composite: 2)> Size: 320B\r\narray([[2.52122700e+12, 3.44494080e+13],\r\n [2.59186240e+12, 2.14175296e+13],\r\n...\r\n [5.73289352e+13, 1.07909581e+14],\r\n [9.57620734e+13, 2.62794074e+14]])\r\nCoordinates:\r\n * band_center (band_center) float64 160B 7.5 12.5 ... 97.5 102.5\r\n * lyman_alpha_composite (lyman_alpha_composite) float64 16B 3.31 7.12\r\n\r\n```\r\n\r\n\r\n\r\n",
"bugtrack_url": null,
"license": null,
"summary": "Python implementation of models of the ultraviolet radiation spectrum of the Sun",
"version": "0.0.3b2",
"project_urls": null,
"split_keywords": [
"solar radiation model",
" euv",
" fuv"
],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "4946ef7714079e6de7e2a94b6ae8eed3d23e71d76827e5071949ec9774e8861b",
"md5": "f51646315b2ac91003d810355e6bfea4",
"sha256": "0ae370e907d97826aa002757e2e1f097b969b550d794d6064ee6223bf6fd3c1f"
},
"downloads": -1,
"filename": "pynusinov-0.0.3b2-py3-none-any.whl",
"has_sig": false,
"md5_digest": "f51646315b2ac91003d810355e6bfea4",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": ">=3.7",
"size": 20225,
"upload_time": "2024-09-14T16:12:20",
"upload_time_iso_8601": "2024-09-14T16:12:20.137232Z",
"url": "https://files.pythonhosted.org/packages/49/46/ef7714079e6de7e2a94b6ae8eed3d23e71d76827e5071949ec9774e8861b/pynusinov-0.0.3b2-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": "",
"digests": {
"blake2b_256": "d1ecee778725e475eff8ea336b8a1094fcae19c6155138c79a84e0dbd6972262",
"md5": "35f29561c4b4ed82928ad67b306e5791",
"sha256": "a036a86b21b9e3d3d0c2f0efec0f11b0fbc0eeb749dde5d572be49ee37c6af47"
},
"downloads": -1,
"filename": "pynusinov-0.0.3b2.tar.gz",
"has_sig": false,
"md5_digest": "35f29561c4b4ed82928ad67b306e5791",
"packagetype": "sdist",
"python_version": "source",
"requires_python": ">=3.7",
"size": 19373,
"upload_time": "2024-09-14T16:12:21",
"upload_time_iso_8601": "2024-09-14T16:12:21.601486Z",
"url": "https://files.pythonhosted.org/packages/d1/ec/ee778725e475eff8ea336b8a1094fcae19c6155138c79a84e0dbd6972262/pynusinov-0.0.3b2.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2024-09-14 16:12:21",
"github": false,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"lcname": "pynusinov"
}
