BLbluestaq
Star Catalog

POST /udl/starcatalog/createBulk

Changed on

Service operation intended for initial integration only, to take a list of StarCatalog records as a POST body and ingest into the database. This operation is not intended to be used for automated feeds into UDL. Data providers should contact the UDL team for specific role assignments and for instructions on setting up a permanent feed through an alternate mechanism.

Request

  • Base URL
    https://unifieddatalibrary.com
  • URL
    https://unifieddatalibrary.com/udl/starcatalog/createBulk
  • Auth
    none declared

Request body

idstring

Unique identifier of the record, auto-generated by the system.

classificationMarkingstring required

Classification marking of the data in IC/CAPCO Portion-marked format.

csIdinteger required

The ID of this object in the specific catalog associated with this record. This field will either contain the value in the gncCatId or sdaCatId field.

gncCatIdinteger

The ID of this object in the Guidance and Navigation Control (GNC) Catalog. If this field is populated it shall match the csId field.

sdaCatIdinteger

The ID of this object in the Space Domain Awareness (SDA) Catalog. If this field is populated it shall match the csId field.

gaiadr3CatIdinteger

The source ID of this object in the Gaia DR3 Catalog (GA).

hipCatIdinteger

The HIP ID of this object in the Hipparcos Catalog (HI).

twoMASSIdstring

The designation of this object in the Two Micron All Sky Survey (2MASS) Point Source Catalog (TP).

allWISEIdstring

The designation of this object in the All Wide-field Infrared Survey Explorer (AllWISE) catalog (AL).

panStarrsIdinteger

The Panoramic Survey Telescope and Rapid Response System (Pan-STARRS) (PS) object ID.

ukidssLASIdinteger

The United Kingdom Infrared Deep Sky Survey (UKIDSS) Large Area Survey (LAS) (UL) source ID of this object.

vhsIdinteger

The Visible and Infrared Survey Telescope for Astronomy (VISTA) Hemisphere Survey (VHS) (VS) source ID of this object.

aavsoVsxIdinteger

The American Association of Variable Star Observers (AAVSO) Variable Star Index (VSX) (VX) object ID of this object.

tychoDscIdinteger

The Tycho Double Star Catalog (TD) identifier (specified as Tycho-2 ID) of this object.

twoMassXscIdstring

The Two Micron All Sky Survey (2MASS) Extended Source Catalog (XSC) (TX) designation of this object.

ukidssGPSIdinteger

The United Kingdom Infrared Deep Sky Survey (UKIDSS) Galactic Plane Survey (GPS) (UP) source ID of this object.

wdsCatIdstring

The Washington Double Star Catalog (WD) identifier of this object.

carrascoCatIdinteger

The Carrasco catalog (CR) identifier of this object.

ducatiCatIdstring

The Ducati catalog (DU) name of this object.

apassIdstring

The American Association of Variable Star Observers (AAVSO) Photometric All-Sky Survey (APASS) (AP) name of this object.

skyMapperIdinteger

The SkyMapper (SK) catalog object ID.

uhsIdinteger

The United Kingdom Infrared Telescope (UKIRT) Hemispheric Survey (UHS) (UH) source ID of this object.

catWise2020Idstring

The CatWISE2020 (CA) catalog source ID of this object.

ukidssGCSIdinteger

The United Kingdom Infrared Deep Sky Survey (UKIDSS) Galactic Clusters Survey (GCS) (UC) source ID of this object.

healpixIndexinteger

The Healpix index. Consumers should contact the provider for details on the indexing scheme.

catVersionstring

The version of the catalog associated with this object.

ranumber double required

Barycentric right ascension of the source in the International Celestial Reference System (ICRS) frame at the reference epoch, in degrees.

raUncnumber double

Uncertainty of the right ascension of the source, in milliarcseconds, at the reference epoch.

decnumber double required

Barycentric declination of the source in International Celestial Reference System (ICRS) at the reference epoch, in degrees.

decUncnumber double

Uncertainty of the declination of the source, in milliarcseconds, at the reference epoch.

