xradarSat2


NamexradarSat2 JSON
Version 1.0.15 PyPI version JSON
download
home_page
Summaryxarray/dask distributed L1 sar file reader for radarSat2
upload_time2023-02-03 13:10:01
maintainer
docs_urlNone
author
requires_python>=3.9
licenseMIT
keywords
VCS
bugtrack_url
requirements No requirements were recorded.
Travis-CI No Travis.
coveralls test coverage No coveralls.
            # xsar

radarSat2 Level 1 python reader for efficient xarray/dask based processor



# Install


```
conda install -c conda-forge xradarsat2
```

```pycon
>>> import xradarsat2
>>> folder_path = "/level1/root/directory"
>>> xradarsat2.rs2_reader(folder_path)
DataTree('None', parent=None)
├── DataTree('orbitAndAttitude')
│       Dimensions:    (timeStamp: 7)
│       Coordinates:
│         * timeStamp  (timeStamp) datetime64[ns] 2010-10-15T21:01:32.370461 ... 2010...
│       Data variables:
│           yaw        (timeStamp) float64 3.756 3.773 3.785 3.792 3.807 3.82 3.83
│           roll       (timeStamp) float64 -29.8 -29.8 -29.8 -29.8 -29.8 -29.8 -29.8
│           pitch      (timeStamp) float64 0.002605 0.002862 ... -0.001594 -0.001443
│           xPosition  (timeStamp) float64 -5.072e+06 -5.076e+06 ... -5.087e+06
│           yPosition  (timeStamp) float64 4.643e+06 4.676e+06 ... 4.799e+06 4.828e+06
│           zPosition  (timeStamp) float64 2.033e+06 1.944e+06 ... 1.584e+06 1.494e+06
│           xVelocity  (timeStamp) float64 -425.7 -352.1 -278.6 ... -131.8 -58.51 14.65
│           yVelocity  (timeStamp) float64 2.642e+03 2.58e+03 ... 2.324e+03 2.259e+03
│           zVelocity  (timeStamp) float64 -7.063e+03 -7.09e+03 ... -7.207e+03
│       Attributes:
│           attitudeDataSource:      Downlink
│           attitudeOffsetsApplied:  true
│           Description:             Attitude Information Data Store. Orbit Informati...
├── DataTree('geolocationGrid')
│       Dimensions:    (line: 11, pixel: 11)
│       Coordinates:
│         * line       (line) int64 0 1007 2015 3023 4031 5039 6046 7054 8062 9070 10078
│         * pixel      (pixel) int64 0 1043 2086 3129 4172 ... 6258 7301 8344 9387 10431
│       Data variables:
│           latitude   (line, pixel) float64 17.97 17.89 17.8 ... 12.77 12.67 12.57
│           longitude  (line, pixel) float64 130.4 130.9 131.4 ... 133.3 133.8 134.3
│           height     (line, pixel) float64 0.0 0.0 0.0 0.0 0.0 ... 0.0 0.0 0.0 0.0 0.0
│       Attributes: (12/13)
│           productFormat:                               GeoTIFF
│           outputMediaInterleaving:                     BSQ
│           rasterAttributes_dataType:                   Magnitude Detected
│           rasterAttributes_bitsPerSample_dataStream:   Magnitude
│           rasterAttributes_bitsPerSample_value:        16
│           rasterAttributes_numberOfSamplesPerLine:     10432
│           ...                                          ...
│           rasterAttributes_sampledPixelSpacing_units:  m
│           rasterAttributes_sampledPixelSpacing_value:  50.0
│           rasterAttributes_sampledLineSpacing_units:   m
│           rasterAttributes_sampledLineSpacing_value:   50.0
│           rasterAttributes_lineTimeOrdering:           Increasing
│           rasterAttributes_pixelTimeOrdering:          Decreasing
├── DataTree('imageGenerationParameters')
│   ├── DataTree('doppler')
│   │   ├── DataTree('dopplerCentroid')
│   │   │       Dimensions:                          (timeOfDopplerCentroidEstimate: 5,
│   │   │                                             n-Coefficients: 5)
│   │   │       Coordinates:
│   │   │         * timeOfDopplerCentroidEstimate    (timeOfDopplerCentroidEstimate) datetime64[ns] ...
│   │   │         * n-Coefficients                   (n-Coefficients) int64 0 1 2 3 4
│   │   │       Data variables:
│   │   │           dopplerAmbiguity                 (timeOfDopplerCentroidEstimate) int64 0 ...
│   │   │           dopplerAmbiguityConfidence       (timeOfDopplerCentroidEstimate) float64 ...
│   │   │           dopplerCentroidReferenceTime     (timeOfDopplerCentroidEstimate) float64 ...
│   │   │           dopplerCentroidPolynomialPeriod  (timeOfDopplerCentroidEstimate) float64 ...
│   │   │           dopplerCentroidCoefficients      (timeOfDopplerCentroidEstimate, n-Coefficients) float64 ...
│   │   │           dopplerCentroidConfidence        (timeOfDopplerCentroidEstimate) float64 ...
│   │   │       Attributes:
│   │   │           Description:  Doppler Centroid Data Store
│   │   └── DataTree('dopplerRateValues')
│   │           Dimensions:                   (dopplerRateReferenceTime: 1,
│   │                                          n-RateValuesCoefficients: 3)
│   │           Coordinates:
│   │             * dopplerRateReferenceTime  (dopplerRateReferenceTime) float64 0.005568
│   │             * n-RateValuesCoefficients  (n-RateValuesCoefficients) int64 0 1 2
│   │           Data variables:
│   │               dopplerRateValues         (dopplerRateReferenceTime, n-RateValuesCoefficients) float64 ...
│   │           Attributes:
│   │               Description:  Doppler Rate Values Data Store.
│   └── DataTree('chirp')
│           Dimensions:                  (pole: 1, n-amplitudeCoefficients: 4,
│                                         n-phaseCoefficients: 4)
│           Coordinates:
│             * pole                     (pole) <U2 'VV'
│             * n-amplitudeCoefficients  (n-amplitudeCoefficients) int64 0 1 2 3
│             * n-phaseCoefficients      (n-phaseCoefficients) int64 0 1 2 3
│           Data variables:
│               replicaQualityValid      (pole) <U4 'true'
│               crossCorrelationWidth    (pole) float64 1.033
│               sideLobeLevel            (pole) float64 -13.28
│               integratedSideLobeRatio  (pole) float64 -9.988
│               crossCorrelationPeakLoc  (pole) float64 38.2
│               chirpPower               (pole) float64 63.78
│               amplitudeCoefficients    (pole, n-amplitudeCoefficients) float64 1.0 ... ...
│               phaseCoefficients        (pole, n-phaseCoefficients) float64 0.3395 ... -...
│           Attributes:
│               VV_wing:      Combined
│               VV_pulse:     11.58
│               Description:  Chirp Quality Data Store
├── DataTree('radarParameters')
│       Dimensions:                         (beam: 4, pole: 1, NbOfNoiseLevelValues: 99)
│       Coordinates:
│         * beam                            (beam) <U3 'W1' 'W2' 'W30' 'S7'
│         * pole                            (pole) <U2 'VV'
│       Dimensions without coordinates: NbOfNoiseLevelValues
│       Data variables:
│           pulsesReceivedPerDwell          (beam) int64 58 58 58 58
│           numberOfPulseIntervalsPerDwell  (beam) int64 65 66 65 67
│           rank                            (beam) int64 7 8 7 9
│           settableGain                    (beam, pole) float64 -1.0 -1.0 -1.0 -1.0
│           pulseRepetitionFrequency        (beam) float64 1.283e+03 ... 1.297e+03
│           samplesPerEchoLine              (beam) int64 6768 7920 7944 7320
│           noiseLevelValues_BetaNought     (NbOfNoiseLevelValues) float64 -27.16 ......
│           noiseLevelValues_SigmaNought    (NbOfNoiseLevelValues) float64 -28.36 ......
│           noiseLevelValues_Gamma          (NbOfNoiseLevelValues) float64 -26.5 ... ...
│       Attributes: (12/20)
│           acquisitionType:             ScanSAR Wide
│           beams:                       ['W1', 'W2', 'W30', 'S7']
│           polarizations:               ['VV']
│           pulses:                      11.58
│           radarCenterFrequency_units:  Hz
│           radarCenterFrequency:        5404999242.769673
│           ...                          ...
│           adcSamplingRate_units:       Hz
│           adcSamplingRate:             12667968.75
│           yawSteeringFlag:             YawSteeringOn
│           geodeticFlag:                Off-Geocentric
│           rawBitsPerSample:            4
│           Description:                 Radar Parameters Data Store. Information des...
└── DataTree('lut')
        Dimensions:   (pixels: 10432)
        Coordinates:
          * pixels    (pixels) int64 0 1 2 3 4 5 ... 10426 10427 10428 10429 10430 10431
        Data variables:
            lutBeta   (pixels) float64 1.358e+07 1.358e+07 ... 1.358e+07 1.358e+07
            lutGamma  (pixels) float64 1.164e+07 1.164e+07 ... 3.814e+07 3.815e+07
            lutSigma  (pixels) float64 1.789e+07 1.789e+07 ... 4.049e+07 4.05e+07
        Attributes:
            Description:  RADARSAT Product LUT. (c) COPYRIGHT MacDonald Dettwiler and...
```

            

