Metadata-Version: 2.1
Name: kllr
Version: 1.0.0
Summary: Kernel Localized Linear Regression.
Home-page: https://github.com/afarahi/kllr
Author: Arya Farahi, Dhayaa Anbajagane
Author-email: aryaf@umich.edu
License: MIT
Description: ![GitHub](https://img.shields.io/github/license/afarahi/kllr)
        ![GitHub All Releases](https://img.shields.io/github/downloads/afarahi/kllr/total)
        ![GitHub issues](https://img.shields.io/github/issues/afarahi/kllr)
        
        <p align="center">
          <img src="logo.png" width="300" title="logo">
        </p>
        
        # Introduction
        
         
        Linear regression of the simple least-squares variety has been a canonical method used to characterize
         the relation between two variables, but its utility is limited by the fact that it reduces full 
         population statistics down to three numbers: a slope, normalization and variance/standard deviation.
         With large empirical or simulated samples we can perform a more sensitive analysis
         using a localized linear regression method (see, Farahi et al. 2018 and Anbajagane et al. 2020).
         The KLLR method generates estimates of conditional statistics in terms of the local the slope, normalization,
         and covariance. Such a method provides a more nuanced description of population statistics appropriate
         for the very large samples with non-linear trends.
        
        This code is an implementation of the Kernel Localized Linear Regression (KLLR) method 
        that performs a localized Linear regression described in Farahi et al. (2018). It employs 
        bootstrap re-sampling technique to estimate the uncertainties. We also provide a set of visualization
        tools so practitioners can seamlessly generate visualization of the model parameters.
        
        If you use KLLR or derivates based on it, please cite the following papers which introduced the tool:
        
        [Localized massive halo properties in BAHAMAS and MACSIS simulations: scalings, lognormality, and covariance](https://academic.oup.com/mnras/article-abstract/478/2/2618/4993329)
        
        [Stellar Property Statistics of Massive Halos from Cosmological Hydrodynamics Simulations: Common Kernel Shapes](https://arxiv.org/abs/2001.02283)
        
        ## Dependencies
        
        `numpy`, `scipy`,  `matplotlib`, `pandas`, `sklearn`, `tqdm`
        
        ## References
        
        [1]. A. Farahi, et al. "Localized massive halo properties in BAHAMAS and MACSIS simulations: scalings, lognormality, and covariance." Monthly Notices of the Royal Astronomical Society 478.2 (2018): 2618-2632.
        
        [2]. D. Anbajagane, et al. Stellar Property Statistics of Massive Halos from Cosmological Hydrodynamics Simulations: Common Kernel Shapes. No. arXiv: 2001.02283. 2020.
        
        
        ## Acknowledgment
        
        
        ## Quickstart
        
        To start using KLLR, simply use `from KLLR import kllr_model` to
        access the primary functions and class. The exact requirements for the inputs are
        listed in the docstring of the kllr_model() class further below.
        An example for using KLLR looks like this:
        
                                                                                
                from kllr import kllr_model                                       
                                                                                  
                lm = kllr_model(kernel_type = 'gaussian', kernel_width = 0.2)     
                xrange, yrange_mean, intercept, slope, scatter = lm.fit(x, y, nbins=11)                                   
                                                                                  
            
        
        
Keywords: linear,regression,astronomy,astrophysics,parameter estimation
Platform: UNKNOWN
Classifier: Programming Language :: Python :: 2
Classifier: Programming Language :: Python :: 3
Classifier: Intended Audience :: Science/Research
Classifier: License :: OSI Approved :: MIT License
Classifier: Topic :: Scientific/Engineering
Classifier: Topic :: Scientific/Engineering :: Astronomy
Classifier: Topic :: Scientific/Engineering :: Physics
Description-Content-Type: text/markdown