posUncFlagboolean

Flag indicating that the position uncertainty in either ra or dec is greater than 100 milliarcseconds.

parallaxnumber double

Absolute stellar parallax of the source, in milliarcseconds.

parallaxUncnumber double

Uncertainty of the stellar parallax, in milliarcseconds.

pmranumber double

Proper motion in right ascension of the source, in milliarcseconds per year, at the reference epoch.

pmraUncnumber double

Uncertainty of proper motion in right ascension, in milliarcseconds per year.

pmdecnumber double

Proper motion in declination of the source, in milliarcseconds per year, at the reference epoch.

pmdecUncnumber double

Uncertainty of proper motion in declination, in milliarcseconds per year.

pmUncFlagboolean

Flag indicating that the proper motion uncertainty in either ra or dec is greater than 10 milliarcseconds per year.

astrometryOriginstring required

Originating astrometric catalog for this object (GA (GAIA), HI (HIPPARCOS), UB (USNOBSC), AL, AP, CA, CR, DU, FK6_I, FK6_III, PS, SK, TD, TP, TX, UC, UL, UH, UP, VH, VS, WD).

starEpochnumber double required

Reference epoch to which the astrometric source parameters are referred, expressed as Julian Year in Barycentric Coordinate Time (TCB).

gmagnumber double

Gaia optical photometric G-band in the Vega scale measured in magnitudes.

gmagUncnumber double

Gaia optical photometric G-band uncertainty in the Vega scale measured in magnitudes.

bpmagnumber double

Gaia optical photometric Bp-band in the Vega scale measured in magnitudes.

bpmagUncnumber double

Gaia optical Bp-band uncertainty in the Vega scale measured in magnitudes.

rpmagnumber double

Gaia optical Rp-band in the Vega scale measured in magnitudes.

rpmagUncnumber double

Gaia optical photometric Rp-band uncertainty in the Vega scale measured in magnitudes.

sgmagnumber double

Original G magnitude if the source is in Gaia, otherwise the magnitude is converted from other photometric passbands, when possible, measured in magnitudes.

sgmagUncnumber double

Uncertainty of sgmag measured in magnitudes.

bmagnumber double

Optical Johnson B magnitude measured in magnitudes.

bmagUncnumber double

Uncertainty of optical Johnson B magnitude measured in magnitudes.

bmagOriginstring

Catalog of origin of optical Johnson B magnitude (AP, CR, HI).

vmagnumber double

Optical Johnson V magnitude measured in magnitudes.

vmagUncnumber double

Uncertainty of the Optical Johnson V magnitude measured in magnitudes.

vmagOriginstring

Catalog of origin of Optical Johnson V magnitude (AP, CR, DU, GA, HI).

rmagnumber double

Optical Johnson R magnitude measured in magnitudes.

rmagUncnumber double

Uncertainty of the Optical Johnson R magnitude measured in magnitudes.

rmagOriginstring

Catalog of origin of the Optical Johnson R magnitude (CR, GA).

imagnumber double

Optical Johnson I magnitude measured in magnitudes.

imagUncnumber double

Uncertainty of optical Johnson I magnitude measured in magnitudes.

imagOriginstring

Catalog of origin of optical Johnson I magnitude (CR, GA, HI).

abgmagnumber double

Optical AB g magnitude.

abgmagUncnumber double

Uncertainty of optical AB g magnitude.

abgmagOriginstring

Catalog of origin of optical AB g magnitude.

abrmagnumber double

Optical AB r magnitude.

abrmagUncnumber double

Uncertainty of optical AB r magnitude.

abrmagOriginstring

Catalog of origin of optical AB r magnitude.

abimagnumber double

Optical AB i magnitude.

abimagUncnumber double

Uncertainty of optical AB i magnitude.

abimagOriginstring

Catalog of origin of optical AB i magnitude.

abzmagnumber double

Optical AB z magnitude.

abzmagUncnumber double

Uncertainty of optical AB z magnitude.

abzmagOriginstring

Catalog of origin of optical AB z magnitude.

