Release 2020.1

[jeanconn]

Release Notes

The 2020.1 skare3 release is significant in that it includes substantive changes to a few packages and includes setuptools_scm modernization of most of our Python modules.

Package Updates

acis_taco

• Allow specifying p_earth_body in call to calc_earth_vis acis_taco#13 Allow specifying p_earth_body in call to calc_earth_vis
  • This code was used to make the xija file in flight use, but an updated acis_taco was not installed at that time

agasc

• Add get_stars() function to get multiple ids / dates agasc#40 Add get_stars() function to get multiple ids / dates

annie

• https://github.com/sot/annie/pull/96 Add bgd init value to track_stars_setup

Chandra.Maneuver

• https://github.com/sot/Chandra.Maneuver/pull/14 Cast number of steps to int

Chandra.Time

• Add compile arg for building on MacOS Catalina / Xcode 11.2 chandra_time#34 Add compile arg for building on MacOS Catalina / Xcode 11.2

find_attitude

• Changes to go along with the py3-server kadi branch find_attitude#7 Changes to go along with the py3-server kadi branch
  • Mostly just a change in a module name. Django 3.0 requires web apps to have a unique name as determined by the module name.

kadi

• Add ACIS raw-mode SI modes to ACIS states kadi#152 Add ACIS raw-mode SI modes to ACIS states
• Py3 server with + event/cmd cron jobs processing with django 3.0 kadi#143 Py3 server with + event/cmd cron jobs processing with django 3.0
  • Interface impacts: Makes and uses new, not-back-compatible events3.db3
  • Make the django server run with Python 3 and django 3.0
  • Make the events update work on Python 3
  • Add obsid as a standard field for telemetry-based events
  • Change name of event database file from events.db3 to events3.db3. New file and schema are not compatible with previous version.
  • Flake8 changes

mica

• Small fix for PCAD table generation + SCM version changes mica#213 Small fix for PCAD table generation + SCM version changes
  • Tiny one-line change in the way kadi.events are imported required by django 3.0

ska_helpers

• Initial Release 0.1.0
  • This new package includes a module version.py that provides functionality for getting a package version using either distribution metadata or git tag and commit data.
  • Also includes convenience methods to get and/or log runtime information like user, machine name etc for scripts.

ska.quatutil

• PR Bulk changes to the recipes and build order. #7: Refactor test

ska_sync

• Add kadi/events3.db3, remove eng_archive in favor of cheta_sync ska_sync#15 Add kadi/events3.db3, remove eng_archive in favor of cheta_sync
  • Interface changes: Changes the default files that are synced with the tool if user creates new working sync config

Ska.Shell

• Fix bash support on catalina + modernize ska_shell#15 Fix bash support on catalina + modernize
  • Fix a problem that came up because Mac catalina outputs some cruft when you start a bash shell.
  • Also removes Python 2.7 support.

sparkles

• Add --open-html option to open HTML in browser sparkles#130 Add --open-html option to open HTML in browser
• Use setuptools_scm for single-source version sparkles#131 Add check that guide star is a valid guide candidate

task_schedule

• Initial steps to modernizing task_schedule task_schedule#15 Initial steps to modernizing task_schedule

watch_cron_logs

• Modernize watch_cron_logs#6 Modernize

xija

• Allow the timestep to be set from the model specification xija#48 Allow the timestep to be set from the model specification

Includes just package changes for setuptools-scm

• acdc, chandra_aca, Chandra.cmd_states, cxotime, hopper, maude, parse_cm, proseco, pyyaks, Ska.arc5gl, Ska.astro, Ska.DBI, Ska.File, Ska.Numpy, Ska.Matplotlib, Ska.ParseCM, Ska.tdb, starcheck, tables3_api, testr

ACIS packages with changes for setuptools-scm

• acis_thermal_check, acisfp_check, backstop_history, dea_check, dpa_check, psmc_check

Updates to core/not-ska packages

• setuptools_scm 3.3.3
• django 3.0.1
• sherpa to 4.11.1 on OSX

The spyder package has been removed from ska3-core

• Remove spyder

Interface impacts

The package interface impacts are called out above (kadi and ska_sync).

xija has back-compatible API changes. xija allows models to specify timestep from the spec (but uses the default of 328 seconds for back-compatibility).

Review

All changes have been reviewed by the aspect team.

Testing

The updated set of modules pass unit and integration testing. In addition, the more involved testing for the kadi+django update was documented by Tom in [kadi PR 143](sot/kadi#143

Promotion

After approval, updated ska3-flight and ska3-perl will be installed on HEAD and GRETA ska3/flight.

The kadi package update will require minor updates to the kadi cron jobs.

The removal of spyder from the ska3-core package does not require that it be removed from HEAD/GRETA ska3/flight , though we do believe that no one is actually using the package.

Github

Closes #255
Closes #253
Closes #252
Closes #251
Closes #250
Closes #249
Closes #247
Closes #246
Closes #245
Closes #243
Closes #239
Closes #238
Closes #229
Closes #224
Closes #232

---

[jeanconn]

I've updated the PR text with more content intended for external review (LR). If you have any comments or edits @taldcroft and @javierggt , please feel free.

[jeanconn]

The skare3 changes up through ba6cc13 correspond to the packages that are built and in ska3-conda and ska3-conda/test (ska3-flight pkg only) repos right now. This could go as a release if we run out of time before LR this week to do the rest.

[taldcroft]

With the effort of integration testing and deploy, I'm fine with waiting another week and just doing one release.

[taldcroft]

@javierggt - to close this out can you find someplace in the maintainer wiki to capture the versioning policy and edit accordingly. I note there are already things in there that are wrong with SCM versioning, for instance :

8. If necessary, do a quick PR to update the package version number. This is required if the current version in the code is the same as the last release tag.

[jeanconn]

Regarding effort; I had already done the regression testing (ska_testr) on this set of package versions, but fine to defer overall for deploy effort as well (depending on how things move).

[jeanconn]

Silly question, but what order should we use in the PR notes for the package updates? I think I started with "big" to "little" in substantive changes, but now it is just a mess.

[taldcroft]

Doesn't matter to me...

[jeanconn]

I think we'll need to fix sot/ska_helpers#7 (assuming it isn't some bizarre building or setup issue in my test environment) before promoting this.

[jeanconn]

I've pulled Quaternion and am running the integration tests with the new ACIS packages.