Where are Solar System objects located in TESS FFI data?
tess-ephem is a user-friendly package which enables users to compute the positions of Solar System objects -- asteroids, comets, and planets --
in the data archive of NASA's TESS Space Telescope.
python -m pip install tess-ephemtess-ephem allows you to search the entire archive of TESS FFI's for the presence of a known minor planet, and obtain the result as a Pandas DataFrame. The output pixel coordinates (column and row) follow the TESS convention, with (1,1) being the middle of the pixel in the lower left corner of the FFI. For example:
>>>fromtess_ephemimportephem>>>ephem("Sedna")
sectorcameraccdcolumnrowtdb-ut ... decvmaghmagsun_distanceobs_distancesto_angletime ...
2458438.55141543.1040211102.94835169.182738 ... 7.6496120.8031.4984.94753683.9810600.14662458439.55141544.9789691103.00070169.182758 ... 7.6472420.8021.4984.94676083.9788700.14352458440.55141546.8660071103.02741569.182777 ... 7.6450020.8011.4984.94598583.9773350.14122458441.55141548.7508851103.04024269.182797 ... 7.6428420.8011.4984.94520983.9763340.13972458442.55141550.6271991103.04402069.182818 ... 7.6407420.8011.4984.94443383.9758020.1393
... ... ... ... ... ... ... ... ... ... ... ... ... ...
2460254.571241984.5785781003.55588869.182570 ... 8.3608920.7501.4983.59274082.6617710.24402460255.571241984.8084841001.73704769.182584 ... 8.3580320.7491.4983.59201782.6566070.23472460256.571241985.037223999.91109169.182599 ... 8.3551720.7471.4983.59129482.6519200.22572460257.571241985.258387998.08471869.182615 ... 8.3523520.7451.4983.59057282.6477500.21682460258.571241985.462457996.27963869.182631 ... 8.3496420.7441.4983.58984982.6441490.2083
[75rowsx14columns]The time is in the UT scale. To convert this to the TDB timescale, the column tdb-ut (offset in seconds) should be used.
You can also obtain the ephemeris for one or more specific times
by passing the time parameter:
>>>ephem("Sedna", time="2018-11-21 17:35:00")
sectorcameraccdcolumnrowtdb-ut ... decvmaghmagsun_distanceobs_distancesto_angletime ...
2018-11-2117:35:00.0005141553.8584041103.03502769.182854 ... 7.6372120.8021.4984.9430983.9758940.1409>>>fromastropy.timeimportTime>>>ephem("Sedna", time=Time([2458441.5,2460258.5], format='jd'))
sectorcameraccdcolumnrowtdb-ut ... decvmaghmagsun_distanceobs_distancesto_angletime ...
2458441.55141548.7508851103.04024269.182797 ... 7.6428420.8011.4984.94520983.9763340.13972460258.571241985.462457996.27963869.182631 ... 8.3496420.7441.4983.58984982.6441490.2083Orbital elements can be obtained by passing the orbital_elements=True parameter. The function returns the average orbital elements of the target during the queried time. Perihelion distance is in AU and orbital inclination is in degrees.
>>>df_ephem, orbital_elements=ephem("Sedna", time="2018-11-21 17:35:00", orbital_elements=True)
>>>orbital_elements
{'perihelion_distance': 76.13306961191206, 'eccentricity': 0.8413469227223953, 'orbital_inclination': 11.929585162007143}You can alternatively obtain the ephemeris during a specific sector by passing
the sector parameter:
>>>ephem("Sedna", sector=70)
sectorcameraccdcolumnrowtdb-ut ... decvmaghmagsun_distanceobs_distancesto_angletime ...
2460208.570421965.9946391827.04967269.182409 ... 8.4948320.8151.4983.62600983.1719830.61842460209.570421966.3044671826.44241469.182402 ... 8.4924820.8141.4983.62528583.1561530.61372460210.570421966.6395791825.74319869.182395 ... 8.4898920.8131.4983.62456183.1402100.60852460211.570421966.9957171824.97590269.182389 ... 8.4871120.8121.4983.62383883.1244610.60292460212.570421967.3639621824.16006269.182383 ... 8.4842120.8111.4983.62311483.1089740.59702460213.570421967.7432471823.29943269.182377 ... 8.4812020.8101.4983.62239183.0937700.59082460214.570421968.1278561822.40226869.182372 ... 8.4781220.8091.4983.62166783.0788620.58452460215.570421968.5163591821.47063369.182367 ... 8.4749820.8081.4983.62094483.0642640.57792460216.570421968.9094791820.50791269.182363 ... 8.4717820.8061.4983.62022083.0499950.57122460217.570421969.3011391819.52067169.182359 ... 8.4685620.8051.4983.61949783.0360820.56442460218.570421969.6906291818.51436469.182355 ... 8.4653320.8041.4983.61877383.0225620.55752460219.570421970.0700961817.50477569.182353 ... 8.4621520.8031.4983.61805083.0094810.55042460220.570421970.4134471816.52739869.182350 ... 8.4592020.8021.4983.61732682.9967740.54352460221.570421970.6855941815.59304069.182349 ... 8.4566820.8001.4983.61660382.9836810.53692460222.570421970.9450961814.59045369.182347 ... 8.4541520.7991.4983.61587982.9698910.53012460223.570421971.2281101813.50506869.182347 ... 8.4514020.7981.4983.61515682.9561130.52282460224.570421971.5285841812.36114469.182347 ... 8.4484920.7961.4983.61443382.9425890.51522460225.570421971.8400951811.17239769.182347 ... 8.4454720.7951.4983.61370982.9293770.50742460226.570421972.1601451809.94465069.182348 ... 8.4423620.7941.4983.61298682.9164950.49932460227.570421972.4840841808.68240469.182350 ... 8.4391920.7921.4983.61226382.9039560.49112460228.570421972.8115651807.39280969.182352 ... 8.4359720.7911.4983.61153982.8917740.48272460229.570421973.1390071806.07660569.182354 ... 8.4327220.7901.4983.61081682.8799680.47422460230.570421973.4674941804.73887669.182358 ... 8.4294420.7881.4983.61009382.8685660.46572460231.570421973.7913051803.38789069.182361 ... 8.4261720.7871.4983.60937082.8576090.45702460232.570421974.1022221802.03774769.182365 ... 8.4229720.7851.4983.60864682.8471500.4483When passing the sector parameter, the time_step is by default 1 day.
This can be changed as follows:
>>>ephem("Sedna", sector=70, time_step=0.1)
sectorcameraccdcolumnrowtdb-ut ... decvmaghmagsun_distanceobs_distancesto_angletime ...
2460207.670421965.6984671827.54320369.182416 ... 8.49697720.8159731.4983.62666083.1855190.6224232460207.770421965.7346581827.48731769.182415 ... 8.49672020.8160021.4983.62658883.1840490.6219562460207.870421965.7699861827.43201869.182415 ... 8.49646820.8160451.4983.62651583.1825730.6214972460207.970421965.8044111827.37718769.182414 ... 8.49622120.8160581.4983.62644383.1810910.6210462460208.070421965.8378891827.32270569.182413 ... 8.49598020.8160001.4983.62637083.1795990.620600
... ... ... ... ... ... ... ... ... ... ... ... ... ...
2460233.070421974.2483801801.37166769.182368 ... 8.42143020.7850001.4983.60828582.8421100.4440002460233.170421974.2756951801.24032069.182368 ... 8.42113420.7848861.4983.60821282.8411150.4431372460233.270421974.3021281801.10981569.182369 ... 8.42084420.7847071.4983.60814082.8401220.4422752460233.370421974.3276591800.98017669.182369 ... 8.42056020.7844861.4983.60806882.8391290.4414142460233.470421974.3522681800.85143069.182370 ... 8.42028220.7842431.4983.60799582.8381360.440555
[259rowsx14columns]