All Products
Search
Document Center

PolarDB:ST_SetRPCGeoreference

Last Updated:Mar 28, 2026

Sets rational polynomial coefficient (RPC) georeference parameters on a raster object.

Syntax

raster ST_SetRPCGeoreference(raster raster_obj, text rpc_json)

Parameters

ParameterDescription
raster_objThe raster object.
rpc_jsonThe RPC parameters in JSON format.

RPC parameters

The following table describes the fields supported in rpc_json.

FieldDescriptionType
lineOffThe line offset.float
sampOffThe sample offset.float
latOffThe latitude offset.float
longOffThe longitude offset.float
heightOffThe height offset.float
lineScaleThe line scale.float
sampScaleThe sample scale.float
latScaleThe latitude scale.float
longScaleThe longitude scale.float
heightScaleThe height scale.float
lineDenCoeffThe line denominator coefficients. Valid values: 1 to 20 elements.float array
lineNumCoeffThe line numerator coefficients. Valid values: 1 to 20 elements.float array
sampNumCoeffThe sample numerator coefficients. Valid values: 1 to 20 elements.float array
sampDenCoeffThe sample denominator coefficients. Valid values: 1 to 20 elements.float array
errBiasThe root mean square (RMS) bias error in meters, measured across all points along the horizontal axis of the image. Default value: -1.0.float
errRandomThe RMS random error in meters, measured per point along the horizontal axis of the image. Default value: -1.0.float

Example

The following example sets RPC parameters on a raster object and then retrieves them using ST_RPCGeoreference.

SELECT ST_RPCGeoreference(ST_SetRPCGeoreference(raster_obj, '{
    "lineOff": 12800.00,
    "sampOff": 4008.00,
    "latOff": 55.02030000,
    "longOff": 27.04780000,
    "heightOff": 179.000,
    "lineScale": 12800.00,
    "sampScale": 4008.00,
    "latScale": 0.12380000,
    "longScale": 0.06850000,
    "heightScale": 300.000,
    "lineNumCoeff": [
        -2.104832000000000E-03,
        -1.642616000000000E-02,
        -1.027459000000000E+00,
        4.182002500000000E-03,
        -1.902795200000000E-03,
        1.614313300000000E-05,
        4.786355800000000E-04,
        -2.127866900000000E-04,
        6.958830700000000E-03,
        -2.260572200000000E-06,
        -2.225955200000000E-07,
        -3.746937200000000E-07,
        4.648645700000000E-04,
        -1.801288800000000E-08,
        5.140758300000000E-06,
        7.566147900000000E-04,
        -5.452440900000000E-07,
        1.394079900000000E-07,
        -1.828159600000000E-05,
        2.421558100000000E-09
    ],
    "lineDenCoeff": [
        1.000000000000000E+00,
        -5.006651300000000E-04,
        -1.457830900000000E-03,
        6.037474400000000E-04,
        0.000000000000000E+00,
        0.000000000000000E+00,
        0.000000000000000E+00,
        0.000000000000000E+00,
        0.000000000000000E+00,
        0.000000000000000E+00,
        0.000000000000000E+00,
        0.000000000000000E+00,
        0.000000000000000E+00,
        0.000000000000000E+00,
        0.000000000000000E+00,
        0.000000000000000E+00,
        0.000000000000000E+00,
        0.000000000000000E+00,
        0.000000000000000E+00,
        0.000000000000000E+00
    ],
    "sampNumCoeff": [
        1.000000000000000E+00,
        -5.006651300000000E-04,
        -1.457830900000000E-03,
        6.037474400000000E-04,
        0.000000000000000E+00,
        0.000000000000000E+00,
        0.000000000000000E+00,
        0.000000000000000E+00,
        0.000000000000000E+00,
        0.000000000000000E+00,
        0.000000000000000E+00,
        0.000000000000000E+00,
        0.000000000000000E+00,
        0.000000000000000E+00,
        0.000000000000000E+00,
        0.000000000000000E+00,
        0.000000000000000E+00,
        0.000000000000000E+00,
        0.000000000000000E+00,
        0.000000000000000E+00
    ],
    "sampDenCoeff": [
        1.000000000000000E+00,
        -5.006651300000000E-04,
        -1.457830900000000E-03,
        6.037474400000000E-04,
        0.000000000000000E+00,
        0.000000000000000E+00,
        0.000000000000000E+00,
        0.000000000000000E+00,
        0.000000000000000E+00,
        0.000000000000000E+00,
        0.000000000000000E+00,
        0.000000000000000E+00,
        0.000000000000000E+00,
        0.000000000000000E+00,
        0.000000000000000E+00,
        0.000000000000000E+00,
        0.000000000000000E+00,
        0.000000000000000E+00,
        0.000000000000000E+00,
        0.000000000000000E+00
    ]
}'))
FROM raster_table
WHERE id = 1;

The output is similar to:

{"lineOff":12800.0,"sampOff":4008.0,"latOff":55.0203,"longOff":27.0478,"heightOff":179.0,"lineScale":12800.0,"sampScale":4008.0,"latScale":0.1238,"longScale":0.0685,"heightScale":300.0,"errBias":-1.0,"errRandom":-1.0,"lineDenCoeff":[1.0,-0.00050066513,-0.0014578309,0.00060374744,0.0,0.0,0.0,0.0,0.0,0.0,0.0,0.0,0.0,0.0,0.0,0.0,0.0,0.0,0.0,0.0],"lineNumCoeff":[-0.002104832,-0.01642616,-1.027459,0.0041820025,-0.0019027952,0.000016143133,0.00047863558,-0.00021278669,0.0069588307,-0.0000022605722,-2.2259552e-7,-3.7469372e-7,0.00046486457,-1.8012888e-8,0.000051407583,0.00075661479,-5.4524409e-7,1.3940799e-7,-0.000018281596,2.4215581e-9],"sampDenCoeff":[1.0,-0.00050066513,-0.0014578309,0.00060374744,0.0,0.0,0.0,0.0,0.0,0.0,0.0,0.0,0.0,0.0,0.0,0.0,0.0,0.0,0.0,0.0],"sampNumCoeff":[1.0,-0.00050066513,-0.0014578309,0.00060374744,0.0,0.0,0.0,0.0,0.0,0.0,0.0,0.0,0.0,0.0,0.0,0.0,0.0,0.0,0.0,0.0]}