datfid 0.1.21__tar.gz

datfid-0.1.21/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 DATFID
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

datfid-0.1.21/PKG-INFO

@@ -0,0 +1,155 @@
+Metadata-Version: 2.4
+Name: datfid
+Version: 0.1.21
+Summary: SDK to access the DATFID API hosted on Hugging Face Spaces
+Author: DATFID
+Author-email: igor.schapiro@datfid.com
+License: MIT
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Programming Language :: Python :: 3
+Requires-Python: >=3.7
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: requests>=2.31.0
+Requires-Dist: pandas>=1.0.1
+Requires-Dist: numpy<2.1,>=1.22
+Dynamic: author
+Dynamic: author-email
+Dynamic: classifier
+Dynamic: description
+Dynamic: description-content-type
+Dynamic: license
+Dynamic: license-file
+Dynamic: requires-dist
+Dynamic: requires-python
+Dynamic: summary
+
+# DATFID SDK
+
+A Python SDK to access the DATFID API to forecast your data.
+
+## Features
+
+- **Easy model fitting**: Build panel data models with time-dependent and static features.
+- **Flexible lag handling**: Specify lags for the dependent variable and selected features.
+- **Forecasting**: Generate future predictions with aligned timestamps and IDs.
+- **Statistical options**: Filter features by significance and apply mean-variance tests.
+- **White box full interpretability**: Get fully interpretable model with equation, estimated parameters, and standard errors.
+
+## Installation
+
+```bash
+pip install datfid
+```
+
+## Usage
+
+Before using the SDK, please request an access token by emailing **admin@datfid.com** or by visiting our website [datfid.com](https://datfid.com).
+
+```python
+from datfid import DATFIDClient
+
+# Initialize the client with your DATFID token
+client = DATFIDClient(token="your_DATFID_token")
+
+# Fit a model
+fit_result = client.fit_model(
+    df=dataframe,
+    id_col="name of id column",
+    time_col="name of time column",
+    y="name of dependent variable",
+    lag_y="starting lag : ending lag",
+    lagged_features={
+        "feature 1": "starting lag : ending lag",
+        "feature 2": "starting lag : ending lag"
+    },
+    current_features=["feature 3", "feature 4"],
+    filter_by_significance=True/False,
+    meanvar_test=True/False
+)
+
+# Generate forecasts
+forecast_df = client.forecast_model(
+    df_forecast=dataframe
+)
+
+# The forecast DataFrame contains the individual IDs and timestamps
+# from the original data plus a "forecast" column with predicted values.
+```
+
+## Example 1
+
+Sample dataset from GitHub (Food and Beverages demand forecasting):
+
+```python
+import pandas as pd
+from datfid import DATFIDClient
+
+# Initialize the client with your DATFID token
+client = DATFIDClient(token="your_DATFID_token")
+
+# Load dataset for model fitting
+url_fit = "https://raw.githubusercontent.com/datfid-valeriidashuk/sample-datasets/main/Food_Beverages.xlsx"
+df = pd.read_excel(url_fit)
+
+# Fit the model
+result = client.fit_model(df=df,
+                          id_col="Product",
+                          time_col="Time",
+                          y="Revenue",
+                          current_features='all',
+                          filter_by_significance=True
+                          )
+
+# Load dataset for forecasting
+url_forecast = "https://raw.githubusercontent.com/datfid-valeriidashuk/sample-datasets/main/Food_Beverages_forecast.xlsx"
+df_forecast = pd.read_excel(url_forecast)
+
+# Forecast revenue using the fitted model
+forecast = client.forecast_model(df_forecast=df_forecast)
+```
+
+## Example 2
+
+Slightly larger sample dataset from GitHub (Banking sector, forecasting loan probability):
+
+```python
+import pandas as pd
+from datfid import DATFIDClient
+
+# Initialize the client with your DATFID token
+client = DATFIDClient(token="your_DATFID_token")
+
+# Load dataset for model fitting
+url_fit = "https://raw.githubusercontent.com/datfid-valeriidashuk/sample-datasets/main/Banking_extended.xlsx"
+df = pd.read_excel(url_fit)
+
+# Fit the model
+result = client.fit_model(df=df,
+                          id_col="Individual",
+                          time_col="Time",
+                          y="Loan Probability",
+                          lag_y="1:3",
+                          lagged_features={"Income Level": "1:3"},
+                          filter_by_significance=True)
+
+# Load dataset for forecasting
+url_forecast = "https://raw.githubusercontent.com/datfid-valeriidashuk/sample-datasets/main/Banking_extended_forecast.xlsx"
+df_forecast = pd.read_excel(url_forecast)
+
+# Forecast loan probability using the fitted model
+forecast = client.forecast_model(df_forecast=df_forecast)
+```
+
+## API Reference
+
+### DATFIDClient
+
+#### `client = DATFIDClient(token: str)`
+Initialize the client with your DATFID token.
+
+#### `client.fit_model(df: pd.DataFrame, id_col: str, time_col: str, y: str, lag_y: Optional[Union[int, str, list[int]]] = None, lagged_features: Optional[Dict[str, int]] = None, current_features: Optional[list] = None, filter_by_significance: bool = False, meanvar_test: bool = False) -> SimpleNamespace`
+Fit a model using the provided dataset.
+
+#### `client.forecast_model(df_forecast: pd.DataFrame) -> pd.DataFrame`
+Generate forecasts using the fitted model.

datfid-0.1.21/README.md

@@ -0,0 +1,129 @@
+# DATFID SDK
+
+A Python SDK to access the DATFID API to forecast your data.
+
+## Features
+
+- **Easy model fitting**: Build panel data models with time-dependent and static features.
+- **Flexible lag handling**: Specify lags for the dependent variable and selected features.
+- **Forecasting**: Generate future predictions with aligned timestamps and IDs.
+- **Statistical options**: Filter features by significance and apply mean-variance tests.
+- **White box full interpretability**: Get fully interpretable model with equation, estimated parameters, and standard errors.
+
+## Installation
+
+```bash
+pip install datfid
+```
+
+## Usage
+
+Before using the SDK, please request an access token by emailing **admin@datfid.com** or by visiting our website [datfid.com](https://datfid.com).
+
+```python
+from datfid import DATFIDClient
+
+# Initialize the client with your DATFID token
+client = DATFIDClient(token="your_DATFID_token")
+
+# Fit a model
+fit_result = client.fit_model(
+    df=dataframe,
+    id_col="name of id column",
+    time_col="name of time column",
+    y="name of dependent variable",
+    lag_y="starting lag : ending lag",
+    lagged_features={
+        "feature 1": "starting lag : ending lag",
+        "feature 2": "starting lag : ending lag"
+    },
+    current_features=["feature 3", "feature 4"],
+    filter_by_significance=True/False,
+    meanvar_test=True/False
+)
+
+# Generate forecasts
+forecast_df = client.forecast_model(
+    df_forecast=dataframe
+)
+
+# The forecast DataFrame contains the individual IDs and timestamps
+# from the original data plus a "forecast" column with predicted values.
+```
+
+## Example 1
+
+Sample dataset from GitHub (Food and Beverages demand forecasting):
+
+```python
+import pandas as pd
+from datfid import DATFIDClient
+
+# Initialize the client with your DATFID token
+client = DATFIDClient(token="your_DATFID_token")
+
+# Load dataset for model fitting
+url_fit = "https://raw.githubusercontent.com/datfid-valeriidashuk/sample-datasets/main/Food_Beverages.xlsx"
+df = pd.read_excel(url_fit)
+
+# Fit the model
+result = client.fit_model(df=df,
+                          id_col="Product",
+                          time_col="Time",
+                          y="Revenue",
+                          current_features='all',
+                          filter_by_significance=True
+                          )
+
+# Load dataset for forecasting
+url_forecast = "https://raw.githubusercontent.com/datfid-valeriidashuk/sample-datasets/main/Food_Beverages_forecast.xlsx"
+df_forecast = pd.read_excel(url_forecast)
+
+# Forecast revenue using the fitted model
+forecast = client.forecast_model(df_forecast=df_forecast)
+```
+
+## Example 2
+
+Slightly larger sample dataset from GitHub (Banking sector, forecasting loan probability):
+
+```python
+import pandas as pd
+from datfid import DATFIDClient
+
+# Initialize the client with your DATFID token
+client = DATFIDClient(token="your_DATFID_token")
+
+# Load dataset for model fitting
+url_fit = "https://raw.githubusercontent.com/datfid-valeriidashuk/sample-datasets/main/Banking_extended.xlsx"
+df = pd.read_excel(url_fit)
+
+# Fit the model
+result = client.fit_model(df=df,
+                          id_col="Individual",
+                          time_col="Time",
+                          y="Loan Probability",
+                          lag_y="1:3",
+                          lagged_features={"Income Level": "1:3"},
+                          filter_by_significance=True)
+
+# Load dataset for forecasting
+url_forecast = "https://raw.githubusercontent.com/datfid-valeriidashuk/sample-datasets/main/Banking_extended_forecast.xlsx"
+df_forecast = pd.read_excel(url_forecast)
+
+# Forecast loan probability using the fitted model
+forecast = client.forecast_model(df_forecast=df_forecast)
+```
+
+## API Reference
+
+### DATFIDClient
+
+#### `client = DATFIDClient(token: str)`
+Initialize the client with your DATFID token.
+
+#### `client.fit_model(df: pd.DataFrame, id_col: str, time_col: str, y: str, lag_y: Optional[Union[int, str, list[int]]] = None, lagged_features: Optional[Dict[str, int]] = None, current_features: Optional[list] = None, filter_by_significance: bool = False, meanvar_test: bool = False) -> SimpleNamespace`
+Fit a model using the provided dataset.
+
+#### `client.forecast_model(df_forecast: pd.DataFrame) -> pd.DataFrame`
+Generate forecasts using the fitted model.

datfid-0.1.21/datfid/__init__.py

@@ -0,0 +1 @@
+from .client import DATFIDClient

datfid-0.1.21/datfid/client.py

@@ -0,0 +1,320 @@
+import requests
+import pandas as pd
+from typing import Dict, Any, Optional, Union
+import json
+from types import SimpleNamespace
+import tempfile
+import os
+import gc
+import psutil
+import logging
+
+# for nice output
+class FitResult(SimpleNamespace):
+    _ROW4  = ["Estimate", "Standard Error", "T statistic", "P value"]
+    _PERF5 = ["R2 within", "R2 between", "R2 overall", "MSE", "MAE"]
+    
+    @property
+    def id(self):
+        import pandas as pd
+        if hasattr(self, "df") and isinstance(self.df, pd.DataFrame) and "ID" in self.df.columns:
+            return pd.DataFrame(self.df["ID"].astype(str).unique())
+        return pd.DataFrame([])
+    
+    @property
+    def ID(self):
+        import pandas as pd
+        if hasattr(self, "df") and isinstance(self.df, pd.DataFrame) and "ID" in self.df.columns:
+            return pd.DataFrame(self.df["ID"].astype(str).unique())
+        return pd.DataFrame([])
+    
+    @property
+    def Id(self):
+        import pandas as pd
+        if hasattr(self, "df") and isinstance(self.df, pd.DataFrame) and "ID" in self.df.columns:
+            return pd.DataFrame(self.df["ID"].astype(str).unique())
+        return pd.DataFrame([])
+
+    @staticmethod
+    def _df4(rows_list):
+        if not isinstance(rows_list, list):
+            return rows_list
+        return pd.DataFrame(rows_list, index=FitResult._ROW4[:len(rows_list)])
+
+    @staticmethod
+    def _df_perf(rows_list):
+        if not isinstance(rows_list, list):
+            return rows_list
+        return pd.DataFrame(rows_list, index=FitResult._PERF5[:len(rows_list)])
+
+    def __init__(self, **kwargs):
+        # Convert list→DataFrame for table-like fields
+        if "alpha" in kwargs:
+            kwargs["alpha"] = self._df4(kwargs["alpha"])
+        if "beta" in kwargs:
+            kwargs["beta"] = self._df4(kwargs["beta"])
+        if "Performance" in kwargs:
+            kwargs["Performance"] = self._df_perf(kwargs["Performance"])
+        if "df" in kwargs and isinstance(kwargs["df"], list):
+            kwargs["df"] = pd.DataFrame(kwargs["df"])
+        super().__init__(**kwargs)
+
+class FitResultDict(dict):
+    @property
+    def id(self):
+        return pd.DataFrame({"ID": list(self.keys())})
+    
+    @property
+    def ID(self):
+        return pd.DataFrame({"ID": list(self.keys())})
+    
+    @property
+    def Id(self):
+        return pd.DataFrame({"ID": list(self.keys())})
+
+
+class DATFIDClient:
+    def __init__(self, token: str):
+        self.api_url = "https://datfid-org-datfid-master.hf.space/"
+        self.headers = {"Authorization": f"Bearer {token}"}
+        self.logger = logging.getLogger(__name__)
+
+    def _cleanup_memory(self):
+        """Clean up memory after operations"""
+        gc.collect()
+        if hasattr(psutil, 'Process'):
+            process = psutil.Process()
+            try:
+                process.memory_info().rss  # Force memory info update
+            except:
+                pass
+
+    def ping(self):
+        try:
+            response = requests.get(self.api_url, headers=self.headers).json()
+            self._cleanup_memory()
+            return response
+        except Exception as e:
+            self.logger.error(f"Ping failed: {str(e)}")
+            raise
+
+    def secure_ping(self):
+        try:
+            response = requests.get(f"{self.api_url}secure-ping/", headers=self.headers).json()
+            self._cleanup_memory()
+            return response
+        except Exception as e:
+            self.logger.error(f"Secure ping failed: {str(e)}")
+            raise
+
+    def fit_model(
+        self,
+        df: pd.DataFrame,
+        id_col: str,
+        time_col: str,
+        y: str,
+        lag_y: Optional[Union[int, str, list[int]]] = None,
+        lagged_features: Optional[Dict[str, int]] = None,
+        current_features: Optional[list] = None,
+        filter_by_significance: bool = False,
+        meanvar_test: bool = False,
+        signif: float = 0.05
+    ) -> FitResult:
+        """
+        Fit a model using the DATFID API.
+        
+        Args:
+            df: DataFrame containing the data
+            id_col: Name of the ID column
+            time_col: Name of the time column
+            y: Name of the target variable
+            lagged_features: Dictionary of features and their lag values
+            current_features: List of current features to use
+            filter_by_significance: Whether to filter features by significance
+            meanvar_test: Whether to perform mean-variance test
+            signif: Significance level (default 0.05), used when filter_by_significance is True
+            
+        Returns:
+            SimpleNamespace containing the model fit results
+        """
+
+        df = df.copy()
+        for col in df.columns:
+            if pd.api.types.is_datetime64_any_dtype(df[col]):
+                df[col] = df[col].astype(str)
+
+        data = {
+            "df": df.to_dict(orient="records"),
+            "id_col": id_col,
+            "time_col": time_col,
+            "y": y,
+            "lag_y": lag_y,
+            "lagged_features": lagged_features or {},
+            "current_features": current_features or [],
+            "filter_by_significance": filter_by_significance,
+            "meanvar_test": meanvar_test,
+            "signif": signif
+        }
+        
+        response = requests.post(
+            f"{self.api_url}modelfit/",
+            json=data,
+            headers=self.headers
+        )
+        
+        if response.status_code != 200:
+            raise Exception(f"Model fit failed: {response.text}")
+            
+        result_dict = response.json()
+        return FitResult(**result_dict)
+    
+    def forecast_model(
+        self,
+        df_forecast: pd.DataFrame
+    ) -> pd.DataFrame:
+        """
+        Generate forecasts using the fitted model.
+        
+        Args:
+            df_forecast: DataFrame containing the forecast data
+            
+        Returns:
+            DataFrame containing the forecast results
+        """
+
+        try:
+            df_forecast = df_forecast.copy()
+            for col in df_forecast.columns:
+                if pd.api.types.is_datetime64_any_dtype(df_forecast[col]):
+                    df_forecast[col] = df_forecast[col].astype(str)
+
+            # Convert DataFrame to list of records
+            data = df_forecast.to_dict(orient="records")
+            
+            response = requests.post(
+                f"{self.api_url}modelforecast/",
+                json=data,
+                headers=self.headers
+            )
+            
+            if response.status_code != 200:
+                raise Exception(f"Forecast generation failed: {response.text}")
+            
+            result = pd.DataFrame(response.json())
+            
+            # Clean up memory after operation
+            del df_forecast
+            del data
+            self._cleanup_memory()
+            
+            return result
+        except Exception as e:
+            self.logger.error(f"Forecast generation failed: {str(e)}")
+            raise
+
+    def fit_model_ind(
+        self,
+        df: pd.DataFrame,
+        id_col: str,
+        time_col: str,
+        y: str,
+        lag_y: Optional[Union[int, str, list[int]]] = None,
+        lagged_features: Optional[Dict[str, int]] = None,
+        current_features: Optional[list] = None,
+        filter_by_significance: bool = False,
+        meanvar_test: bool = False,
+        signif: float = 0.05
+    ) -> FitResultDict:
+        """
+        Fit a model individual by individual using the DATFID API.
+        
+        Args:
+            df: DataFrame containing the data
+            id_col: Name of the ID column
+            time_col: Name of the time column
+            y: Name of the target variable
+            lagged_features: Dictionary of features and their lag values
+            current_features: List of current features to use
+            filter_by_significance: Whether to filter features by significance
+            meanvar_test: Whether to perform mean-variance test
+            signif: Significance level (default 0.05), used when filter_by_significance is True
+            
+        Returns:
+            SimpleNamespace containing the model fit results
+        """
+
+        df = df.copy()
+        for col in df.columns:
+            if pd.api.types.is_datetime64_any_dtype(df[col]):
+                df[col] = df[col].astype(str)
+
+        data = {
+            "df": df.to_dict(orient="records"),
+            "id_col": id_col,
+            "time_col": time_col,
+            "y": y,
+            "lag_y": lag_y,
+            "lagged_features": lagged_features or {},
+            "current_features": current_features or [],
+            "filter_by_significance": filter_by_significance,
+            "meanvar_test": meanvar_test,
+            "signif": signif
+        }
+        
+        response = requests.post(
+            f"{self.api_url}modelfit_ind/",
+            json=data,
+            headers=self.headers
+        )
+        
+        if response.status_code != 200:
+            raise Exception(f"Model fit failed: {response.text}")
+            
+        raw = response.json() 
+        # Wrap each per-id result into a SimpleNamespace for dot access:
+        result_per_id = FitResultDict({str(k): FitResult(**v) for k, v in raw.items()})
+        return result_per_id  # FitResultDict[str, SimpleNamespace]
+
+    def forecast_model_ind(
+        self,
+        df_forecast: pd.DataFrame
+    ) -> pd.DataFrame:
+        """
+        Generate forecasts using the fitted individual by individual model.
+        
+        Args:
+            df_forecast: DataFrame containing the forecast data
+            
+        Returns:
+            DataFrame containing the forecast results
+        """
+
+        try:
+            df_forecast = df_forecast.copy()
+            for col in df_forecast.columns:
+                if pd.api.types.is_datetime64_any_dtype(df_forecast[col]):
+                    df_forecast[col] = df_forecast[col].astype(str)
+
+            # Convert DataFrame to list of records
+            data = df_forecast.to_dict(orient="records")
+            
+            response = requests.post(
+                f"{self.api_url}modelforecast_ind/",
+                json=data,
+                headers=self.headers
+            )
+            
+            if response.status_code != 200:
+                raise Exception(f"Forecast generation failed: {response.text}")
+            
+            result = pd.DataFrame(response.json())
+            
+            # Clean up memory after operation
+            del df_forecast
+            del data
+            self._cleanup_memory()
+            
+            return result
+        except Exception as e:
+            self.logger.error(f"Forecast generation failed: {str(e)}")
+            raise

datfid-0.1.21/datfid.egg-info/PKG-INFO

@@ -0,0 +1,155 @@
+Metadata-Version: 2.4
+Name: datfid
+Version: 0.1.21
+Summary: SDK to access the DATFID API hosted on Hugging Face Spaces
+Author: DATFID
+Author-email: igor.schapiro@datfid.com
+License: MIT
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Programming Language :: Python :: 3
+Requires-Python: >=3.7
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: requests>=2.31.0
+Requires-Dist: pandas>=1.0.1
+Requires-Dist: numpy<2.1,>=1.22
+Dynamic: author
+Dynamic: author-email
+Dynamic: classifier
+Dynamic: description
+Dynamic: description-content-type
+Dynamic: license
+Dynamic: license-file
+Dynamic: requires-dist
+Dynamic: requires-python
+Dynamic: summary
+
+# DATFID SDK
+
+A Python SDK to access the DATFID API to forecast your data.
+
+## Features
+
+- **Easy model fitting**: Build panel data models with time-dependent and static features.
+- **Flexible lag handling**: Specify lags for the dependent variable and selected features.
+- **Forecasting**: Generate future predictions with aligned timestamps and IDs.
+- **Statistical options**: Filter features by significance and apply mean-variance tests.
+- **White box full interpretability**: Get fully interpretable model with equation, estimated parameters, and standard errors.
+
+## Installation
+
+```bash
+pip install datfid
+```
+
+## Usage
+
+Before using the SDK, please request an access token by emailing **admin@datfid.com** or by visiting our website [datfid.com](https://datfid.com).
+
+```python
+from datfid import DATFIDClient
+
+# Initialize the client with your DATFID token
+client = DATFIDClient(token="your_DATFID_token")
+
+# Fit a model
+fit_result = client.fit_model(
+    df=dataframe,
+    id_col="name of id column",
+    time_col="name of time column",
+    y="name of dependent variable",
+    lag_y="starting lag : ending lag",
+    lagged_features={
+        "feature 1": "starting lag : ending lag",
+        "feature 2": "starting lag : ending lag"
+    },
+    current_features=["feature 3", "feature 4"],
+    filter_by_significance=True/False,
+    meanvar_test=True/False
+)
+
+# Generate forecasts
+forecast_df = client.forecast_model(
+    df_forecast=dataframe
+)
+
+# The forecast DataFrame contains the individual IDs and timestamps
+# from the original data plus a "forecast" column with predicted values.
+```
+
+## Example 1
+
+Sample dataset from GitHub (Food and Beverages demand forecasting):
+
+```python
+import pandas as pd
+from datfid import DATFIDClient
+
+# Initialize the client with your DATFID token
+client = DATFIDClient(token="your_DATFID_token")
+
+# Load dataset for model fitting
+url_fit = "https://raw.githubusercontent.com/datfid-valeriidashuk/sample-datasets/main/Food_Beverages.xlsx"
+df = pd.read_excel(url_fit)
+
+# Fit the model
+result = client.fit_model(df=df,
+                          id_col="Product",
+                          time_col="Time",
+                          y="Revenue",
+                          current_features='all',
+                          filter_by_significance=True
+                          )
+
+# Load dataset for forecasting
+url_forecast = "https://raw.githubusercontent.com/datfid-valeriidashuk/sample-datasets/main/Food_Beverages_forecast.xlsx"
+df_forecast = pd.read_excel(url_forecast)
+
+# Forecast revenue using the fitted model
+forecast = client.forecast_model(df_forecast=df_forecast)
+```
+
+## Example 2
+
+Slightly larger sample dataset from GitHub (Banking sector, forecasting loan probability):
+
+```python
+import pandas as pd
+from datfid import DATFIDClient
+
+# Initialize the client with your DATFID token
+client = DATFIDClient(token="your_DATFID_token")
+
+# Load dataset for model fitting
+url_fit = "https://raw.githubusercontent.com/datfid-valeriidashuk/sample-datasets/main/Banking_extended.xlsx"
+df = pd.read_excel(url_fit)
+
+# Fit the model
+result = client.fit_model(df=df,
+                          id_col="Individual",
+                          time_col="Time",
+                          y="Loan Probability",
+                          lag_y="1:3",
+                          lagged_features={"Income Level": "1:3"},
+                          filter_by_significance=True)
+
+# Load dataset for forecasting
+url_forecast = "https://raw.githubusercontent.com/datfid-valeriidashuk/sample-datasets/main/Banking_extended_forecast.xlsx"
+df_forecast = pd.read_excel(url_forecast)
+
+# Forecast loan probability using the fitted model
+forecast = client.forecast_model(df_forecast=df_forecast)
+```
+
+## API Reference
+
+### DATFIDClient
+
+#### `client = DATFIDClient(token: str)`
+Initialize the client with your DATFID token.
+
+#### `client.fit_model(df: pd.DataFrame, id_col: str, time_col: str, y: str, lag_y: Optional[Union[int, str, list[int]]] = None, lagged_features: Optional[Dict[str, int]] = None, current_features: Optional[list] = None, filter_by_significance: bool = False, meanvar_test: bool = False) -> SimpleNamespace`
+Fit a model using the provided dataset.
+
+#### `client.forecast_model(df_forecast: pd.DataFrame) -> pd.DataFrame`
+Generate forecasts using the fitted model.

datfid-0.1.21/datfid.egg-info/SOURCES.txt

@@ -0,0 +1,10 @@
+LICENSE
+README.md
+setup.py
+datfid/__init__.py
+datfid/client.py
+datfid.egg-info/PKG-INFO
+datfid.egg-info/SOURCES.txt
+datfid.egg-info/dependency_links.txt
+datfid.egg-info/requires.txt
+datfid.egg-info/top_level.txt

datfid-0.1.21/datfid.egg-info/dependency_links.txt

@@ -0,0 +1 @@
+

datfid-0.1.21/datfid.egg-info/requires.txt

@@ -0,0 +1,3 @@
+requests>=2.31.0
+pandas>=1.0.1
+numpy<2.1,>=1.22

datfid-0.1.21/datfid.egg-info/top_level.txt

@@ -0,0 +1 @@
+datfid

datfid-0.1.21/setup.cfg

@@ -0,0 +1,4 @@
+[egg_info]
+tag_build = 
+tag_date = 0
+

datfid-0.1.21/setup.py

@@ -0,0 +1,38 @@
+from setuptools import setup, find_packages
+
+# to build:
+# 1) open this file at level of datfid-sdk folder
+# 2) change version in this file and save it
+# 3) delete folder datfid.egg-info
+# 4) delete older files from dist folder
+# 5) in terminal: python setup.py sdist bdist_wheel
+# 6) in terminal: twine upload --repository pypi dist/*
+# 7) in hugging face delete older files from dist folder
+# 8) in hugging face upload updated files
+# 9) in terminal uninstall older version of datfid: pip uninstall datfid
+# 10) in terminal install new version of datfid: pip install --index-url https://test.pypi.org/simple/ datfid
+
+with open("README.md", "r", encoding="utf-8") as fh:
+    long_description = fh.read()
+
+setup(
+    name="datfid",
+    version="0.1.21",
+    description="SDK to access the DATFID API hosted on Hugging Face Spaces",
+    long_description=long_description,
+    long_description_content_type="text/markdown",  # Important!
+    author="DATFID",
+    author_email="igor.schapiro@datfid.com",
+    license="MIT",
+    packages=find_packages(),
+    install_requires=[
+        "requests>=2.31.0",
+        "pandas>=1.0.1",
+        "numpy>=1.22, <2.1"
+    ],
+    python_requires=">=3.7",
+    classifiers=[
+        "License :: OSI Approved :: MIT License",
+        "Programming Language :: Python :: 3",
+    ],
+)