io.github.kensuke1984.anisotime

クラス RaypathCatalog

java.lang.Object

io.github.kensuke1984.anisotime.RaypathCatalog

すべての実装されたインタフェース:

java.io.Serializable

public class RaypathCatalog
extends java.lang.Object
implements java.io.Serializable

Raypath catalogue for one model

If a new catalog is computed which does not exist in Kibrary share, it automatically is stored.

TODO sorting by dDelta/dp

関連項目:

直列化された形式

フィールドのサマリー

フィールド

修飾子とタイプ	フィールドと説明
static RaypathCatalog	ISO_PREM Catalog for the isotropic PREM.
static RaypathCatalog	PREM Catalog for PREM.

メソッドのサマリー

修飾子とタイプ	メソッドと説明
static RaypathCatalog	computeCatalogue(VelocityStructure structure, ComputationalMesh mesh, double dDelta) We compute epicentral distances Δ(P)i (P or PcP) and Δ(S)i (S or ScS) for ray parameters pi (pi < pi+1) for a catalogue.
Raypath	getPdiff()
Raypath[]	getRaypaths()
Raypath	getSHdiff()
VelocityStructure	getStructure()
Raypath	getSVdiff()
static void	main(java.lang.String[] args) Creates a catalog for a model file (model file, or prem, iprem, ak135).
static RaypathCatalog	read(java.nio.file.Path path, java.nio.file.OpenOption... options)
Raypath[]	searchPath(Phase targetPhase, double eventR, double targetDelta, boolean relativeAngle)
double[]	searchTime(Phase targetPhase, double eventR, double targetDelta, boolean relativeAngle)
void	write(java.nio.file.Path path, java.nio.file.OpenOption... options)

クラスから継承されたメソッド java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

フィールドの詳細

PREM

public static final RaypathCatalog PREM

Catalog for PREM. δΔ = 1. Mesh is simple.

ISO_PREM

public static final RaypathCatalog ISO_PREM

Catalog for the isotropic PREM. δΔ = 1. Mesh is simple.

メソッドの詳細

main

public static void main(java.lang.String[] args)
                 throws java.io.IOException

Creates a catalog for a model file (model file, or prem, iprem, ak135). The catalog computes so densely as any adjacent raypath pairs has smaller gap than (δΔ) in P, PcP, S and ScS. Computation mesh in each part is (inner-core, outer-core and mantle), respectively. (Integral threshold) controls the range for Jeffreys and Jeffreys.

パラメータ:

args - [model file (prem, iprem, ak135 or a polynomial file only now)] [δΔ (deg)] [inner-core] [outer-core] [mantle] intervals [integral threshold (0, 1)]

例外:

java.io.IOException - if any

computeCatalogue

public static RaypathCatalog computeCatalogue(VelocityStructure structure,
                                              ComputationalMesh mesh,
                                              double dDelta)

We compute epicentral distances Δ^(P)_i (P or PcP) and Δ^(S)_i (S or ScS) for ray parameters p_i (p_i < p_i+1) for a catalogue.
If δΔ_i (|Δ_i - Δ_i|) < this value, both p_i and p_i+1 are stored, otherwise either only one of them is stored.

Note that if a catalog for the input parameter already exists in KibraryHOME/share, the stored catalog returns.

パラメータ:

structure - for computation of raypaths

mesh - for computation of raypaths.

dDelta - δΔ [rad] for creation of a catalog.

戻り値:

Catalogue for the input structure

read

public static RaypathCatalog read(java.nio.file.Path path,
                                  java.nio.file.OpenOption... options)
                           throws java.io.IOException,
                                  java.lang.ClassNotFoundException

パラメータ:

path - the path for the catalogue file.

options - open option

戻り値:

Catalogue read from the path

例外:

java.io.IOException - if any

java.lang.ClassNotFoundException - if any

getStructure

public VelocityStructure getStructure()

戻り値:

Velocity structure used in the catalog.

getRaypaths

public Raypath[] getRaypaths()

戻り値:

Raypaths in a catalog in order by the p (ray parameter).

getPdiff

public Raypath getPdiff()

戻り値:

Raypath of Pdiff

getSVdiff

public Raypath getSVdiff()

戻り値:

Raypath of SVdiff

getSHdiff

public Raypath getSHdiff()

戻り値:

Raypath of SHdiff

write

public void write(java.nio.file.Path path,
                  java.nio.file.OpenOption... options)
           throws java.io.IOException

パラメータ:

path - the path to the write file

options - if any

例外:

java.io.IOException - If an I/O error happens. it throws error.

searchPath

public Raypath[] searchPath(Phase targetPhase,
                            double eventR,
                            double targetDelta,
                            boolean relativeAngle)

パラメータ:

targetPhase - target phase

eventR - [km] event radius

targetDelta - [rad] target Δ

relativeAngle - if the input targetDelta is a relative angle.

戻り値:

Arrays of raypaths which epicentral distances are close to the targetDelta. Never returns null. zero length array is possible.

searchTime

public double[] searchTime(Phase targetPhase,
                           double eventR,
                           double targetDelta,
                           boolean relativeAngle)

パラメータ:

targetPhase - target phase

eventR - [km] event radius

targetDelta - [rad] target Δ

relativeAngle - if the targetDelta is a relative value.

戻り値:

[s] arrays of travel times.