You cannot select more than 25 topics
Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
321 lines
11 KiB
C
321 lines
11 KiB
C
1 year ago
|
/***************************************************************************
|
||
|
* Copyright (C) gempa GmbH *
|
||
|
* All rights reserved. *
|
||
|
* Contact: gempa GmbH (seiscomp-dev@gempa.de) *
|
||
|
* *
|
||
|
* GNU Affero General Public License Usage *
|
||
|
* This file may be used under the terms of the GNU Affero *
|
||
|
* Public License version 3.0 as published by the Free Software Foundation *
|
||
|
* and appearing in the file LICENSE included in the packaging of this *
|
||
|
* file. Please review the following information to ensure the GNU Affero *
|
||
|
* Public License version 3.0 requirements will be met: *
|
||
|
* https://www.gnu.org/licenses/agpl-3.0.html. *
|
||
|
* *
|
||
|
* Other Usage *
|
||
|
* Alternatively, this file may be used in accordance with the terms and *
|
||
|
* conditions contained in a signed written agreement between you and *
|
||
|
* gempa GmbH. *
|
||
|
***************************************************************************/
|
||
|
|
||
|
|
||
|
#ifndef SEISCOMP_DATAMODEL_MOMENTTENSOR_H
|
||
|
#define SEISCOMP_DATAMODEL_MOMENTTENSOR_H
|
||
|
|
||
|
|
||
|
#include <string>
|
||
|
#include <seiscomp/datamodel/realquantity.h>
|
||
|
#include <seiscomp/datamodel/tensor.h>
|
||
|
#include <seiscomp/datamodel/sourcetimefunction.h>
|
||
|
#include <seiscomp/datamodel/types.h>
|
||
|
#include <seiscomp/datamodel/creationinfo.h>
|
||
|
#include <vector>
|
||
|
#include <seiscomp/datamodel/comment.h>
|
||
|
#include <seiscomp/datamodel/momenttensorphasesetting.h>
|
||
|
#include <seiscomp/datamodel/notifier.h>
|
||
|
#include <seiscomp/datamodel/publicobject.h>
|
||
|
#include <seiscomp/core/exceptions.h>
|
||
|
|
||
|
|
||
|
namespace Seiscomp {
|
||
|
namespace DataModel {
|
||
|
|
||
|
|
||
|
DEFINE_SMARTPOINTER(MomentTensor);
|
||
|
DEFINE_SMARTPOINTER(Comment);
|
||
|
DEFINE_SMARTPOINTER(DataUsed);
|
||
|
DEFINE_SMARTPOINTER(MomentTensorPhaseSetting);
|
||
|
DEFINE_SMARTPOINTER(MomentTensorStationContribution);
|
||
|
|
||
|
class FocalMechanism;
|
||
|
|
||
|
|
||
|
/**
|
||
|
* \brief This class represents a moment tensor solution for an
|
||
|
* \brief event. It is an
|
||
|
* \brief optional part of a FocalMechanism description.
|
||
|
*/
|
||
|
class SC_SYSTEM_CORE_API MomentTensor : public PublicObject {
|
||
|
DECLARE_SC_CLASS(MomentTensor)
|
||
|
DECLARE_SERIALIZATION;
|
||
|
DECLARE_METAOBJECT;
|
||
|
|
||
|
// ------------------------------------------------------------------
|
||
|
// Xstruction
|
||
|
// ------------------------------------------------------------------
|
||
|
protected:
|
||
|
//! Protected constructor
|
||
|
MomentTensor();
|
||
|
|
||
|
public:
|
||
|
//! Copy constructor
|
||
|
MomentTensor(const MomentTensor& other);
|
||
|
|
||
|
//! Constructor with publicID
|
||
|
MomentTensor(const std::string& publicID);
|
||
|
|
||
|
//! Destructor
|
||
|
~MomentTensor() override;
|
||
|
|
||
|
|
||
|
// ------------------------------------------------------------------
|
||
|
// Creators
|
||
|
// ------------------------------------------------------------------
|
||
|
public:
|
||
|
static MomentTensor* Create();
|
||
|
static MomentTensor* Create(const std::string& publicID);
|
||
|
|
||
|
|
||
|
// ------------------------------------------------------------------
|
||
|
// Lookup
|
||
|
// ------------------------------------------------------------------
|
||
|
public:
|
||
|
static MomentTensor* Find(const std::string& publicID);
|
||
|
|
||
|
|
||
|
// ------------------------------------------------------------------
|
||
|
// Operators
|
||
|
// ------------------------------------------------------------------
|
||
|
public:
|
||
|
//! Copies the metadata of other to this
|
||
|
//! No changes regarding child objects are made
|
||
|
MomentTensor& operator=(const MomentTensor& other);
|
||
|
//! Checks for equality of two objects. Child objects
|
||
|
//! are not part of the check.
|
||
|
bool operator==(const MomentTensor& other) const;
|
||
|
bool operator!=(const MomentTensor& other) const;
|
||
|
|
||
|
//! Wrapper that calls operator==
|
||
|
bool equal(const MomentTensor& other) const;
|
||
|
|
||
|
|
||
|
// ------------------------------------------------------------------
|
||
|
// Setters/Getters
|
||
|
// ------------------------------------------------------------------
|
||
|
public:
|
||
|
//! Refers to the publicID of the Origin derived in the moment
|
||
|
//! tensor inversion.
|
||
|
void setDerivedOriginID(const std::string& derivedOriginID);
|
||
|
const std::string& derivedOriginID() const;
|
||
|
|
||
|
//! Refers to the publicID of the Magnitude object which
|
||
|
//! represents the derived moment
|
||
|
//! magnitude.
|
||
|
void setMomentMagnitudeID(const std::string& momentMagnitudeID);
|
||
|
const std::string& momentMagnitudeID() const;
|
||
|
|
||
|
//! Scalar moment as derived in moment tensor inversion in Nm.
|
||
|
void setScalarMoment(const OPT(RealQuantity)& scalarMoment);
|
||
|
RealQuantity& scalarMoment();
|
||
|
const RealQuantity& scalarMoment() const;
|
||
|
|
||
|
//! Tensor object holding the moment tensor elements.
|
||
|
void setTensor(const OPT(Tensor)& tensor);
|
||
|
Tensor& tensor();
|
||
|
const Tensor& tensor() const;
|
||
|
|
||
|
//! Variance of moment tensor inversion.
|
||
|
void setVariance(const OPT(double)& variance);
|
||
|
double variance() const;
|
||
|
|
||
|
//! Variance reduction of moment tensor inversion, given in
|
||
|
//! percent (Dreger 2003). This is a
|
||
|
//! goodness-of-fit measure.
|
||
|
void setVarianceReduction(const OPT(double)& varianceReduction);
|
||
|
double varianceReduction() const;
|
||
|
|
||
|
//! Double couple parameter obtained from moment tensor
|
||
|
//! inversion (decimal fraction between 0
|
||
|
//! and 1).
|
||
|
void setDoubleCouple(const OPT(double)& doubleCouple);
|
||
|
double doubleCouple() const;
|
||
|
|
||
|
//! CLVD (compensated linear vector dipole) parameter obtained
|
||
|
//! from moment tensor inversion (decimal
|
||
|
//! fraction between 0 and 1).
|
||
|
void setClvd(const OPT(double)& clvd);
|
||
|
double clvd() const;
|
||
|
|
||
|
//! Isotropic part obtained from moment tensor inversion
|
||
|
//! (decimal fraction between 0 and 1).
|
||
|
void setIso(const OPT(double)& iso);
|
||
|
double iso() const;
|
||
|
|
||
|
//! Resource identifier of the Green's function used in moment
|
||
|
//! tensor inversion.
|
||
|
void setGreensFunctionID(const std::string& greensFunctionID);
|
||
|
const std::string& greensFunctionID() const;
|
||
|
|
||
|
//! Resource identifier of the filter setup used in moment
|
||
|
//! tensor inversion.
|
||
|
void setFilterID(const std::string& filterID);
|
||
|
const std::string& filterID() const;
|
||
|
|
||
|
//! Source time function used in moment-tensor inversion.
|
||
|
void setSourceTimeFunction(const OPT(SourceTimeFunction)& sourceTimeFunction);
|
||
|
SourceTimeFunction& sourceTimeFunction();
|
||
|
const SourceTimeFunction& sourceTimeFunction() const;
|
||
|
|
||
|
//! Resource identifier of the method used for moment-tensor
|
||
|
//! inversion.
|
||
|
void setMethodID(const std::string& methodID);
|
||
|
const std::string& methodID() const;
|
||
|
|
||
|
//! Moment tensor method used.
|
||
|
void setMethod(const OPT(MomentTensorMethod)& method);
|
||
|
MomentTensorMethod method() const;
|
||
|
|
||
|
//! Status of moment tensor.
|
||
|
void setStatus(const OPT(MomentTensorStatus)& status);
|
||
|
MomentTensorStatus status() const;
|
||
|
|
||
|
void setCmtName(const std::string& cmtName);
|
||
|
const std::string& cmtName() const;
|
||
|
|
||
|
void setCmtVersion(const std::string& cmtVersion);
|
||
|
const std::string& cmtVersion() const;
|
||
|
|
||
|
//! CreationInfo for the MomentTensor object.
|
||
|
void setCreationInfo(const OPT(CreationInfo)& creationInfo);
|
||
|
CreationInfo& creationInfo();
|
||
|
const CreationInfo& creationInfo() const;
|
||
|
|
||
|
|
||
|
// ------------------------------------------------------------------
|
||
|
// Public interface
|
||
|
// ------------------------------------------------------------------
|
||
|
public:
|
||
|
/**
|
||
|
* Add an object.
|
||
|
* @param obj The object pointer
|
||
|
* @return true The object has been added
|
||
|
* @return false The object has not been added
|
||
|
* because it already exists in the list
|
||
|
* or it already has another parent
|
||
|
*/
|
||
|
bool add(Comment* obj);
|
||
|
bool add(DataUsed* obj);
|
||
|
bool add(MomentTensorPhaseSetting* obj);
|
||
|
bool add(MomentTensorStationContribution* obj);
|
||
|
|
||
|
/**
|
||
|
* Removes an object.
|
||
|
* @param obj The object pointer
|
||
|
* @return true The object has been removed
|
||
|
* @return false The object has not been removed
|
||
|
* because it does not exist in the list
|
||
|
*/
|
||
|
bool remove(Comment* obj);
|
||
|
bool remove(DataUsed* obj);
|
||
|
bool remove(MomentTensorPhaseSetting* obj);
|
||
|
bool remove(MomentTensorStationContribution* obj);
|
||
|
|
||
|
/**
|
||
|
* Removes an object of a particular class.
|
||
|
* @param i The object index
|
||
|
* @return true The object has been removed
|
||
|
* @return false The index is out of bounds
|
||
|
*/
|
||
|
bool removeComment(size_t i);
|
||
|
bool removeComment(const CommentIndex& i);
|
||
|
bool removeDataUsed(size_t i);
|
||
|
bool removeMomentTensorPhaseSetting(size_t i);
|
||
|
bool removeMomentTensorPhaseSetting(const MomentTensorPhaseSettingIndex& i);
|
||
|
bool removeMomentTensorStationContribution(size_t i);
|
||
|
|
||
|
//! Retrieve the number of objects of a particular class
|
||
|
size_t commentCount() const;
|
||
|
size_t dataUsedCount() const;
|
||
|
size_t momentTensorPhaseSettingCount() const;
|
||
|
size_t momentTensorStationContributionCount() const;
|
||
|
|
||
|
//! Index access
|
||
|
//! @return The object at index i
|
||
|
Comment* comment(size_t i) const;
|
||
|
Comment* comment(const CommentIndex& i) const;
|
||
|
DataUsed* dataUsed(size_t i) const;
|
||
|
|
||
|
MomentTensorPhaseSetting* momentTensorPhaseSetting(size_t i) const;
|
||
|
MomentTensorPhaseSetting* momentTensorPhaseSetting(const MomentTensorPhaseSettingIndex& i) const;
|
||
|
MomentTensorStationContribution* momentTensorStationContribution(size_t i) const;
|
||
|
|
||
|
//! Find an object by its unique attribute(s)
|
||
|
DataUsed* findDataUsed(DataUsed* dataUsed) const;
|
||
|
MomentTensorStationContribution* findMomentTensorStationContribution(const std::string& publicID) const;
|
||
|
|
||
|
FocalMechanism* focalMechanism() const;
|
||
|
|
||
|
//! Implement Object interface
|
||
|
bool assign(Object *other) override;
|
||
|
bool attachTo(PublicObject *parent) override;
|
||
|
bool detachFrom(PublicObject *parent) override;
|
||
|
bool detach() override;
|
||
|
|
||
|
//! Creates a clone
|
||
|
Object *clone() const override;
|
||
|
|
||
|
//! Implement PublicObject interface
|
||
|
bool updateChild(Object *child) override;
|
||
|
|
||
|
void accept(Visitor *visitor) override;
|
||
|
|
||
|
|
||
|
// ------------------------------------------------------------------
|
||
|
// Implementation
|
||
|
// ------------------------------------------------------------------
|
||
|
private:
|
||
|
// Attributes
|
||
|
std::string _derivedOriginID;
|
||
|
std::string _momentMagnitudeID;
|
||
|
OPT(RealQuantity) _scalarMoment;
|
||
|
OPT(Tensor) _tensor;
|
||
|
OPT(double) _variance;
|
||
|
OPT(double) _varianceReduction;
|
||
|
OPT(double) _doubleCouple;
|
||
|
OPT(double) _clvd;
|
||
|
OPT(double) _iso;
|
||
|
std::string _greensFunctionID;
|
||
|
std::string _filterID;
|
||
|
OPT(SourceTimeFunction) _sourceTimeFunction;
|
||
|
std::string _methodID;
|
||
|
OPT(MomentTensorMethod) _method;
|
||
|
OPT(MomentTensorStatus) _status;
|
||
|
std::string _cmtName;
|
||
|
std::string _cmtVersion;
|
||
|
OPT(CreationInfo) _creationInfo;
|
||
|
|
||
|
// Aggregations
|
||
|
std::vector<CommentPtr> _comments;
|
||
|
std::vector<DataUsedPtr> _dataUseds;
|
||
|
std::vector<MomentTensorPhaseSettingPtr> _momentTensorPhaseSettings;
|
||
|
std::vector<MomentTensorStationContributionPtr> _momentTensorStationContributions;
|
||
|
|
||
|
DECLARE_SC_CLASSFACTORY_FRIEND(MomentTensor);
|
||
|
};
|
||
|
|
||
|
|
||
|
}
|
||
|
}
|
||
|
|
||
|
|
||
|
#endif
|