Raw data

            {
    "_id": null,
    "home_page": "",
    "name": "xradarSat2",
    "maintainer": "",
    "docs_url": null,
    "requires_python": ">=3.9",
    "maintainer_email": "",
    "keywords": "",
    "author": "",
    "author_email": "Yann Reynaud <Yann.Reynaud.2@ifremer.fr>",
    "download_url": "https://files.pythonhosted.org/packages/89/42/718c4ce72ce05a76c48399018a7c6e8dbbe9eee632d7f044978e8f6fc845/xradarSat2-1.0.15.tar.gz",
    "platform": null,
    "description": "# xsar\n\nradarSat2 Level 1 python reader for efficient xarray/dask based processor\n\n\n\n# Install\n\n\n```\nconda install -c conda-forge xradarsat2\n```\n\n```pycon\n>>> import xradarsat2\n>>> folder_path = \"/level1/root/directory\"\n>>> xradarsat2.rs2_reader(folder_path)\nDataTree('None', parent=None)\n\u251c\u2500\u2500 DataTree('orbitAndAttitude')\n\u2502       Dimensions:    (timeStamp: 7)\n\u2502       Coordinates:\n\u2502         * timeStamp  (timeStamp) datetime64[ns] 2010-10-15T21:01:32.370461 ... 2010...\n\u2502       Data variables:\n\u2502           yaw        (timeStamp) float64 3.756 3.773 3.785 3.792 3.807 3.82 3.83\n\u2502           roll       (timeStamp) float64 -29.8 -29.8 -29.8 -29.8 -29.8 -29.8 -29.8\n\u2502           pitch      (timeStamp) float64 0.002605 0.002862 ... -0.001594 -0.001443\n\u2502           xPosition  (timeStamp) float64 -5.072e+06 -5.076e+06 ... -5.087e+06\n\u2502           yPosition  (timeStamp) float64 4.643e+06 4.676e+06 ... 4.799e+06 4.828e+06\n\u2502           zPosition  (timeStamp) float64 2.033e+06 1.944e+06 ... 1.584e+06 1.494e+06\n\u2502           xVelocity  (timeStamp) float64 -425.7 -352.1 -278.6 ... -131.8 -58.51 14.65\n\u2502           yVelocity  (timeStamp) float64 2.642e+03 2.58e+03 ... 2.324e+03 2.259e+03\n\u2502           zVelocity  (timeStamp) float64 -7.063e+03 -7.09e+03 ... -7.207e+03\n\u2502       Attributes:\n\u2502           attitudeDataSource:      Downlink\n\u2502           attitudeOffsetsApplied:  true\n\u2502           Description:             Attitude Information Data Store. Orbit Informati...\n\u251c\u2500\u2500 DataTree('geolocationGrid')\n\u2502       Dimensions:    (line: 11, pixel: 11)\n\u2502       Coordinates:\n\u2502         * line       (line) int64 0 1007 2015 3023 4031 5039 6046 7054 8062 9070 10078\n\u2502         * pixel      (pixel) int64 0 1043 2086 3129 4172 ... 6258 7301 8344 9387 10431\n\u2502       Data variables:\n\u2502           latitude   (line, pixel) float64 17.97 17.89 17.8 ... 12.77 12.67 12.57\n\u2502           longitude  (line, pixel) float64 130.4 130.9 131.4 ... 133.3 133.8 134.3\n\u2502           height     (line, pixel) float64 0.0 0.0 0.0 0.0 0.0 ... 0.0 0.0 0.0 0.0 0.0\n\u2502       Attributes: (12/13)\n\u2502           productFormat:                               GeoTIFF\n\u2502           outputMediaInterleaving:                     BSQ\n\u2502           rasterAttributes_dataType:                   Magnitude Detected\n\u2502           rasterAttributes_bitsPerSample_dataStream:   Magnitude\n\u2502           rasterAttributes_bitsPerSample_value:        16\n\u2502           rasterAttributes_numberOfSamplesPerLine:     10432\n\u2502           ...                                          ...\n\u2502           rasterAttributes_sampledPixelSpacing_units:  m\n\u2502           rasterAttributes_sampledPixelSpacing_value:  50.0\n\u2502           rasterAttributes_sampledLineSpacing_units:   m\n\u2502           rasterAttributes_sampledLineSpacing_value:   50.0\n\u2502           rasterAttributes_lineTimeOrdering:           Increasing\n\u2502           rasterAttributes_pixelTimeOrdering:          Decreasing\n\u251c\u2500\u2500 DataTree('imageGenerationParameters')\n\u2502   \u251c\u2500\u2500 DataTree('doppler')\n\u2502   \u2502   \u251c\u2500\u2500 DataTree('dopplerCentroid')\n\u2502   \u2502   \u2502       Dimensions:                          (timeOfDopplerCentroidEstimate: 5,\n\u2502   \u2502   \u2502                                             n-Coefficients: 5)\n\u2502   \u2502   \u2502       Coordinates:\n\u2502   \u2502   \u2502         * timeOfDopplerCentroidEstimate    (timeOfDopplerCentroidEstimate) datetime64[ns] ...\n\u2502   \u2502   \u2502         * n-Coefficients                   (n-Coefficients) int64 0 1 2 3 4\n\u2502   \u2502   \u2502       Data variables:\n\u2502   \u2502   \u2502           dopplerAmbiguity                 (timeOfDopplerCentroidEstimate) int64 0 ...\n\u2502   \u2502   \u2502           dopplerAmbiguityConfidence       (timeOfDopplerCentroidEstimate) float64 ...\n\u2502   \u2502   \u2502           dopplerCentroidReferenceTime     (timeOfDopplerCentroidEstimate) float64 ...\n\u2502   \u2502   \u2502           dopplerCentroidPolynomialPeriod  (timeOfDopplerCentroidEstimate) float64 ...\n\u2502   \u2502   \u2502           dopplerCentroidCoefficients      (timeOfDopplerCentroidEstimate, n-Coefficients) float64 ...\n\u2502   \u2502   \u2502           dopplerCentroidConfidence        (timeOfDopplerCentroidEstimate) float64 ...\n\u2502   \u2502   \u2502       Attributes:\n\u2502   \u2502   \u2502           Description:  Doppler Centroid Data Store\n\u2502   \u2502   \u2514\u2500\u2500 DataTree('dopplerRateValues')\n\u2502   \u2502           Dimensions:                   (dopplerRateReferenceTime: 1,\n\u2502   \u2502                                          n-RateValuesCoefficients: 3)\n\u2502   \u2502           Coordinates:\n\u2502   \u2502             * dopplerRateReferenceTime  (dopplerRateReferenceTime) float64 0.005568\n\u2502   \u2502             * n-RateValuesCoefficients  (n-RateValuesCoefficients) int64 0 1 2\n\u2502   \u2502           Data variables:\n\u2502   \u2502               dopplerRateValues         (dopplerRateReferenceTime, n-RateValuesCoefficients) float64 ...\n\u2502   \u2502           Attributes:\n\u2502   \u2502               Description:  Doppler Rate Values Data Store.\n\u2502   \u2514\u2500\u2500 DataTree('chirp')\n\u2502           Dimensions:                  (pole: 1, n-amplitudeCoefficients: 4,\n\u2502                                         n-phaseCoefficients: 4)\n\u2502           Coordinates:\n\u2502             * pole                     (pole) <U2 'VV'\n\u2502             * n-amplitudeCoefficients  (n-amplitudeCoefficients) int64 0 1 2 3\n\u2502             * n-phaseCoefficients      (n-phaseCoefficients) int64 0 1 2 3\n\u2502           Data variables:\n\u2502               replicaQualityValid      (pole) <U4 'true'\n\u2502               crossCorrelationWidth    (pole) float64 1.033\n\u2502               sideLobeLevel            (pole) float64 -13.28\n\u2502               integratedSideLobeRatio  (pole) float64 -9.988\n\u2502               crossCorrelationPeakLoc  (pole) float64 38.2\n\u2502               chirpPower               (pole) float64 63.78\n\u2502               amplitudeCoefficients    (pole, n-amplitudeCoefficients) float64 1.0 ... ...\n\u2502               phaseCoefficients        (pole, n-phaseCoefficients) float64 0.3395 ... -...\n\u2502           Attributes:\n\u2502               VV_wing:      Combined\n\u2502               VV_pulse:     11.58\n\u2502               Description:  Chirp Quality Data Store\n\u251c\u2500\u2500 DataTree('radarParameters')\n\u2502       Dimensions:                         (beam: 4, pole: 1, NbOfNoiseLevelValues: 99)\n\u2502       Coordinates:\n\u2502         * beam                            (beam) <U3 'W1' 'W2' 'W30' 'S7'\n\u2502         * pole                            (pole) <U2 'VV'\n\u2502       Dimensions without coordinates: NbOfNoiseLevelValues\n\u2502       Data variables:\n\u2502           pulsesReceivedPerDwell          (beam) int64 58 58 58 58\n\u2502           numberOfPulseIntervalsPerDwell  (beam) int64 65 66 65 67\n\u2502           rank                            (beam) int64 7 8 7 9\n\u2502           settableGain                    (beam, pole) float64 -1.0 -1.0 -1.0 -1.0\n\u2502           pulseRepetitionFrequency        (beam) float64 1.283e+03 ... 1.297e+03\n\u2502           samplesPerEchoLine              (beam) int64 6768 7920 7944 7320\n\u2502           noiseLevelValues_BetaNought     (NbOfNoiseLevelValues) float64 -27.16 ......\n\u2502           noiseLevelValues_SigmaNought    (NbOfNoiseLevelValues) float64 -28.36 ......\n\u2502           noiseLevelValues_Gamma          (NbOfNoiseLevelValues) float64 -26.5 ... ...\n\u2502       Attributes: (12/20)\n\u2502           acquisitionType:             ScanSAR Wide\n\u2502           beams:                       ['W1', 'W2', 'W30', 'S7']\n\u2502           polarizations:               ['VV']\n\u2502           pulses:                      11.58\n\u2502           radarCenterFrequency_units:  Hz\n\u2502           radarCenterFrequency:        5404999242.769673\n\u2502           ...                          ...\n\u2502           adcSamplingRate_units:       Hz\n\u2502           adcSamplingRate:             12667968.75\n\u2502           yawSteeringFlag:             YawSteeringOn\n\u2502           geodeticFlag:                Off-Geocentric\n\u2502           rawBitsPerSample:            4\n\u2502           Description:                 Radar Parameters Data Store. Information des...\n\u2514\u2500\u2500 DataTree('lut')\n        Dimensions:   (pixels: 10432)\n        Coordinates:\n          * pixels    (pixels) int64 0 1 2 3 4 5 ... 10426 10427 10428 10429 10430 10431\n        Data variables:\n            lutBeta   (pixels) float64 1.358e+07 1.358e+07 ... 1.358e+07 1.358e+07\n            lutGamma  (pixels) float64 1.164e+07 1.164e+07 ... 3.814e+07 3.815e+07\n            lutSigma  (pixels) float64 1.789e+07 1.789e+07 ... 4.049e+07 4.05e+07\n        Attributes:\n            Description:  RADARSAT Product LUT. (c) COPYRIGHT MacDonald Dettwiler and...\n```\n",
    "bugtrack_url": null,
    "license": "MIT",
    "summary": "xarray/dask distributed L1 sar file reader for radarSat2",
    "version": "1.0.15",
    "split_keywords": [],
    "urls": [
        {
            "comment_text": "",
            "digests": {
                "blake2b_256": "1c7e066fff958b8f28ce18c9159abd5556633c655efe409e1d19dfc0cae0a65d",
                "md5": "77fa8101ca8d59f4f58085a2f54262ab",
                "sha256": "8e3ef2c8900c515dcf4df90fc3d0761bffb202f50593ae6e9c955d9f3efd2b8a"
            },
            "downloads": -1,
            "filename": "xradarSat2-1.0.15-py3-none-any.whl",
            "has_sig": false,
            "md5_digest": "77fa8101ca8d59f4f58085a2f54262ab",
            "packagetype": "bdist_wheel",
            "python_version": "py3",
            "requires_python": ">=3.9",
            "size": 32582,
            "upload_time": "2023-02-03T13:09:44",
            "upload_time_iso_8601": "2023-02-03T13:09:44.927914Z",
            "url": "https://files.pythonhosted.org/packages/1c/7e/066fff958b8f28ce18c9159abd5556633c655efe409e1d19dfc0cae0a65d/xradarSat2-1.0.15-py3-none-any.whl",
            "yanked": false,
            "yanked_reason": null
        },
        {
            "comment_text": "",
            "digests": {
                "blake2b_256": "8942718c4ce72ce05a76c48399018a7c6e8dbbe9eee632d7f044978e8f6fc845",
                "md5": "890eed937c783789f4982833d15c027d",
                "sha256": "1ebeccdc965a45c6b3ed0fdc7eb40ab357afd94580bc44d819836d147db6072b"
            },
            "downloads": -1,
            "filename": "xradarSat2-1.0.15.tar.gz",
            "has_sig": false,
            "md5_digest": "890eed937c783789f4982833d15c027d",
            "packagetype": "sdist",
            "python_version": "source",
            "requires_python": ">=3.9",
            "size": 3360131,
            "upload_time": "2023-02-03T13:10:01",
            "upload_time_iso_8601": "2023-02-03T13:10:01.255474Z",
            "url": "https://files.pythonhosted.org/packages/89/42/718c4ce72ce05a76c48399018a7c6e8dbbe9eee632d7f044978e8f6fc845/xradarSat2-1.0.15.tar.gz",
            "yanked": false,
            "yanked_reason": null
        }
    ],
    "upload_time": "2023-02-03 13:10:01",
    "github": false,
    "gitlab": false,
    "bitbucket": false,
    "lcname": "xradarsat2"
}
        
Elapsed time: 0.12328s