abymagnumber double

Optical AB y magnitude.

abymagUncnumber double

Uncertainty of optical AB y magnitude.

abymagOriginstring

Catalog of origin of optical AB y magnitude.

jmagnumber double

Near-infrared photometric J-band magnitude in the Vega scale measured in magnitudes.

jmagUncnumber double

Near-infrared photometric J-band magnitude uncertainty in the Vega scale measured in magnitudes.

jmagOriginstring

Near-infrared photometric J-band catalog of origin in the Vega scale (TP, UH, UL, UP, VH).

kmagnumber double

Near-infrared photometric K-band magnitude in the Vega scale measured in magnitudes.

kmagUncnumber double

Near-infrared photometric K-band magnitude uncertainty in the Vega scale measured in magnitudes.

kmagOriginstring

Near-infrared photometric K-band catalog of origin in the Vega scale (TP, UC, UH, UL, UP, VH).

hmagnumber double

Near-infrared photometric H-band magnitude in the Vega scale measured in magnitudes.

hmagUncnumber double

Near-infrared photometric H-band magnitude uncertainty in the Vega scale measured in magnitudes.

hmagOriginstring

Near-infrared photometric H-band catalog of origin in the Vega scale (TP, UC, UL, UP, VH).

w1magnumber double

Mid-infrared photometric W1-band (3.4 microns) magnitude in the Vega system measured in magnitudes.

w1magUncnumber double

Mid-infrared photometric W1-band (3.4 microns) magnitude uncertainty in the Vega system measured in magnitudes.

w1satnumber double

Mid-infrared photometric W1-band (3.4 microns) saturated pixel fraction in the Vega system.

w1magOriginstring

Mid-infrared photometric W1-band (3.4 microns) catalog of origin in the Vega system (AL, CA).

w2magnumber double

Mid-infrared photometric W2-band (4.6 microns) magnitude in the Vega system measured in magnitudes.

w2magUncnumber double

Mid-infrared photometric W2-band (4.6 microns) magnitude uncertainty in the Vega system measured in magnitudes.

w2satnumber double

Mid-infrared photometric W2-band (4.6 microns) saturated pixel fraction in the Vega system.

w2magOriginstring

Mid-infrared photometric W2-band (4.6 microns) catalog of origin in the Vega system (AL, CA).

w3magnumber double

Mid-infrared photometric W3-band (12 microns) magnitude in the Vega system measured in magnitudes.

w3magUncnumber double

Mid-infrared photometric W3-band (12 microns) magnitude uncertainty in the Vega system measured in magnitudes.

w3satnumber double

Mid-infrared photometric W3-band (12 microns) saturated pixel fraction in the Vega system.

w3magOriginstring

Mid-infrared photometric W3-band (12 microns) catalog of origin in the Vega system (AL).

w4magnumber double

Mid-infrared photometric W4-band (22 microns) magnitude in the Vega system measured in magnitudes.

w4magUncnumber double

Mid-infrared photometric W4-band (22 microns) magnitude uncertainty in the Vega system measured in magnitudes.

w4satnumber double

Mid-infrared photometric W4-band (22 microns) saturated pixel fraction in the Vega system.

w4magOriginstring

Mid-infrared photometric W4-band (22 microns) catalog of origin in the Vega system (AL).

allWISEnaIndinteger

Active deblending indicator in AllWISE.

allWISEccIndstring

Contamination and confusion indicator in AllWISE.

allWISEphQualIndstring

Photometric quality indicator in AllWISE.

ps1ObjInfoFlaginteger

Object information flag in Pan-STARRS.

ps1QualityFlaginteger

Quality flag in Pan-STARRS.

ps1astrometryCorrectionFlaginteger

Astrometry correction flag in Pan-STARRS.

twoMassPHQualIndstring

Photometric (PH) quality indicator in 2MASS PSC.

twoMassReadFlagstring

Read flag in 2MASS PSC.

astrometricExcessNoisenumber double

Astrometric excess noise in the Gaia catalog measured in milliarcseconds.

