Datetimes

Classes

Datetime(year[, month, day, hour, minute, …]) Proxy Datetime object, similar to Python’s datetime.
Timedelta([weeks, days, hours, minutes, …])
class Datetime(year, month=1, day=1, hour=0, minute=0, second=0, microsecond=0)[source]

Proxy Datetime object, similar to Python’s datetime.

Note: Datetimes are always in UTC.

Construct a Datetime from a components. All parts are optional besides year.

Methods

compute([geoctx, timeout, block, …]) Compute this proxy object and wait for its result.
from_string(string)
from_timestamp(seconds)
publish([name, description, client]) Publish this proxy object as a Workflow.

Attributes

day 1 <= day <= number of days in the given month and year
hour 0 <= hour < 24
microsecond 0 <= microsecond < 1000000
minute 0 <= minute < 60
month 1 <= month <= 12
second 0 <= second < 60
year Int
compute(geoctx=None, timeout=None, block=True, progress_bar=None, channel=None, client=None, **params)

Compute this proxy object and wait for its result.

Parameters:
  • geoctx (scenes.geocontext.GeoContext, GeoContext, or None) – The GeoContext parameter under which to run the computation. Almost all computations will require a GeoContext, but for operations that only involve non-geospatial types, this parameter is optional.
  • timeout (int, optional) – The number of seconds to wait for the result, if block is True. Raises TimeoutError if the timeout passes.
  • block (bool, default True) – If True (default), block until the job is completed, or timeout has passed. If False, immediately returns a Job (which has already had execute called).
  • progress_bar (bool, default None) – Whether to draw the progress bar. If None (default), will display a progress bar in Jupyter Notebooks, but not elsewhere. Ignored if block==False.
  • channel (str or None, optional) –

    Channel name to submit the Job to. If None, uses the default channel for this client (descarteslabs.workflows.__channel__).

    Channels are different versions of the backend, to allow for feature changes without breaking existing code. Not all clients are compatible with all channels. This client is only guaranteed to work with its default channel, whose name can be found under descarteslabs.workflows.__channel__.

  • client (workflows.client.Client, optional) – Allows you to use a specific client instance with non-default auth and parameters
  • **params (Proxytype) – Parameters under which to run the computation.
Returns:

Appropriate Python object representing the result, either as a plain Python type, or object from descarteslabs.common.workflows.containers.

Return type:

result

classmethod from_string(string)[source]
classmethod from_timestamp(seconds)[source]
publish(name='', description='', client=None)

Publish this proxy object as a Workflow.

Parameters:
  • name (str, default "") – Name for the new Workflow
  • description (str, default "") – Long-form description of this Workflow. Markdown is supported.
  • client (workflows.client.Client, optional) – Allows you to use a specific client instance with non-default auth and parameters
Returns:

workflow – The saved Workflow object. workflow.id contains the ID of the new Workflow.

Return type:

Workflow

day

1 <= day <= number of days in the given month and year

Type:Int
hour

0 <= hour < 24

Type:Int
microsecond

0 <= microsecond < 1000000

Type:Int
minute

0 <= minute < 60

Type:Int
month

1 <= month <= 12

Type:Int
second

0 <= second < 60

Type:Int
year

Int

class Timedelta(weeks=0, days=0, hours=0, minutes=0, seconds=0, microseconds=0, milliseconds=0)[source]

Methods

compute([geoctx, timeout, block, …]) Compute this proxy object and wait for its result.
publish([name, description, client]) Publish this proxy object as a Workflow.
total_seconds()

Attributes

days Int
microseconds Int
seconds Int
compute(geoctx=None, timeout=None, block=True, progress_bar=None, channel=None, client=None, **params)

Compute this proxy object and wait for its result.

Parameters:
  • geoctx (scenes.geocontext.GeoContext, GeoContext, or None) – The GeoContext parameter under which to run the computation. Almost all computations will require a GeoContext, but for operations that only involve non-geospatial types, this parameter is optional.
  • timeout (int, optional) – The number of seconds to wait for the result, if block is True. Raises TimeoutError if the timeout passes.
  • block (bool, default True) – If True (default), block until the job is completed, or timeout has passed. If False, immediately returns a Job (which has already had execute called).
  • progress_bar (bool, default None) – Whether to draw the progress bar. If None (default), will display a progress bar in Jupyter Notebooks, but not elsewhere. Ignored if block==False.
  • channel (str or None, optional) –

    Channel name to submit the Job to. If None, uses the default channel for this client (descarteslabs.workflows.__channel__).

    Channels are different versions of the backend, to allow for feature changes without breaking existing code. Not all clients are compatible with all channels. This client is only guaranteed to work with its default channel, whose name can be found under descarteslabs.workflows.__channel__.

  • client (workflows.client.Client, optional) – Allows you to use a specific client instance with non-default auth and parameters
  • **params (Proxytype) – Parameters under which to run the computation.
Returns:

Appropriate Python object representing the result, either as a plain Python type, or object from descarteslabs.common.workflows.containers.

Return type:

result

publish(name='', description='', client=None)

Publish this proxy object as a Workflow.

Parameters:
  • name (str, default "") – Name for the new Workflow
  • description (str, default "") – Long-form description of this Workflow. Markdown is supported.
  • client (workflows.client.Client, optional) – Allows you to use a specific client instance with non-default auth and parameters
Returns:

workflow – The saved Workflow object. workflow.id contains the ID of the new Workflow.

Return type:

Workflow

total_seconds()[source]
days

Int

microseconds

Int

seconds

Int