Skip to content

Default Photometry and Centroid Routes #34

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Closed
bensharkey wants to merge 5 commits into from
Closed

Default Photometry and Centroid Routes #34

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
5 commits
Select commit Hold shift + click to select a range
e599a74
Adding API routes for a default aperture photometry step, including c…
bensharkey Apr 23, 2026
84d8899
Adding subtract_median_background.py into tracking
bensharkey Apr 23, 2026
7a86294
Restricting numpy version to >=2.0, <= 2.2
bensharkey Apr 23, 2026
ec61690
Update pyproject.toml
bensharkey Apr 24, 2026
87846bc
Update pyproject.toml
bensharkey Apr 24, 2026
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
1,733 changes: 1,733 additions & 0 deletions 65P_atlas_haleakela.fits
View file
Open in desktop

Large diffs are not rendered by default.

1 change: 1 addition & 0 deletions 65P_atlas_haleakela.wcs
View file
Open in desktop

Large diffs are not rendered by default.

227 changes: 227 additions & 0 deletions catch_analysis_tools/app/api/openapi.yaml
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -200,3 +200,230 @@ paths:

"500":
description: Internal server error
/subtract_median_background:

@mkelley mkelley Apr 24, 2026

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Rename "background/median_filtered"? or similar?

post:
operationId: catch_analysis_tools.app.services.subtract_median_background.perform_median_subtraction
summary: "Compute the median background with source masking, saving the background-subtracted image as a new FITS file."

@mkelley mkelley Apr 24, 2026

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Edit to reflect the fact that this is a windowed median filtering (as opposed to subtraction of the image median).

parameters:
- name: url
in: query
description: "Cutout URL from CATCH query"
example: "https://sbnsurveys.astro.umd.edu/api/images/urn:nasa:pds:gbo.ast.atlas.survey.258:59185:01a59185o0401o.fits?ra=13.46483&dec=15.80546&size=0.16deg&format=fits"
required: true
schema:
type: string
responses:
"200":
description: Background-subtracted image saved as a new FITS file.
content:
application/json:
schema:
type: object
description: Path to the background-subtracted FITS file.
properties:
background_subtracted_image_path:
description: Path to the background-subtracted FITS file.
type: string
/do_default_photometry:

@mkelley mkelley Apr 24, 2026

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Rename "photometry/circular_aperture"?

post:
operationId: catch_analysis_tools.app.services.photometry.default_extraction
summary: "Perform a basic (circular aperture, background annulus centered on target) extraction on source nearest to target ephemeris location"
parameters:
- name: filebase
in: query
description: "Base filename (without .fits or .wcs extension) taken from CATCH-generated query URL."
example: "65P_atlas_haleakela"
required: true
schema:
type: string
- name: target_ra
in: query
description: "Target Right Ascension ephemeris location, to be used as initial guess for the object."
example: "39.60040"
required: true
schema:
type: number
- name: target_dec
in: query
description: "Target Declination ephemeris location, to be used as initial guess for the object."
example: "10.07014"
required: true
schema:
type: number
- name: search_radius
in: query
description: "Radius in pixels of search area (centered on (target_ra,target_dec) ) for centroiding."
example: "7"
required: true
schema:
type: number
- name: aperture_size
in: query
description: "Radius (in pixels) for source flux extraction aperture."
example: "7"
required: true
schema:
type: number
- name: an_in
in: query
description: "Radius (in pixels) for inner edge of annulus for background subtraction, centered on target."
example: "7"
required: true
schema:
type: number
- name: an_out
in: query
description: "Radius (in pixels) for outer edge of annulus for background subtraction, centered on target."
example: "15"
required: true
schema:
type: number
responses:
"200":
description: Calibrated magnitude array from chosen aperture photometry settings, and output plot showing the aperture on the cutout
content:
application/json:
schema:
type: array
description: Magnitude from source flux with asymmetric uncertainties.
items:
type: object
description: Output from photometry.centroid_location(). Array containing search input parameters (initial guess, search radius) and final centroided location.
properties:
search_results:
description: Array of input search parameters and output centroid
centroid_figure:
description: Location of figure showing centroid search
type: object
description: Output from photometry.calibrated_mag(). Array containing source CALIBRATED magnitude and uncertainties, as [Magnitude, Upper Magnitude Uncertainty, Lower Magnitude Uncertainty].
properties:
cal_mag:
description: Calibrated magnitude
type: number
cal_mag_hi_uncert:
description: Upper uncertainty on calibrated magnitude
type: number
cal_mag_lo_uncert:
description: Lower uncertainty on calibrated magnitude
type: number
type: object
description: Cutout image with aperture
properties:
aperture_figure:
description: Output plot showing the default aperture + annulus extraction onto the cutout image.
type: string
type: object
description: Output from photometry.centroid_location(). Array containing search input parameters (initial guess, search radius) and final centroided location.
properties:
init_guess_x:
description: x pixel coordinate of guess
type: number
init_guess_y:
description: y pixel coordinate of guess
type: number
init_guess_RA:
description: RA value of guess
type: number
init_guess_Dec:
description: Dec value of guess
type: number
search_radius:
description: Radius in pixels for source search
type: number
cent_x:
description: x pixel coordinate of centroided source
type: number
cent_y:
description: y pixel coordinate of centroided source
type: number
cent_RA:
description: RA value of centroided source
type: number
cent_Dec:
description: Dec value of centroided source
type: number
type: object
description: Cutout image showing selected target centroid in the cutout image.
properties:
centroid_figure:
description: Location of centroid plot.
type: string
/get_centroided_target_location:

@mkelley mkelley Apr 24, 2026

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Rename "centroid"?

post:
operationId: catch_analysis_tools.app.services.photometry.centroid_location
summary: "Find nearest target centroid to a user-specified point, with user-specified search radius."
parameters:
- name: filebase
in: query
description: "Base filename (without .fits or .wcs extension) taken from CATCH-generated query URL."
example: "65P_atlas_haleakela"
required: true
schema:
type: string
- name: target_ra
in: query
description: "Target pixel RA value, to be used as initial guess for the object."
example: "39.60040"
required: true
schema:
type: number
- name: target_dec
in: query
description: "Target pixel Dec value, to be used as initial guess for the object."
example: "10.07014"
required: true
schema:
type: number
- name: search_radius
in: query
description: "Radius in pixels of search area (centered on (target_x,target_y) ) for centroiding."
example: "7"
required: true
schema:
type: number
responses:
"200":
description: Calibrated magnitude array from chosen aperture photometry settings, and output plot showing the aperture on the cutout
content:
application/json:
schema:
type: array
description: Magnitude from source flux with asymmetric uncertainties.
items:
type: object
description: Output from photometry.centroid_location(). Array containing search input parameters (initial guess, search radius) and final centroided location.
properties:
init_guess_x:
description: x pixel coordinate of guess
type: number
init_guess_y:
description: y pixel coordinate of guess
type: number
init_guess_ra:
description: RA value of guess
type: number
init_guess_dec:
description: Dec value of guess
type: number
search_radius:
description: Radius in pixels for source search
type: number
cent_x:
description: x pixel coordinate of centroided source
type: number
cent_y:
description: y pixel coordinate of centroided source
type: number
cent_RA:
description: RA value of centroided source
type: number
cent_Dec:
description: Dec value of centroided source
type: number
type: object
description: Cutout image showing selected target centroid in the cutout image.
properties:
centroid_figure:
description: Location of centroid plot.
type: string

Loading
Loading