michaelaye / pyciss

Python utilities to work with Cassini's ISS camera system

pyciss

Python utilities to work with Cassini's ISS camera system

Fair use

If you use this software, please consider citing it:

Bibtex record:

@misc{k_michael_aye_2016_53092,
  author       = {K.-Michael Aye},
  title        = {pyciss},
  version      = {0.5.0},
  publisher    = {Zenodo},
  month        = may,
  year         = 2016,
  doi          = {10.5281/zenodo.53092},
  url          = {http://dx.doi.org/10.5281/zenodo.53092}
}

Homepage

https://github.com/michaelaye/pyciss

Examples

See notebooks in pyciss/tests/ for usage examples.

Installation

Several possibilities:

pypi

pip install pyciss

github

• git clone https://github.com/michaelaye/pyciss.git (without SSH keys)
• git clone [email protected]:michaelaye/pyciss.git (with SSH keys)

followed by: cd pyciss && pip install .

Acknowledgements

• Miodrac Sremcevic for introducing me into some of the tricks of Saturn ring image analysis with Cassini ISS data and for producing a very nice resonance data file for the Saturn rings, here is one of his publications about it:

• Sremčević, M., Stewart, G.R., Albers, N., Colwell, J.E., Esposito, L.W., 2008. Density Waves in Saturn's Rings: Non-linear Dispersion and Moon Libration Effects. American Astronomical Society 40, 24.03–.

• Morgan Rehnberg for providing me with Miodrag's data file and answering some of my newbie questions.
• James Huffman, John Cutler, and Matt Funk for improving the software

pyciss's Issues

Point out in image title that LOSSY was compression if so.

As title says.

download_preview URLS return 404

e.g.

https://pds-rings.seti.org/holdings/browse/COISS_2xxx/COISS_2100/data/1829042482_1829225208/N1829224671_1_med.jpg

which I calculated based on previous OPUS API instructions. Needs update?

Add missing docstrings to pipeline.py

pipeline itself needs docstring
calib_to_isis function
remapping function
calibrate_many function
remove_mean_value function
pipeline function

check install dependencies

Are all requirements in requirements.txt and in setup.py really required?

Add missing docstrings to ringcube.py

RingCube class requires dostring

get_opus_meta_data function
imshow function
set_resonance_axis function
imshow_subtracted function

Add missing docstrings to opusapi.py

docstrings needed for:

get_img_url function
get_metadata function
create_files_request function
create_images_request function
unpack_json_response function
get_radial_res_query function
get_time_query function
get_between_resolutions function
get_dataframe_from_meta_dic function
OPUSImageURL class requires parameter in docstring
OPUS class requires parameter in docstring
init functions

fix test runs in travis config file

the travis yaml file needs to be updated to specify to run only notebooks.

So the call would be:

py.test -v *.ipynb

fix travis build error

see link to most recent build from README.rst.

Add missing docstrings for plotting.py

plotting.py requires docstring
lookup_rcparam function
myimshow function
myinteract function
imshowlowhigh function

Add missing docstrings to io.py

Need docstrings for:
get_config function
get_db_root function
init function

Implement ISIS alternative

To avoid having to install ISIS, implement an alternative that can deal with basic image loading and plotting without ISIS.

Replace urllib with request where appropriate

...

set_database_path should take a path object

and convert it to string before dumping to yaml

plot location of resonances potentially wrong

This could be constrained to the case of controlling the limits via the soliton location prediction.
Code is in plotting.py

Modules to check for Matt

Please check for docstrings and create issues for missing docstrings, as discussed:

downloader.py
indexfiles.py
io.py
meta.py

Add missing docstrings in indexfiles.py

Need docstrings for:
PVLColumn class
TableLabel class
index_to_def function
IndexBD class

Modules to check for John

Please check for docstrings and create issues for missing docstrings, as discussed:

opusapi.py
pipeline.py
plotting.py
ringcube.py

PathManager: version is 0 when data not there yet

When the PathManager is used as the input for downloader.download_and_calibrate() then, at the first time, the version attribute is set to 0, because the file wasn't downloaded yet to know it better.

Need to implement a way, maybe simply call set_version() on the PathManager object, after downloading, so that version attribute gets updated.
Otherwise, the calibration fails, receiving this incomplete PathManager object.

equalize_hist cannot deal with NaNs

nuff said.

Does dbroot setup work for everyone?

Currently the io/dbroot variable (the place where all downloaded data is automatically saved) points to /Volumes/Data/etc for me, b/c I set it there, but not everybody has that path.

I'm already using a config file to control this, but does it work for everyone?

To check, please check like so:

from pyciss import io
print(io.dbroot)

and let me know the values.

fix the hardcoded indexfile db path

This needs to be put into the configfile like the image database.

Adding @jamesHuffman for watching this issue (but i will fix it)

why does download_previews() store jpg on Windows but not on Mac

WTF?

Change ISS reference to open access reference

What he said.

Add missing docstrings to meta.py

Need docstrings for:
get_meta_df function
get_order function
get_resonances function
get_prime_resonances function
get_janus_epimetheus_resonances function
get_prime_jan_epi function
get_all_resonances function