semvec/pypi-packages huggingface dataset:
circ 0.0.1
A basic CLI to make mosaic vrts using ctx imagery
License: MIT
Keywords: mars,nasa,ode,pds,cli,tool,ctx,circ,mosaic,gdal

Circ
====

*Making just ok CTX mosaics since 2018*

Circ builds CTX mosaics by reading the CTX image metadata to select images that
intersect the bounding box the user provides, and then does some basic filtering and
stochastic image reduction to come up with a reasonably minimal list of images that cover the bbox
and have low-ish emission angles.

The images used come from ASU Mars Space Flight Facility viewer.mars.asu.edu.


Installation
------------

currently you must have gdal and wget installed and available in your PATH.
then download or clone the repo and then run `python setup.py install`


Usage
----- 

.. code:: bash

  Usage:       circ make-vrt MINX MINY MAXX MAXY [NAME] [EM_TOL] [DRY_RUN]
               circ make-vrt --minx MINX --miny MINY --maxx MAXX --maxy MAXY [--name NAME] [--em-tol EM_TOL] [--dry-run DRY_RUN]


Specify a minimum and maximum longitude (minx maxx) and a minimum and maximum latitude (miny maxy).
By default the maximum emission angle allowed is 5.0, but this can be reduced to lower values without
loosing much spatial coverage if any. Try using the `--dry-run` flag and different emission angle values to
observe how the count in images changes for your bbox.

So to make a ctx mosaic around Gale Crater, after installation simply run:

.. code:: bash

  circ make-vrt 136.0 -7.0 139.5 -3.5 --name gale --em_tol 1.0


This will create a folder called `gale` in which a bunch of ctx images will be downloaded. Also the emission angle tolerance has been lowered to 1.0 (less than or equal to)
The bbox passed in here is a bit larger than is truly needed, so some extra images will be downloaded.
If you are running this example it would be worth contracting it by a half to three quarters of a degree for each coordinate.

The VRT image created at the end can then be used directly in applications like QGIS or to construct a merged image (which would take less disk space) using other gdal command line tools like so:

.. code:: bash

  gdal_translate -co COMPRESS=JPEG -co TILED=YES -co COPY_SRC_OVERVIEWS=YES gale.vrt gale_jpeg.tif
  gdaladdo -r average --config COMPRESS_OVERVIEW JPEG --config JPEG_QUALITY_OVERVIEW 85 gale_jpeg.tif 2 4 8



To see that we actually saved space, here is the total space the gale folder takes:

.. code:: bash

  du -sh ./gale
  5.0G    ./gale


And this is the amount of space the final jpeg compressed tif version has:

.. code:: bash

  du -sh ./gale_jpeg.tif
  817M    ./gale


At this point you can delete the vrt and folder of tiffs to save disk space, and use other gdal commands to clip the mosaic to clip the mosaic to the bounding box.
BucketCache 0.12.1
Versatile persisent file cache.
License: MIT

BucketCache
-----------

|Build Status| |PyPI Version| |Python Version| |MIT License|

Installation
~~~~~~~~~~~~

.. code:: bash

    $ pip install bucketcache

Quick Overview
~~~~~~~~~~~~~~

In one sentence, ``Bucket`` is a container object with optional lifetime
backed by configurable serialisation methods that can also act as a
function or method decorator.

Before everything is explained in detail, here's a quick look at the
functionality:

Container:

.. code:: python

    from bucketcache import Bucket

    bucket = Bucket('cache', hours=1)

    bucket[any_object] = anything_serializable_by_backend  # (Pickle is the default)

Decorator:

.. code:: python

    class SomeService(object):
        def __init__(self, username, password):
            self.username = username
            self.password = password

        @bucket(method=True, nocache='skip_cache')
        def expensive_method(self, a, b, c, skip_cache=False):
            print('Method called.')

        @expensive_method.callback
        def expensive_method(callinfo):
            print('Cache used.')

    some_service = SomeService()
    some_service.expensive_method(1, 2, 3)
    some_service.expensive_method(1, 2, 3)
    some_service.expensive_method(1, 2, 3, skip_cache=True)

::

    Method called.
    Cache used.
    Method called

For in-depth information, `visit the
documentation <http://bucketcache.readthedocs.io/>`__!

.. |Build Status| image:: http://img.shields.io/travis/RazerM/bucketcache.svg?style=flat-square
   :target: https://travis-ci.org/RazerM/bucketcache
.. |PyPI Version| image:: http://img.shields.io/pypi/v/bucketcache.svg?style=flat-square
   :target: https://pypi.python.org/pypi/bucketcache/
.. |Python Version| image:: https://img.shields.io/badge/python-2.7%2C%203-brightgreen.svg?style=flat-square
   :target: https://www.python.org/downloads/
.. |MIT License| image:: http://img.shields.io/badge/license-MIT-blue.svg?style=flat-square
   :target: https://raw.githubusercontent.com/RazerM/bucketcache/master/LICENSE
yourls 1.2.3
Python client for YOURLS.
License: MIT

yourls
------

|PyPI Version| |Documentation| |Travis| |Coverage| |Python Version| |MIT License|

Installation
~~~~~~~~~~~~

.. code:: bash

    $ pip install yourls

Example
~~~~~~~

.. code:: python

   >>> from yourls import YOURLSClient

   >>> yourls = YOURLSClient('http://example.com/yourls-api.php', signature='6f344c2a8p')
   >>> yourls.shorten('http://google.com')
   ShortenedURL(
       shorturl='http://example.com/abcde',
       url='http://google.com',
       title='Google',
       date=datetime.datetime(2015, 10, 31, 14, 31, 4),
       ip='203.0.113.0',
       clicks=0,
       keyword='abcde')

Documentation
~~~~~~~~~~~~~

For in-depth information, `visit the
documentation <http://yourls-python.readthedocs.org/en/latest/>`__!

.. |Travis| image:: http://img.shields.io/travis/RazerM/yourls-python/master.svg?style=flat-square&label=travis
   :target: https://travis-ci.org/RazerM/yourls-python
.. |PyPI Version| image:: http://img.shields.io/pypi/v/yourls.svg?style=flat-square
   :target: https://pypi.python.org/pypi/yourls/
.. |Python Version| image:: https://img.shields.io/badge/python-2.7%2C%203-brightgreen.svg?style=flat-square
   :target: https://www.python.org/downloads/
.. |MIT License| image:: http://img.shields.io/badge/license-MIT-blue.svg?style=flat-square
   :target: https://raw.githubusercontent.com/RazerM/yourls-python/master/LICENSE
.. |Coverage| image:: https://img.shields.io/codecov/c/github/RazerM/yourls-python/master.svg?style=flat-square
   :target: https://codecov.io/github/RazerM/yourls-python?branch=master
.. |Documentation| image:: https://img.shields.io/badge/docs-latest-brightgreen.svg?style=flat-square
   :target: http://yourls-python.readthedocs.org/en/latest/