Installation

MagicA (Magic Adjustment) can be installed using pip or from source for development.

Requirements

MagicA requires Python 3.8 or higher and depends on:

  • NumPy (>=1.20.0) - Numerical computing

  • SciPy (>=1.7.0) - Scientific computing and statistical distributions

  • Pandas (>=1.3.0) - Data structures and analysis

  • Matplotlib (>=3.4.0) - Plotting and visualization

  • xarray (>=0.19.0) - Labeled multi-dimensional arrays

  • tqdm (>=4.62.0) - Progress bars

Install via pip

The easiest way to install MagicA is using pip:

pip install magica

This will automatically install all required dependencies.

Install from Source

For development or to get the latest features:

# Clone the repository
git clone https://github.com/daniloceano/MagicA.git
cd MagicA

# Install in development mode
pip install -e .

Development Installation

For contributing to MagicA, install with development dependencies:

# Clone the repository
git clone https://github.com/daniloceano/MagicA.git
cd MagicA

# Install with development dependencies
pip install -e ".[dev]"

This includes additional packages for:

  • pytest - Testing framework

  • sphinx - Documentation generation

  • black - Code formatting

  • flake8 - Code linting

Verify Installation

To verify that MagicA is correctly installed:

import magica as ma
import numpy as np

# Generate sample data
data = np.random.weibull(2, 1000)

# Create processor and fit distribution
processor = ma.read_data(data)
processor.fit_distribution('weibull_min')

# Get fitted parameters
params = processor.get_fitted_params()
print(f"✓ MagicA installed successfully!")
print(f"Fitted parameters: {params}")

Optional Dependencies

For Jupyter notebook support:

pip install jupyter notebook

For enhanced visualization:

pip install seaborn

Upgrading

To upgrade to the latest version:

pip install --upgrade magica

Uninstalling

To remove MagicA:

pip uninstall magica

Troubleshooting

Common Issues

ImportError: No module named ‘magica’

Make sure MagicA is installed in the active Python environment:

pip show magica

SciPy version conflicts

Ensure you have a compatible SciPy version:

pip install --upgrade scipy>=1.7.0

xarray import errors

Install or upgrade xarray:

pip install --upgrade xarray>=0.19.0

Getting Help

If you encounter issues:

  1. Check the GitHub Issues

  2. Review the Tutorials for examples

  3. Consult the Core Module documentation

  4. Open a new issue on GitHub with details about your problem

Next Steps

After installation: