merlin.chipmunk¶

Chipmunk.py is the interface module to Chipmunk for Merlin.

Any functions chipmunk exposes are represented here as defined.

New abstractions or higher level abstractions should be created in modules that import chipmunk.py. For maximum flexibility do not import chipmunk.py directly… inject it via a kernel or DI construct.

Multi-version support: To support multiple versions of Chipmunk create new modules that correspond to the appropriate version number.

merlin.chipmunk.chips(x, y, acquired, ubids, url, resource='/chips')[source]¶

Returns chips from a Chipmunk url given x, y, date range and ubid sequence

Parameters:	x (int) – projection coordinate x y (int) – projection coordinate y acquired (str) – ISO8601 daterange ‘2012-01-01/2014-01-03’ ubids (sequence) – sequence of ubids url (str) – protocol://host:port/path resource (str) – /chips/resource/path (default: /chips)
Returns:	chips
Return type:	tuple

Example

>>> chipmunk.chips(url='http://host:port/path',
                   x=123456,
                   y=789456,
                   acquired='2012-01-01/2014-01-03',
                   ubids=['LE07_SRB1', 'LT05_SRB1'])
(LE07_SRB1_DATE1, LT05_SRB1_DATE2, LE07_SRB1_DATE2, ...)

merlin.chipmunk.grid(url, resource='/grid')[source]¶

Return grid definitions.

Parameters:	url (str) – protocol://host:port/path resource (str) – /the/grid/resource (default: /grid)
Returns:	dict

Example

>>> chipmunk.grid(url='http://host:port/path)
[{"name":"tile",
  "proj":null,
  "rx":1.0,
  "ry":-1.0,
  "sx":150000.0,
  "sy":150000.0,
  "tx":2565585.0,
  "ty":3314805.0},
 {"name":"chip",
  "proj":null,
  "rx":1.0,
  "ry":-1.0,
  "sx":3000.0,
  "sy":3000.0,
  "tx":2565585.0,
  "ty":3314805.0}]

merlin.chipmunk.near(x, y, url, resource='/grid/near')[source]¶

Determines chips and tiles that lie a point

Parameters:	x (int) – projection coordinate x y (int) – projection coordinate y url (str) – protocol://host:port/path resource (str) – /grid/near/resource (default: /grid/near)
Returns:	dict

Example

>>> chipmunk.near(x=0, y=0, url='http://host:port/path')
{'chip': [{'grid-pt': [854.0, 1105.0], 'proj-pt': [-3585.0, -195.0]},
          {'grid-pt': [854.0, 1104.0], 'proj-pt': [-3585.0, 2805.0]},
          {'grid-pt': [854.0, 1103.0], 'proj-pt': [-3585.0, 5805.0]},
          {'grid-pt': [855.0, 1105.0], 'proj-pt': [-585.0, -195.0]},
          {'grid-pt': [855.0, 1104.0], 'proj-pt': [-585.0, 2805.0]},
          {'grid-pt': [855.0, 1103.0], 'proj-pt': [-585.0, 5805.0]},
          {'grid-pt': [856.0, 1105.0], 'proj-pt': [2415.0, -195.0]},
          {'grid-pt': [856.0, 1104.0], 'proj-pt': [2415.0, 2805.0]},
          {'grid-pt': [856.0, 1103.0], 'proj-pt': [2415.0, 5805.0]}],
 'tile': [{'grid-pt': [16.0, 23.0], 'proj-pt': [-165585.0, -135195.0]},
          {'grid-pt': [16.0, 22.0], 'proj-pt': [-165585.0, 14805.0]},
          {'grid-pt': [16.0, 21.0], 'proj-pt': [-165585.0, 164805.0]},
          {'grid-pt': [17.0, 23.0], 'proj-pt': [-15585.0, -135195.0]},
          {'grid-pt': [17.0, 22.0], 'proj-pt': [-15585.0, 14805.0]},
          {'grid-pt': [17.0, 21.0], 'proj-pt': [-15585.0, 164805.0]},
          {'grid-pt': [18.0, 23.0], 'proj-pt': [134415.0, -135195.0]},
          {'grid-pt': [18.0, 22.0], 'proj-pt': [134415.0, 14805.0]},
          {'grid-pt': [18.0, 21.0], 'proj-pt': [134415.0, 164805.0]}]}

merlin.chipmunk.registry(url, resource='/registry')[source]¶

Retrieve the chip spec registry

Parameters:	url (str) – protocol://host:port/path resource (str) – /registry/resource/path (default: /registry)
Returns:	list

Example

>>> chipmunk.registry(url='http://host:port/path')
 [{'data_fill': '-9999',
   'data_mask': {},
   'data_range': [],
   'data_scale': None,
   'data_shape': [100, 100],
   'data_type': 'INT16',
   'data_units': None,
   'info': 'band 5 top-of-atmosphere reflectance',
   'tags': ['swir1', 'b5', 'tab5', 'lt05', 'lt05_tab5', 'ta'],
   'ubid': 'LT05_TAB5'},
  {'data_fill': '-9999',
   'data_mask': {},
   'data_range': [],
   'data_scale': None,
   'data_shape': [100, 100],
   'data_type': 'INT16',
   'data_units': None,
   'info': 'band 7 top-of-atmosphere reflectance',
   'tags': ['lt05_tab7', 'b7', 'lt05', 'swir2', 'tab7', 'ta'],
   'ubid': 'LT05_TAB7'}, ...]

merlin.chipmunk.snap(x, y, url, resource='/grid/snap')[source]¶

Determine the chip and tile coordinates for a point.

Parameters:	x (int) – projection coordinate x y (int) – projection coordinate y url (str) – protocol://host:port/path resource (str) – /grid/snap/resource (default: /grid/snap)
Returns:	dict

Example

>>> chipmunk.snap(x=0, y=0, url='http://host:port/path')
 {'chip': {'grid-pt': [855.0, 1104.0], 'proj-pt': [-585.0, 2805.0]},
  'tile': {'grid-pt': [17.0, 22.0], 'proj-pt': [-15585.0, 14805.0]}}