Last updated

API / geotoolkit / seismic / data / SeismicReader / SeismicReader

Class: SeismicReader

data.SeismicReader.SeismicReader

Seismic reader reads seismic data from the different sources and provides it to trace processor in uniform representation as a collection of traces,
where a trace is a collection of samples. A trace is logically subdivided into zero or more trace headers and zero or more samples.
Seismic Reader also returns information about seismic data, like number of many traces it has, number of samples per trace,
unit of samples, sample rate and also provides trace headers information.

Hierarchy

Table of contents

Constructors
Methods

Contents

Constructors

new SeismicReader(options)

Protected new SeismicReader(options?)

Creates reader

Parameters

Name Type Description
Optional optionsnumber | OptionsnullValue or options is passed when a value does not exist. There will be a break in the wiggles in that area. Fill will not fill that area. User can set a custom color for NullValue

Overrides

SeismicData.constructor

Methods

copyConstructor

Protected copyConstructor(src, deepCopy?): SeismicReader

Copy constructor function.
Function used as part of the cloning mechanism.
Implementations should copy the given instance state to this instance.

Parameters

Name Type Description
srcSeismicReaderSource to copy from
Optional deepCopybooleandeep copy

Returns

SeismicReader

this


dispose

dispose(): void

Dispose.

Returns

void

Inherited from

SeismicData.dispose


getClassName

getClassName(): string

Returns

string

Inherited from

SeismicData.getClassName


getMetaData

Abstract getMetaData(): SeismicMetaData

Returns seismic meta data information

Returns

SeismicMetaData

Inherited from

SeismicData.getMetaData


getModelLimits

Abstract getModelLimits(): Rect

Returns seismic model limits

Returns

Rect


getNullValue

getNullValue(): number

Returns null value

Returns

number

null value


getNumberOfSamples

Abstract getNumberOfSamples(): number

Returns number of samples

Returns

number


getNumberOfTraces

Abstract getNumberOfTraces(): number

Returns number of traces

Returns

number


getOptions

getOptions(): any

Returns supported extra options

Returns

any

options options


getOriginalMetaData

getOriginalMetaData(): SeismicMetaData

Returns seismic original meta data information before any decimation

Returns

SeismicMetaData


getSampleRate

Abstract getSampleRate(): number

Returns sample rate . Sample rate is the number of times an analog signal is measured (sampled) per second.
Basically it is a difference between nearest sample values. This term comes from digital signal processing and defines how
continuous signal is sampled. For example: 0.004/ second

Returns

number


getStatistics

Abstract getStatistics(): Statistics

Gets statistics such as min, max, average, rms

Returns

Statistics


getTimeStamp

getTimeStamp(): number

Return the value to indicate if data was changed

Returns

number

Inherited from

SeismicData.getTimeStamp


getTraceHeaderFields

Abstract getTraceHeaderFields(): FieldDesc[]

Returns an array of field descriptors for the dataset read by this seismic reader.

Returns

FieldDesc[]


hasEventListener

hasEventListener(type, callback?): boolean

Check if a list of event listeners for this type contains this listener

Parameters

Name Type Description
typestringtype of event or property
Optional callbackFunctionto be called, if null, check if any callback is registered

Returns

boolean

Inherited from

SeismicData.hasEventListener


invalidate

invalidate(rect?): void

Invalidate data and notify that data is changed

Parameters

Name Type Description
Optional rectRectoptional area of tracers and samples to invalidate. It is not supported now

Returns

void

Inherited from

SeismicData.invalidate


isDisposed

isDisposed(): boolean

Returns whether this object has been disposed

Returns

boolean

Inherited from

SeismicData.isDisposed


isSilent

isSilent(): boolean

Return true if the event dispatcher doesn't notify any events

Returns

boolean

Inherited from

SeismicData.isSilent


loadMetaData

Abstract loadMetaData(callback): void

Load SeismicMetaData seismic metadata. Seismic metadata is a map of general properties of the seismic data source like: number of traces, sample rate.

Parameters

Name Type Description
callback(reader: SeismicReader) => voidmethod to be called when data is ready

Returns

void


notify

notify<E>(type, source, args?): SeismicReader

Notify listeners

Type parameters

NameType
Eextends string

Parameters

Name Type Description
typeEevent types
sourceSeismicReaderof the event
Optional argsEventMap[E]arguments of the event

Returns

SeismicReader

this

Overrides

SeismicData.notify


off

off<E>(type?, callback?): SeismicReader

Detach listener on event. Calling .off() with no arguments removes all attached listeners. Calling .off(type) with no callback removes all attached listeners for specific type.

Type parameters

NameType
Eextends string

Parameters

Name Type Description
Optional typeEtype of the event
Optional callback(eventType: E, sender: SeismicReader, args: EventMap[E]) => voidfunction to be called

Returns

SeismicReader

this

Overrides

SeismicData.off


on

on<E>(type, callback): SeismicReader

Attach listener on event that will be called whenever the specified event is delivered to the target

If the callback function is already in the list of event listeners for this target, the function is not added a second time.

If a particular anonymous function is in the list of event listeners registered for a certain target, and then later in the code, an identical anonymous function is given in an "on" call, the second function will also be added to the list of event listeners for that target.

Type parameters

NameType
Eextends string

Parameters

Name Type Description
typeEtype of event or property
callback(eventType: E, sender: SeismicReader, args: EventMap[E]) => voidto be called

Returns

SeismicReader

this

Overrides

SeismicData.on


queryInterface

queryInterface<T>(someInterface): InstanceType<T>

Returns interface, if reader can provide it

Type parameters

NameType
Textends Constructor<any>

Parameters

Name Type Description
someInterfaceTinterface

Returns

InstanceType<T>

internal instance of this interface


select

Abstract select(query, callback): void

returns seismic trace section

Example

// to read a specific range of traces
reader.select({
'from': 10,
'to': 20
}, (fetchResult) => {
// fetchResult is instance of @int/geotoolkit/seismic/data/QueryResult
fetchResult.foreach((index, section) => {
for (let i = 10; i <= 20; i++) {
console.log(section.getTrace(i));
}
});
});

Example

//  selection by trace indices
reader.select({
'traceIndexes': [15, 20]
}, (fetchResult) => { ... });

Parameters

Name Type Description
querySelectQuerythis specifies the condition of the request
callbackSelectCallbackmethod to be called when data is ready

Returns

void

Overrides

SeismicData.select


setSilent

setSilent(bool): SeismicReader

Set silent mode

Parameters

Name Type Description
boolbooleanflag to enable silent mode

Returns

SeismicReader

this

Inherited from

SeismicData.setSilent


update

update(options?, callback?): void

Update seismic query and returns meta information

Parameters

Name Type Description
Optional optionsRecord<string, any>this specifies the condition of the request
Optional callbackUpdateCallbackmethod to be called when data is ready

Returns

void


updateTimeStamp

Protected updateTimeStamp(): void

Update time stamp

Returns

void

Inherited from

SeismicData.updateTimeStamp


getClassName

Static getClassName(): string

Returns

string

Inherited from

SeismicData.getClassName