astrometricExcessNoiseSignumber double

Astrometric excess noise sigma in Gaia.

ruwenumber double

RUWE in Gaia.

nonSingleStarstring

Identifier indicating the source is a non-single star in gaia (additional information is available in non-single star tables. Consumers should contact the provider for details on the specifications).

varFlagboolean

Flag indicating that the source exhibits variable magnitude.

variabilitystring

Identifier indicating variability is present in the photometric data. Consumers should contact the provider for details on the specifications.

multFlagboolean

Flag indicating that this is a multiple object source.

multiplicitystring

Identifier indicating multiplicity is detected. Consumers should contact the provider for details on the specifications.

morphologyIndinteger

Morphology indicator. Consumers should contact the provider for details on the specifications.

neighborIdinteger

The catalog ID of the nearest neighbor to this source.

neighborFlagboolean

Flag indicating that the nearest catalog neighbor is closer than 4.6 arcseconds.

neighborDistancenumber double

Distance between source and nearest neighbor, in arcseconds.

neighborRanumber double

RA of nearest neighbor measured in degrees.

neighborDecnumber double

Dec of nearest neighbor measured in degrees.

numNeighborsinteger

Number of neighbors.

shiftFlagboolean

Flag indicating that the photocentric shift is greater than 50 milliarcseconds.

shiftnumber double

Photocentric shift caused by neighbors, in arcseconds.

shiftFWHM1number double

Photocentric shift caused by neighbors, in arcseconds. This value is constrained to a Point Spread Function (PSF) with Full Width at Half Maximum (FWHM) of one arcsecond.

shiftFWHM6number double

Photocentric shift caused by neighbors, in arcseconds. This value is constrained to a Point Spread Function (PSF) with Full Width at Half Maximum (FWHM) of six arcseconds.

createdAtstring date-time

Time the row was created in the database, auto-populated by the system.

createdBystring

Application user who created the row in the database, auto-populated by the system.

updatedAtstring date-time

Time the row was last updated in the database, auto-populated by the system.

updatedBystring

Application user who updated the row in the database, auto-populated by the system.

sourcestring required

Source of the data.

originstring

Originating system or organization which produced the data, if different from the source. The origin may be different than the source if the source was a mediating system which forwarded the data on behalf of the origin system. If null, the source may be assumed to be the origin.

origNetworkstring

The originating source network on which this record was created, auto-populated by the system.

dataMode'REAL' | 'TEST' | 'EXERCISE' | 'SIMULATED' required

Indicator of whether the data is REAL, TEST, EXERCISE, or SIMULATED data:

REAL: Data collected or produced that pertains to real-world objects, events, and analysis.

TEST: Specific datasets used to evaluate compliance with specifications and requirements, and for validating technical, functional, and performance characteristics.

EXERCISE: Data pertaining to a government or military exercise. The data may include both real and simulated data.

SIMULATED: Synthetic data generated by a model to mimic real-world datasets.

Example request

