Skip to content

Commit 07c415f

Browse files
committed
Added new README file
1 parent 31ff4a6 commit 07c415f

6 files changed

Lines changed: 237 additions & 0 deletions

File tree

Lines changed: 220 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,220 @@
1+
Metadata-Version: 2.1
2+
Name: PyKinematicalBroadening
3+
Version: 0.0.7
4+
Summary: Extragalactic Kinematics is an exciting tool that utilizes a kernel (e.g., Gaussian) to broaden models in velocity space, resulting in a highly accurate and detailed output. With this repository, you can easily apply kinematical broadening to your models and gain valuable insights into extragalactic kinematics.
5+
Home-page: https://github.com/neutrinomuon/PyKinematicalBroadening
6+
Author: Jean Gomes
7+
Author-email: antineutrinomuon@gmail.com
8+
License: UNKNOWN
9+
Platform: UNKNOWN
10+
Classifier: Programming Language :: Python :: 3
11+
Classifier: Operating System :: OS Independent
12+
Description-Content-Type: text/markdown
13+
License-File: LICENSE.txt
14+
15+
### PyKinematicalBroadening
16+
email: [antineutrinomuon@gmail.com](mailto:antineutrinomuon@gmail.com), [jean@astro.up.pt](mailto:jean@astro.up.pt)
17+
18+
© Copyright ®
19+
20+
J.G. - Jean Gomes
21+
22+
<hr>
23+
24+
![python3](https://img.shields.io/pypi/pyversions/pyfluxconserving)
25+
26+
<hr>
27+
28+
#### <b>RESUME</b>
29+
30+
PyKinematicalBroadening is an Extragalactic Kinematics repository for applying
31+
a kernel in velocity space to models in order to obtain the respective
32+
broadened model. This is a python code that performs kinematical broadening of
33+
a spectrum by applying a kernel in velocity space to a model, and obtaining
34+
the respective broadened model. The code defines the function broadening,
35+
which performs the convolution with a Gaussian kernel. The kernel is generated
36+
using a certain number of points, which can be set with the Ni_Gauss
37+
parameter. The code then reads in a test spectrum from a file, interpolates it
38+
onto a set of equally spaced wavelength values, and then plots the original
39+
and broadened spectra for different velocity dispersions.
40+
41+
In detail, the GaussianConvolution function convolves a given input spectrum
42+
fluxes_o defined at wavelengths lambda_o with a Gaussian kernel of width
43+
vd_sigma and mean velocity vc0_gals. The kernel is defined with Ni_Gauss
44+
points, which should be at least as large as vd_sigma. The output spectrum is
45+
defined at wavelengths lambda_s, and is returned as fluxes_s. The fill_val
46+
parameter defines the value to use for regions outside of the original
47+
wavelength range, and verbosity controls the level of detail of console
48+
output.
49+
50+
The main code reads in a test spectrum from a file and interpolates it onto a
51+
set of equally spaced wavelength values. It then loops over different velocity
52+
dispersions and calls 'broadening' for each one, broadening the spectrum and
53+
plotting the results.
54+
55+
<hr>
56+
57+
#### <b>INSTALLATION</b>
58+
59+
You can easily install <a href=https://pypi.org/project/PyKinematicalBroadening/>PyKinematicalBroadening</a> by using pip - <a href='https://pypi.org/'>PyPI - The Python Package Index</a>:
60+
61+
<pre>
62+
pip install PyKinematicalBroadening
63+
</pre>
64+
65+
<br>or by using a generated conda repository <a href='https://anaconda.org/neutrinomuon/PyKinematicalBroadening'>https://anaconda.org/neutrinomuon/PyKinematicalBroadening</a>:
66+
67+
[![badgetanaconda](https://anaconda.org/neutrinomuon/PyKinematicalBroadening/badges/version.svg)](https://anaconda.org/neutrinomuon/PyKinematicalBroadening/badges/version.svg)
68+
[![badgetreleasedate](https://anaconda.org/neutrinomuon/PyKinematicalBroadening/badges/latest_release_date.svg)](https://anaconda.org/neutrinomuon/PyKinematicalBroadening/badges/latest_release_date.svg)
69+
[![badgetplatforms](https://anaconda.org/neutrinomuon/PyKinematicalBroadening/badges/platforms.svg
70+
)](https://anaconda.org/neutrinomuon/PyKinematicalBroadening/badges/platforms.svg)
71+
72+
<pre>
73+
conda install -c neutrinomuon PyKinematicalBroadening
74+
</pre>
75+
76+
<br>OBS.: Linux, OS-X ad Windows pre-compilations available in conda.
77+
78+
You can also clone the repository and install by yourself in your machine:
79+
80+
<pre>
81+
git clone https://github.com/neutrinomuon/PyKinematicalBroadening
82+
python setup.py install
83+
</pre>
84+
85+
<hr>
86+
87+
#### <b>EXAMPLE</b>
88+
89+
Example of the test_spectrum test_spectrum.spec successively broadened by different velocity dispersions in [km/s]. The code is not optimized for cpu speed, but it shows the principle of how it works.
90+
91+
<img src="https://github.com/neutrinomuon/PyKinematicalBroadening/blob/main/figures/KinematicalBroadening.png?raw=true" width="90%">
92+
93+
<hr>
94+
95+
#### <b>STRUCTURE</b>
96+
97+
<pre>
98+
PyKinematicalBroadening
99+
├── MANIFEST.in
100+
├── dist
101+
│ ├── PyKinematicalBroadening-0.0.3.tar.gz
102+
│ ├── PyKinematicalBroadening-0.0.5.tar.gz
103+
│ ├── PyKinematicalBroadening-0.0.6.tar.gz
104+
│ └── PyKinematicalBroadening-0.0.4.tar.gz
105+
├── README.md
106+
├── figures
107+
│ ├── KinematicalBroadening.png
108+
│ └── cc_logo.png
109+
├── PyKinematicalBroadening.egg-info
110+
│ ├── PKG-INFO
111+
│ ├── dependency_links.txt
112+
│ ├── SOURCES.txt
113+
│ ├── top_level.txt
114+
│ └── requires.txt
115+
├── LICENSE.txt
116+
├── setup.py
117+
├── tutorials
118+
│ ├── .ipynb_checkpoints
119+
│ │ └── Example 1 - Kinematical Broadening-checkpoint.ipynb
120+
│ └── Example 1 - Kinematical Broadening.ipynb
121+
├── pykinematicalbroadening
122+
│ ├── win-32
123+
│ │ └── pykinematicalbroadening-0.0.5-py39_0.tar.bz2
124+
│ ├── linux-armv7l
125+
│ │ └── pykinematicalbroadening-0.0.5-py39_0.tar.bz2
126+
│ ├── linux-armv6l
127+
│ │ ├── .projectignore
128+
│ │ └── pykinematicalbroadening-0.0.5-py39_0.tar.bz2
129+
│ ├── linux-s390x
130+
│ │ └── pykinematicalbroadening-0.0.5-py39_0.tar.bz2
131+
│ ├── linux-ppc64
132+
│ │ └── pykinematicalbroadening-0.0.5-py39_0.tar.bz2
133+
│ ├── linux-aarch64
134+
│ │ ├── .projectignore
135+
│ │ └── pykinematicalbroadening-0.0.5-py39_0.tar.bz2
136+
│ ├── linux-32
137+
│ │ ├── .projectignore
138+
│ │ └── pykinematicalbroadening-0.0.5-py39_0.tar.bz2
139+
│ ├── linux-64
140+
│ │ ├── .projectignore
141+
│ │ └── pykinematicalbroadening-0.0.5-py39_0.tar.bz2
142+
│ ├── osx-64
143+
│ │ └── pykinematicalbroadening-0.0.5-py39_0.tar.bz2
144+
│ ├── meta.yaml
145+
│ ├── win-64
146+
│ │ └── pykinematicalbroadening-0.0.5-py39_0.tar.bz2
147+
│ ├── README.txt
148+
│ ├── linux-ppc64le
149+
│ │ └── pykinematicalbroadening-0.0.5-py39_0.tar.bz2
150+
│ └── osx-arm64
151+
│ └── pykinematicalbroadening-0.0.5-py39_0.tar.bz2
152+
├── Pykinematicalbroadening.egg-info
153+
│ ├── PKG-INFO
154+
│ ├── dependency_links.txt
155+
│ ├── SOURCES.txt
156+
│ ├── top_level.txt
157+
│ └── requires.txt
158+
├── src
159+
│ └── python
160+
│ ├── __pycache__
161+
│ ├── test_spectrum.spec
162+
│ ├── __init__.py
163+
│ └── PyKinematicalBroadening.py
164+
├── version.txt
165+
└── build
166+
└── lib
167+
├── Pykinematicalbroadening
168+
└── PyKinematicalBroadening
169+
170+
26 directories, 44 files
171+
</pre>
172+
173+
<hr>
174+
175+
#### <b>REFERENCES</b>
176+
177+
<ol>
178+
179+
<il>Bureau, M., et al. "The SAURON project - III. Integral-field absorption-line
180+
kinematics of 48 elliptical and lenticular galaxies." Monthly Notices of the
181+
Royal Astronomical Society, vol. 370, no. 2, 2006, pp. 753-771. DOI: <a
182+
href="https://doi.org/10.1111/j.1365-2966.2006.10998.x">10.1111/j.1365-2966.2006.10998.x</a>. Available
183+
at: <a
184+
href="https://academic.oup.com/mnras/article/370/2/753/1004246">https://academic.oup.com/mnras/article/370/2/753/1004246</a>.</il>
185+
186+
<il>Faber, S. M. "The Stellar Population Histories of Elliptical Galaxies: A
187+
Review." Annual Review of Astronomy and Astrophysics, vol. 46, no. 1, 2008,
188+
pp. 121-157. DOI: <a
189+
href="https://doi.org/10.1146/annurev-astro-082708-101650">10.1146/annurev-astro-082708-101650</a>. Available
190+
at: <a
191+
href="https://www.annualreviews.org/doi/10.1146/annurev-astro-082708-101650">https://www.annualreviews.org/doi/10.1146/annurev-astro-082708-101650</a>.</il>
192+
193+
<il>Peletier, R. F., et al. "The SAURON project - XI. Stellar populations from
194+
absorption-line strength maps of 24 early-type spirals." Monthly Notices of
195+
the Royal Astronomical Society, vol. 379, no. 2, 2007, pp. 445-469. DOI: <a
196+
href="https://doi.org/10.1111/j.1365-2966.2007.11803.x">10.1111/j.1365-2966.2007.11803.x</a>. Available
197+
at: <a
198+
href="https://academic.oup.com/mnras/article/379/2/445/1078958">https://academic.oup.com/mnras/article/379/2/445/1078958</a>.</il>
199+
200+
<il>Maraston, C. "Spectral Synthesis of Stellar Populations with Star Formation
201+
Histories." Monthly Notices of the Royal Astronomical Society, vol. 362,
202+
no. 3, 2005, pp. 799-825. DOI: <a
203+
href="https://doi.org/10.1111/j.1365-2966.2005.09340.x">10.1111/j.1365-2966.2005.09340.x</a>. Available
204+
at: <a
205+
href="https://academic.oup.com/mnras/article/362/3/799/986891">https://academic.oup.com/mnras/article/362/3/799/986891</a>.</il>
206+
207+
</ol>
208+
209+
<hr>
210+
211+
#### <b>LICENSE</b>
212+
213+
Attribution-NonCommercial-NoDerivatives 4.0 (CC BY-NC-ND 4.0)
214+
215+
<img src="https://github.com/neutrinomuon/PyKinematicalBroadening/blob/main/figures/cc_logo.png?raw=true" width="10%">
216+
217+
<a href='https://creativecommons.org/licenses/by-nc-nd/4.0/'>Creative Commons Attribution-NonCommercial-NoDerivs (CC-BY-NC-ND)</a>
218+
219+
220+
Lines changed: 13 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,13 @@
1+
LICENSE.txt
2+
MANIFEST.in
3+
README.md
4+
setup.py
5+
version.txt
6+
PyKinematicalBroadening.egg-info/PKG-INFO
7+
PyKinematicalBroadening.egg-info/SOURCES.txt
8+
PyKinematicalBroadening.egg-info/dependency_links.txt
9+
PyKinematicalBroadening.egg-info/requires.txt
10+
PyKinematicalBroadening.egg-info/top_level.txt
11+
src/python/PyKinematicalBroadening.py
12+
src/python/__init__.py
13+
src/python/test_spectrum.spec
Lines changed: 1 addition & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1 @@
1+
Lines changed: 2 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,2 @@
1+
numpy
2+
matplotlib
Lines changed: 1 addition & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1 @@
1+
PyKinematicalBroadening
-7 Bytes
Binary file not shown.

0 commit comments

Comments
 (0)