[MAIN] init git repo , implement fitter class, organize workdir of repo

README.md

@@ -1,3 +1,35 @@
 # Clutter_chuva
 
-Repositorio para códigos de fitting de distribuições de dados de 
+Repositorio para códigos de fitting de distribuições de dados de chuva e clutter.
+
+## Instalação
+
+```bash
+pip install -e .
+```
+
+## Uso nos notebooks
+
+```python
+from clutter_chuva import Fitter
+from scipy.stats import gamma, weibull_min, lognorm
+
+fitter = Fitter(
+    [gamma, weibull_min, lognorm],
+    gamma_params={'floc': 0},
+)
+fitter.fit(data)
+fitter.validate(n_mc_samples=999)
+fitter.summary()
+fitter.histogram_with_fits().show()
+```
+
+## Estrutura
+
+```text
+clutter_chuva/      # pacote principal (importável nos notebooks)
+  fitting/          # Fitter e DistributionSummary
+notebooks/          # notebooks Jupyter
+scripts/            # scripts .py para execução em background
+data/               # dados (não versionados)
+```