[
  {
    "id": "STAR-CAT-DATASET-ID",
    "classificationMarking": "U",
    "csId": 12345,
    "gncCatId": 12345,
    "sdaCatId": 3015023687,
    "gaiadr3CatId": 89012345678901,
    "hipCatId": 12345,
    "twoMASSId": "A1B2C3D4E5",
    "allWISEId": "WISEA J152743.04+624823.6",
    "panStarrsId": 215993386231483000,
    "ukidssLASId": 433883403451,
    "vhsId": 473820608583,
    "aavsoVsxId": 2387137,
    "tychoDscId": 9537000661,
    "twoMassXscId": "5000540",
    "ukidssGPSId": 439491265503,
    "wdsCatId": "155506",
    "carrascoCatId": 1244,
    "ducatiCatId": "AB ORI",
    "apassId": "175-0082419",
    "skyMapperId": 505176683,
    "uhsId": 460074663768,
    "catWise2020Id": "3584p196_b0-084425",
    "ukidssGCSId": 442466709194,
    "healpixIndex": 196607,
    "catVersion": "1.23 DR3",
    "ra": 14.43,
    "raUnc": 509.466,
    "dec": 21.8,
    "decUnc": 40.996,
    "parallax": -6.8,
    "parallaxUnc": 82.35,
    "pmra": 1000.45,
    "pmraUnc": 5.6,
    "pmdec": -970.1003,
    "pmdecUnc": 1.22,
    "astrometryOrigin": "GA",
    "starEpoch": 2018.864,
    "gmag": 0.0046,
    "gmagUnc": 0.00292,
    "bpmag": 0.04559,
    "bpmagUnc": 0.2227,
    "rpmag": 8.0047,
    "rpmagUnc": 1.233,
    "sgmag": 28.663515,
    "sgmagUnc": 2.3097522,
    "bmag": 27.004,
    "bmagUnc": 9.999,
    "bmagOrigin": "AP",
    "vmag": 25.829414,
    "vmagUnc": 2.055,
    "vmagOrigin": "CR",
    "rmag": 22.657284,
    "rmagUnc": 0.053,
    "rmagOrigin": "GA",
    "imag": 22.46249,
    "imagUnc": 1.2000417,
    "imagOrigin": "HI",
    "abgmag": 11.24,
    "abgmagUnc": 0.023,
    "abgmagOrigin": "PS",
    "abrmag": 11.24,
    "abrmagUnc": 0.023,
    "abrmagOrigin": "SK",
    "abimag": 11.24,
    "abimagUnc": 0.023,
    "abimagOrigin": "GA",
    "abzmag": 11.24,
    "abzmagUnc": 0.023,
    "abzmagOrigin": "AP",
    "abymag": 11.24,
    "abymagUnc": 0.023,
    "abymagOrigin": "AP",
    "jmag": 9.515,
    "jmagUnc": 7.559,
    "jmagOrigin": "TP",
    "kmag": 13.545,
    "kmagUnc": 0.052,
    "kmagOrigin": "UC",
    "hmag": 12.126,
    "hmagUnc": 5.722,
    "hmagOrigin": "UL",
    "w1mag": 15.782,
    "w1magUnc": 0.042,
    "w1sat": 0.993,
    "w1magOrigin": "CA",
    "w2mag": 16.523,
    "w2magUnc": 0.021,
    "w2sat": 0.962,
    "w2magOrigin": "CA",
    "w3mag": 11.541,
    "w3magUnc": 0.159,
    "w3sat": 0.999,
    "w3magOrigin": "AL",
    "w4mag": 9.007,
    "w4magUnc": 0.468,
    "w4sat": 0.523,
    "w4magOrigin": "AL",
    "allWISEnaInd": 1,
    "allWISEccInd": "0000",
    "allWISEphQualInd": "AAAA",
    "ps1ObjInfoFlag": 2005196800,
    "ps1QualityFlag": 239,
    "ps1astrometryCorrectionFlag": 7,
    "twoMassPHQualInd": "AAAA",
    "twoMassReadFlag": "111",
    "astrometricExcessNoise": 921.2857,
    "astrometricExcessNoiseSig": 194326670.1,
    "ruwe": 116.016365,
    "nonSingleStar": "7",
    "varFlag": true,
    "variability": "1",
    "multFlag": true,
    "multiplicity": "2",
    "morphologyInd": 5,
    "neighborId": 2456,
    "neighborDistance": 201.406,
    "neighborRa": 359.99,
    "neighborDec": 89.99,
    "numNeighbors": 519,
    "shift": 4.548,
    "shiftFWHM1": 0.157,
    "shiftFWHM6": 1.065,
    "createdAt": "2018-01-01T16:00:00.123Z",
    "createdBy": "some.user",
    "updatedAt": "2018-01-01T16:00:00.123Z",
    "updatedBy": "some.user",
    "source": "Bluestaq",
    "origin": "THIRD_PARTY_DATASOURCE",
    "origNetwork": "OPS1",
    "dataMode": "TEST"
  }
]

Response

Success

