hsit/webservices-library

Library to access to HSIT elaborated data

0.4.2 2025-04-29 18:59 UTC

This package is auto-updated.

Last update: 2025-05-29 14:26:33 UTC


README

With this library you can get intensity and thematic effect data for quakes, from HSIT infrastructure.

You can set quake using FDSN Event ID (int unique event -earthquake- identifier).

By this library you can fetch the following data:

  • Macroseismic study:
    • MCS, code mcs
    • EMS, code ems
  • Thematic Effects study:
    • Acoustic Effect, code acousticeffect
    • Animals, code animals
    • China, code china
    • Doors, code doors
    • Fear, code fear
    • Forniture, code forniture
    • Hanging Objects, code hangingobjects
    • Liquids, code liquids
    • Pictures, code pictures
    • Small Objects, code smallobjects

using ASCII|JSON|XML data file, fetch from HSIT portal or from local file, and use it like a common associative array.

For Macroseismic studies it will return an array of associative arrays with the following fields ( point, intensity, reports, place )

For Thematic Effect studies it will return an array of associative arrays with the following fields ( point, percentage, reports, place )

Install and usage

See wiki about Install, Autoload and Usage here: https://gitlab.rm.ingv.it/hsit/webservices-library/-/wikis/Home

Documentation

You can find documentation, automatically created by PHPDocumentor here: http://hsit.gitpages.rm.ingv.it/webservices-library/phpdoc/

Test and Deploy

Tests are realized using PHPUnit.

You can find code coverage here: http://hsit.gitpages.rm.ingv.it/webservices-library/coverage/

Contributing

If you want to contribute, please use pull requests.

To get a best integration, please code using Test Driven Development (TDD) and Calisthenic Programming.

Authors and acknowledgment

Diego Sorrentino, Istituto Nazionale di Geofisica e Vulcanologia, https://www.ingv.it/organizzazione/chi-siamo/personale/#922

License

GPL v3

Project status

Development in progress