geobox 2.1.0__py3-none-any.whl → 2.2.1__py3-none-any.whl

geobox/api.py

@@ -420,6 +420,20 @@ class GeoboxClient:
         return self._make_request(HttpMethods.DELETE, endpoint, payload, is_json)
 
 
+    @property
+    def raster_analysis(self):
+        from .raster_analysis import RasterAnalysis
+
+        return RasterAnalysis(self)
+
+
+    @property
+    def vector_tool(self):
+        from .vector_tool import VectorTool
+
+        return VectorTool(self)
+
+
     def get_vectors(self, **kwargs) -> Union[List['VectorLayer'], int]:
         """
         Get a list of vector layers with optional filtering and pagination.
@@ -2621,101 +2635,3 @@ class GeoboxClient:
             >>> client.update_usage()
         """
         return Usage.update_usage(self, user_id=user_id)
-
-
-    def raster_calculator(self,
-        variables: str,
-        expr: str,
-        output_raster_name: str,
-        match_raster_uuid: Optional[str] = None,
-        resample: AnalysisResampleMethod = AnalysisResampleMethod.bilinear,
-        out_dtype: AnalysisDataType = AnalysisDataType.float32,
-        dst_nodata: int = -9999,
-        user_id: Optional[int] = None) -> 'Task':
-        """
-        Perform raster calculator operations on multiple raster datasets.
-
-        it allows you to perform mathematical operations on one or more raster datasets using NumPy expressions. 
-        Variables in the expression correspond to raster datasets specified in the variables dictionary.
-
-        Examples:
-            NDVI calculation: variables='{"NIR": "raster_uuid_1", "RED": "raster_uuid_2"}', expr="(NIR-RED)/(NIR+RED)"
-            Slope threshold: variables='{"SLOPE": "raster_uuid_1"}', expr="np.where(SLOPE>30,1,0)"
-            Multi-band operations: variables='{"IMG": ["raster_uuid_1", 2]}', expr="IMG*2"
-
-        Args:
-            variables (str): JSON string mapping variable names to raster specifications. Format: '{"NIR": "raster_uuid_1", "RED": "raster_uuid_2"}' or '{"IMG": ["raster_uuid_1", 2]}' for multi-band operations.
-            expr (str): Mathematical expression using NumPy syntax. Use variable names from the variables dict, e.g., '(NIR-RED)/(NIR+RED)' or 'where(SLOPE>30,1,0)' or 'where((dist_to_highway < 1000) & (slope < 10), 1, 0)' .Supported functions: np, sin, cos, tan, asin, acos, atan, sinh, cosh, tanh, exp, log, log10, sqrt, abs, floor, ceil, round, minimum, maximum, clip, where, isnan, isfinite, pi, e.
-            output_raster_name (str): Name for the output raster dataset.
-            match_raster_uuid (str, optional): Optional raster UUID to match the output grid and projection. If not provided, the first variable becomes the reference grid.
-            resample (CropResample, optional): Resampling method: 'near', 'bilinear', 'cubic', 'lanczos', etc. default: CropResample.near
-            out_dtype (AnalysisDataType, optional): Data type for the output raster (e.g., int16, float32). default: AnalysisDataType.float32
-            dst_nodata (int, optional): NoData value for the output raster. default = -9999
-            user_id (int, optional): specific user. priviledges required!
-
-        Returns:
-            Task: task instance of the process
-
-        Example:
-            >>> from geobox import GeoboxClient
-            >>> client = GeoboxClient()
-            >>> task = client.raster_calculator(api=client, variables={"NIR": "raster_uuid_1", "RED": "raster_uuid_2"},
-            ...     expr='where(SLOPE>30,1,0)',
-            ...     output_raster_name='test')
-        """
-        from .analysis import Analysis
-        return Analysis.calculator(self,
-            variables=variables,
-            expr=expr,
-            output_raster_name=output_raster_name,
-            match_raster_uuid=match_raster_uuid,
-            resample=resample,
-            out_dtype=out_dtype,
-            dst_nodata=dst_nodata,
-            user_id=user_id)
-
-
-
-    def create_constant_raster(self,
-        output_raster_name: str,
-        extent: str,
-        value : int,
-        pixel_size: int = 10,
-        dtype: AnalysisDataType = AnalysisDataType.float32,
-        nodata: int = -9999,
-        align_to: Optional[str] = None,
-        user_id: Optional[int] = None) -> 'Task':
-        """
-        Create a raster filled with a constant value.
-
-        This endpoint creates a north-up GeoTIFF filled with a constant value. 
-        Only users with Publisher role or higher can perform this operation.
-
-        Args:
-            output_raster_name (str): Name for the output constant raster dataset.
-            extent (str): Extent as 'minX,minY,maxX,maxY' (e.g., '0,0,100,100').
-            value (int): Constant value to fill the raster with.
-            pixel_size (int, optional): Pixel size for the output raster (must be > 0). default: 10
-            dtype (AnalysisDataType, optoinal): Output data type. default: AnalysisDataType.float32
-            nodata (int, optional): NoData value for the raster. default: -9999
-            align_to (str, optional): Grid origin to snap to as 'x0,y0' (e.g., '0,0').
-            user_id (int, optional): specific user. priviledges required!
-
-        Returns:
-            Task: task instance of the process
-
-        Example:
-            >>> from geobox import GeoboxClient
-            >>> client = GeoboxClient()
-            >>> task = client.create_constant_raster(output_raster_name='test', extent='0,0,100,100', value=10)
-        """
-        from .analysis import Analysis
-        return Analysis.constant(self,
-            output_raster_name=output_raster_name,
-            extent=extent,
-            value=value,
-            pixel_size=pixel_size,
-            dtype=dtype,
-            nodata=nodata,
-            align_to=align_to,
-            user_id=user_id)