Changes

  • bd17bc53681eRevision changes
    • info

      the / request property format was generalized from int32 to int64

  • 173e4aff893fRevision changes
    • breaking

      removed the enum value GAIADR3 of the request property /

    • breaking

      removed the enum value HIPPARCOS of the request property /

    • breaking

      removed the enum value USNOBSC of the request property /

    • breaking

      the / request property's maxLength was decreased to 8

    • breaking

      the / request property's maxLength was decreased to 8

    • breaking

      the / request property's maxLength was decreased to 8

    • warning

      the / request property's maxLength was set to 36

    • warning

      the / request property's max was set to 90.00

    • warning

      the / request property's max was set to 360.00

    • warning

      the / request property's min was set to -90.00

    • warning

      the / request property's min was set to 0.00

    • warning

      removed the request property /

    • warning

      removed the request property /

    • warning

      removed the request property /

    • warning

      removed the request property /

    • warning

      removed the request property /

    • warning

      removed the request property /

    • warning

      removed the request property /

    • warning

      removed the request property /

    • info

      added the new optional request property /

    • info

      added the new optional request property /

    • info

      added the new optional request property /

    • info

      added the new optional request property /

    • info

      added the new optional request property /

    • info

      added the new optional request property /

    • info

      added the new optional request property /

    • info

      added the new optional request property /

    • info

      added the new optional request property /

    • info

      added the new optional request property /

    • info

      added the new optional request property /

    • info

      added the new optional request property /

    • info

      added the new optional request property /

    • info

      added the new optional request property /

    • info

      added the new optional request property /

    • info

      added the new optional request property /

    • info

      added the new optional request property /

    • info

      added the new optional request property /

    • info

      added the new optional request property /

    • info

      added the new optional request property /

    • info

      added the new optional request property /

    • info

      added the new optional request property /

    • info

      added the new optional request property /

    • info

      added the new optional request property /

    • info

      added the new optional request property /

    • info

      added the new optional request property /

    • info

      added the new optional request property /

    • info

      added the new optional request property /

    • info

      added the new optional request property /

    • info

      added the new optional request property /

    • info

      added the new optional request property /

    • info

      added the new optional request property /

    • info

      added the new optional request property /

    • info

      added the new optional request property /

    • info

      added the new optional request property /

    • info

      added the new optional request property /

    • info

      added the new optional request property /

    • info

      added the new optional request property /

    • info

      added the new optional request property /

    • info

      added the new optional request property /

    • info

      added the new optional request property /

    • info

      added the new optional request property /

    • info

      added the new optional request property /

    • info

      added the new optional request property /

    • info

      added the new optional request property /

    • info

      added the new optional request property /

    • info

      added the new optional request property /

    • info

      added the new optional request property /

    • info

      added the new optional request property /

    • info

      added the new optional request property /

    • info

      added the new optional request property /

    • info

      added the new optional request property /

    • info

      added the new optional request property /

    • info

      added the new optional request property /

    • info

      added the new optional request property /

    • info

      added the new optional request property /

    • info

      added the new optional request property /

    • info

      added the new optional request property /

    • info

      added the new optional request property /

    • info

      added the new optional request property /

    • info

      added the new optional request property /

    • info

      added the new optional request property /

    • info

      added the new optional request property /

    • info

      added the new optional request property /

    • info

      added the new optional request property /

    • info

      added the new optional request property /

    • info

      added the new optional request property /

    • info

      added the new optional request property /

    • info

      added the new optional request property /

    • info

      added the new optional request property /

    • info

      added the new optional request property /

    • info

      added the new optional request property /

    • info

      added the new optional request property /

    • info

      added the new optional request property /

    • info

      added the new optional request property /

    • info

      added the new optional request property /

    • info

      added the new optional request property /

    • info

      added the new optional request property /

    • info

      added the new optional request property /

    • info

      added the new optional request property /

    • info

      the request optional property / became read-only

    • info

      the / request property's maxLength was increased from 32 to 36

    • info

      the / request property's maxLength was increased from 36 to 64

    • info

      the / request property's maxLength was increased from 32 to 36

Some revisions have not been checked yet.