geobox/apikey.py

@@ -1,263 +1,263 @@
-from typing import List, Dict, Optional, TYPE_CHECKING
-from urllib.parse import urljoin
-
-from .base import Base
-from .utils import clean_data
-
-if TYPE_CHECKING:
-    from . import GeoboxClient
-    from .aio import AsyncGeoboxClient
-    from .aio.apikey import ApiKey as AsyncApikey
-
-
-class ApiKey(Base):
-
-    BASE_ENDPOINT = 'apikeys/'
-
-    def __init__(self, 
-                 api: 'GeoboxClient', 
-                 key_id: int,
-                 data: Optional[Dict] = {}):
-        """
-        Initialize an apikey instance.
-
-        Args:
-            api (GeoboxClient): The GeoboxClient instance for making requests.
-            key_id (int): The unique identifier for the apikey.
-            data (Dict, optional): The data of the apikey.
-        """
-        super().__init__(api, data=data)
-        self.key_id = key_id
-        self.endpoint = urljoin(self.BASE_ENDPOINT, str(self.id))
-
-
-    def __repr__(self) -> str:
-        """
-        Return a string representation of the attachment.
-
-        Returns:
-            str: The string representation of the attachment.
-        """
-        return f'ApiKey(id={self.key_id}, name={self.name}, revoked={self.revoked})'
-
-
-    @classmethod
-    def get_apikeys(cls, api: 'GeoboxClient', **kwargs) -> List['ApiKey']:
-        """
-        Get a list of apikeys
-
-        Args:
-            api (GeoboxClient): The GeoboxClient instance for making requests.
-
-        Keyword Args:
-            search (str): search term for keyword-based searching among all textual fields.
-            order_by (str): comma separated list of fields for sorting results [field1 A|D, field2 A|D, …]. e.g. name A, type D. NOTE: "A" denotes ascending order and "D" denotes descending order.
-            skip (int): Number of layers to skip. default is 0.
-            limit (int): Maximum number of layers to return. default is 10.
-            user_id (int): Specific user. privileges required.
-        
-        Example:
-            >>> from geobox import GeoboxClient
-            >>> from geobox.apikey import ApiKey
-            >>> client = GeoboxClient()
-            >>> apikeys = ApiKey.get_apikeys(client)
-            or
-            >>> apikeys = client.get_apikeys()
-        """
-        params = {
-            'search': kwargs.get('search'),
-            'order_by': kwargs.get('order_by'),
-            'skip': kwargs.get('skip'),
-            'limit': kwargs.get('limit'),
-            'user_id': kwargs.get('user_id')
-        }
-        return super()._get_list(api, cls.BASE_ENDPOINT, params, factory_func=lambda api, item: ApiKey(api, item['id'], item))
-    
-
-    @classmethod
-    def create_apikey(cls, api: 'GeoboxClient', name: str, user_id: int = None) -> 'ApiKey':
-        """
-        Create an ApiKey
-
-        Args:
-            api (GeoboxClient): The GeoboxClient instance for making requests.
-            name (str): name of the key.
-            user_id (int, optional): Specific user. privileges required.
-
-        Returns: 
-            ApiKey: the apikey object
-
-        Example:
-            >>> from geobox import GeoboxClient
-            >>> from geobox.apikey import ApiKey
-            >>> client = GeoboxClient()
-            >>> apikey = ApiKey.create_apikey(client, name='test')
-            or 
-            >>> apikey = client.create_apikey(name='test')
-        """
-        data = clean_data({
-            'name': name,
-            'user_id': user_id
-        })
-        response = api.post(cls.BASE_ENDPOINT, payload=data, is_json=False)
-        return ApiKey(api, response['id'], response)
-    
-
-    @classmethod
-    def get_apikey(cls, api: 'GeoboxClient', key_id: int) -> 'ApiKey':
-        """
-        Get an ApiKey
-
-        Args:
-            api (GeoboxClient): The GeoboxClient instance for making requests.
-            key_id (str): the id of the apikey.
-
-        Returns:
-            ApiKey: the ApiKey object
-
-        Example:
-            >>> from geobox import GeoboxClient
-            >>> from geobox.apikey import ApiKey
-            >>> client = GeoboxClient()
-            >>> apikey = ApiKey.get_apikey(client, key_id=1)
-            or
-            >>> apikey = client.get_apikey(key_id=1) 
-        """
-        params = {
-            'f': 'json'
-        }
-        return super()._get_detail(api=api,
-                                   endpoint=cls.BASE_ENDPOINT,
-                                   uuid=key_id, 
-                                   params=params, 
-                                   factory_func=lambda api, item: ApiKey(api, item['id'], item))
-
-
-    @classmethod
-    def get_apikey_by_name(cls, api: 'GeoboxClient', name: str, user_id: int = None) -> 'ApiKey':
-        """
-        Get an ApiKey by name
-
-        Args:
-            api (GeoboxClient): The GeoboxClient instance for making requests.
-            name (str): the name of the key to get
-            user_id (int, optional): specific user. privileges required.
-
-        Returns:
-            ApiKey | None: returns the key if a key matches the given name, else None
-
-        Example:
-            >>> from geobox import GeoboxClient
-            >>> from geobox.apikey import ApiKey
-            >>> client = GeoboxClient()
-            >>> apikey = ApiKey.get_apikey_by_name(client, name='test')
-            or
-            >>> apikey = client.get_apikey_by_name(name='test')
-        """
-        apikeys = cls.get_apikeys(api, search=name, user_id=user_id)
-        if apikeys and apikeys[0].name == name:
-            return apikeys[0]
-        else:
-            return None
-    
-
-    def update(self, name: str, user_id: int = None) -> Dict:
-        """
-        Update an ApiKey
-
-        Args:
-            name (str): the name of the key
-            user_id (int, optional): Specific user. privileges required.
-
-        Returns:
-            Dict: Updated ApiKey data
-
-        Example:
-            >>> from geobox import GeoboxClient
-            >>> from geobox.apikey import ApiKey
-            >>> client = GeoboxClient()
-            >>> apikey = ApiKey.get_apikey(client, key_id=1)
-            >>> apikey.update(name="updated_name")
-        """
-        data = clean_data({
-            "name": name,
-            "user_id": user_id
-        })
-
-        response = self.api.put(self.endpoint, data, is_json=False)
-        self._update_properties(response)
-        return response
-
-
-    def delete(self) -> None:
-        """
-        Delete the ApiKey.
-
-        Returns:
-            None
-
-        Example:
-            >>> from geobox import GeoboxClient
-            >>> from geobox.apikey import ApiKey
-            >>> client = GeoboxClient()
-            >>> apikey = ApiKey.get_apikey(client, key_id=1)
-            >>> apikey.delete()
-        """
-        super().delete(self.endpoint)
-        self.key_id = None
-
-
-    def revoke(self) -> None:
-        """
-        Revoke an ApiKey
-
-        Example:
-            >>> from geobox import GeoboxClient
-            >>> from geobox.apikey import ApiKey
-            >>> client = GeoboxClient()
-            >>> apikey = ApiKey.get_apikey(client, key_id=1)
-            >>> apikey.revoke()
-        """
-        endpoint = f"{self.endpoint}/revoke"
-        self.api.post(endpoint)
-        self.data['revoked'] = True
-
-
-    def grant(self) -> None:
-        """
-        Grant an ApiKey
-
-        Example:
-            >>> from geobox import GeoboxClient
-            >>> from geobox.apikey import ApiKey
-            >>> client = GeoboxClient()
-            >>> apikey = ApiKey.get_apikey(client, key_id=1)
-            >>> apikey.grant()
-        """
-        endpoint = f"{self.endpoint}/grant"
-        self.api.post(endpoint)
-        self.data['revoked'] = False
-
-
-    def to_async(self, async_client: 'AsyncGeoboxClient') -> 'AsyncApikey':
-        """
-        Switch to async version of the apikey instance to have access to the async methods
-
-        Args:
-            async_client (AsyncGeoboxClient): The async version of the GeoboxClient instance for making requests.
-
-        Returns:
-            geobox.aio.apikey.Apikey: the async instance of the apikey.
-
-        Example:
-            >>> from geobox import Geoboxclient
-            >>> from geobox.aio import AsyncGeoboxClient
-            >>> from geobox.apikey import ApiKey
-            >>> client = GeoboxClient()
-            >>> apikey = ApiKey.get_apikey(client, key_id=1)
-            >>> async with AsyncGeoboxClient() as async_client:
-            >>>     async_apikey = apikey.to_async(async_client)
-        """
-        from .aio.apikey import ApiKey as AsyncApiKey
-
+from typing import List, Dict, Optional, TYPE_CHECKING
+from urllib.parse import urljoin
+
+from .base import Base
+from .utils import clean_data
+
+if TYPE_CHECKING:
+    from . import GeoboxClient
+    from .aio import AsyncGeoboxClient
+    from .aio.apikey import AsyncApiKey
+
+
+class ApiKey(Base):
+
+    BASE_ENDPOINT = 'apikeys/'
+
+    def __init__(self, 
+                 api: 'GeoboxClient', 
+                 key_id: int,
+                 data: Optional[Dict] = {}):
+        """
+        Initialize an apikey instance.
+
+        Args:
+            api (GeoboxClient): The GeoboxClient instance for making requests.
+            key_id (int): The unique identifier for the apikey.
+            data (Dict, optional): The data of the apikey.
+        """
+        super().__init__(api, data=data)
+        self.key_id = key_id
+        self.endpoint = urljoin(self.BASE_ENDPOINT, str(self.id))
+
+
+    def __repr__(self) -> str:
+        """
+        Return a string representation of the attachment.
+
+        Returns:
+            str: The string representation of the attachment.
+        """
+        return f'ApiKey(id={self.key_id}, name={self.name}, revoked={self.revoked})'
+
+
+    @classmethod
+    def get_apikeys(cls, api: 'GeoboxClient', **kwargs) -> List['ApiKey']:
+        """
+        Get a list of apikeys
+
+        Args:
+            api (GeoboxClient): The GeoboxClient instance for making requests.
+
+        Keyword Args:
+            search (str): search term for keyword-based searching among all textual fields.
+            order_by (str): comma separated list of fields for sorting results [field1 A|D, field2 A|D, …]. e.g. name A, type D. NOTE: "A" denotes ascending order and "D" denotes descending order.
+            skip (int): Number of layers to skip. default is 0.
+            limit (int): Maximum number of layers to return. default is 10.
+            user_id (int): Specific user. privileges required.
+        
+        Example:
+            >>> from geobox import GeoboxClient
+            >>> from geobox.apikey import ApiKey
+            >>> client = GeoboxClient()
+            >>> apikeys = ApiKey.get_apikeys(client)
+            or
+            >>> apikeys = client.get_apikeys()
+        """
+        params = {
+            'search': kwargs.get('search'),
+            'order_by': kwargs.get('order_by'),
+            'skip': kwargs.get('skip'),
+            'limit': kwargs.get('limit'),
+            'user_id': kwargs.get('user_id')
+        }
+        return super()._get_list(api, cls.BASE_ENDPOINT, params, factory_func=lambda api, item: ApiKey(api, item['id'], item))
+    
+
+    @classmethod
+    def create_apikey(cls, api: 'GeoboxClient', name: str, user_id: int = None) -> 'ApiKey':
+        """
+        Create an ApiKey
+
+        Args:
+            api (GeoboxClient): The GeoboxClient instance for making requests.
+            name (str): name of the key.
+            user_id (int, optional): Specific user. privileges required.
+
+        Returns: 
+            ApiKey: the apikey object
+
+        Example:
+            >>> from geobox import GeoboxClient
+            >>> from geobox.apikey import ApiKey
+            >>> client = GeoboxClient()
+            >>> apikey = ApiKey.create_apikey(client, name='test')
+            or 
+            >>> apikey = client.create_apikey(name='test')
+        """
+        data = clean_data({
+            'name': name,
+            'user_id': user_id
+        })
+        response = api.post(cls.BASE_ENDPOINT, payload=data, is_json=False)
+        return ApiKey(api, response['id'], response)
+    
+
+    @classmethod
+    def get_apikey(cls, api: 'GeoboxClient', key_id: int) -> 'ApiKey':
+        """
+        Get an ApiKey
+
+        Args:
+            api (GeoboxClient): The GeoboxClient instance for making requests.
+            key_id (str): the id of the apikey.
+
+        Returns:
+            ApiKey: the ApiKey object
+
+        Example:
+            >>> from geobox import GeoboxClient
+            >>> from geobox.apikey import ApiKey
+            >>> client = GeoboxClient()
+            >>> apikey = ApiKey.get_apikey(client, key_id=1)
+            or
+            >>> apikey = client.get_apikey(key_id=1) 
+        """
+        params = {
+            'f': 'json'
+        }
+        return super()._get_detail(api=api,
+                                   endpoint=cls.BASE_ENDPOINT,
+                                   uuid=key_id, 
+                                   params=params, 
+                                   factory_func=lambda api, item: ApiKey(api, item['id'], item))
+
+
+    @classmethod
+    def get_apikey_by_name(cls, api: 'GeoboxClient', name: str, user_id: int = None) -> 'ApiKey':
+        """
+        Get an ApiKey by name
+
+        Args:
+            api (GeoboxClient): The GeoboxClient instance for making requests.
+            name (str): the name of the key to get
+            user_id (int, optional): specific user. privileges required.
+
+        Returns:
+            ApiKey | None: returns the key if a key matches the given name, else None
+
+        Example:
+            >>> from geobox import GeoboxClient
+            >>> from geobox.apikey import ApiKey
+            >>> client = GeoboxClient()
+            >>> apikey = ApiKey.get_apikey_by_name(client, name='test')
+            or
+            >>> apikey = client.get_apikey_by_name(name='test')
+        """
+        apikeys = cls.get_apikeys(api, search=name, user_id=user_id)
+        if apikeys and apikeys[0].name == name:
+            return apikeys[0]
+        else:
+            return None
+    
+
+    def update(self, name: str, user_id: int = None) -> Dict:
+        """
+        Update an ApiKey
+
+        Args:
+            name (str): the name of the key
+            user_id (int, optional): Specific user. privileges required.
+
+        Returns:
+            Dict: Updated ApiKey data
+
+        Example:
+            >>> from geobox import GeoboxClient
+            >>> from geobox.apikey import ApiKey
+            >>> client = GeoboxClient()
+            >>> apikey = ApiKey.get_apikey(client, key_id=1)
+            >>> apikey.update(name="updated_name")
+        """
+        data = clean_data({
+            "name": name,
+            "user_id": user_id
+        })
+
+        response = self.api.put(self.endpoint, data, is_json=False)
+        self._update_properties(response)
+        return response
+
+
+    def delete(self) -> None:
+        """
+        Delete the ApiKey.
+
+        Returns:
+            None
+
+        Example:
+            >>> from geobox import GeoboxClient
+            >>> from geobox.apikey import ApiKey
+            >>> client = GeoboxClient()
+            >>> apikey = ApiKey.get_apikey(client, key_id=1)
+            >>> apikey.delete()
+        """
+        super()._delete(self.endpoint)
+        self.key_id = None
+
+
+    def revoke(self) -> None:
+        """
+        Revoke an ApiKey
+
+        Example:
+            >>> from geobox import GeoboxClient
+            >>> from geobox.apikey import ApiKey
+            >>> client = GeoboxClient()
+            >>> apikey = ApiKey.get_apikey(client, key_id=1)
+            >>> apikey.revoke()
+        """
+        endpoint = f"{self.endpoint}/revoke"
+        self.api.post(endpoint)
+        self.data['revoked'] = True
+
+
+    def grant(self) -> None:
+        """
+        Grant an ApiKey
+
+        Example:
+            >>> from geobox import GeoboxClient
+            >>> from geobox.apikey import ApiKey
+            >>> client = GeoboxClient()
+            >>> apikey = ApiKey.get_apikey(client, key_id=1)
+            >>> apikey.grant()
+        """
+        endpoint = f"{self.endpoint}/grant"
+        self.api.post(endpoint)
+        self.data['revoked'] = False
+
+
+    def to_async(self, async_client: 'AsyncGeoboxClient') -> 'AsyncApiKey':
+        """
+        Switch to async version of the apikey instance to have access to the async methods
+
+        Args:
+            async_client (AsyncGeoboxClient): The async version of the GeoboxClient instance for making requests.
+
+        Returns:
+            AsyncApiKey: the async instance of the apikey.
+
+        Example:
+            >>> from geobox import Geoboxclient
+            >>> from geobox.aio import AsyncGeoboxClient
+            >>> from geobox.apikey import ApiKey
+            >>> client = GeoboxClient()
+            >>> apikey = ApiKey.get_apikey(client, key_id=1)
+            >>> async with AsyncGeoboxClient() as async_client:
+            >>>     async_apikey = apikey.to_async(async_client)
+        """
+        from .aio.apikey import AsyncApiKey
+
         return AsyncApiKey(api=async_client, key_id=self.key_id, data=self.data)