sardine.acquisition package

Submodules

sardine.acquisition.acquisition module

sardine.acquisition.acquisition_history module

class sardine.acquisition.acquisition_history.AcquisitionHistory

Bases: object

last_lines_completed()

Sets the last shot as the last line name of the source history, or None if there is none Sets the last deployment as the last line name of the receiver deployment history, or None if there is none Sets the last recovery as the last line name of the receiver recovery history, or None if there is none Returns the last shot, last deployment and last recovery

mark_receiver_line_deployed(seismic_line, line_name, time)

Creates an instance of AcquisitionHistoryItem, passing the given seismic line, line name and time Appends that instance to the receiver deployment history

mark_receiver_line_recovered(seismic_line, line_name, time)

Creates an instance of AcquisitionHistoryItem, passing the given seismic line, line name and time Appends that instance to the receiver recovery history

mark_source_line_shot(seismic_line, line_name, time)

Creates an instance of AcquisitionHistoryItem, passing the given seismic line, line name and time Appends that instance to the source history

progress_coords_at(time)

Gets the status at the given time with the function ‘_status_at Creates an empty dictionary of coordinates with categories ‘shot’, ‘deployed’ and ‘recovered’

Explains logic:

Loops for each item in the status:
- For each seismic line:
    - Gets the extremities (coordinates)
    - Appends the coordinates to the right category of the coordinates dictionary

Returns the coordinates dictionary

class sardine.acquisition.acquisition_history.AcquisitionHistoryItem(seismic_line, line_name, completion_time)

Bases: object

is_completed(time)

Chaeks if the given time is lower (before) the completion time Returns False if it is not (not completed), and True if it is (completed)

property line_name

Returns the line line

property seismic_line

Returns the seismic line

sardine.acquisition.acquisition_sequence module

class sardine.acquisition.acquisition_sequence.AcquisitionSequence

Bases: object

add(action, dependencies=())

Appends the given action to the sequence Adds the given dependencies and action to the waits

first_action()

Returns the first element of the sequence Or an error if there is none

mark_dependencies_met(*dependencies)

Removes the waits with instanced dependencies using ‘mark_dependencies_met’ from waits.py

pop_next_actions(count)

This function’s purpose is to pop the next sequence of actions (up to the given count), excluding delays (AdditionalDelay), and stopping early if a waiting condition is encountered or a different action type appears. Let’s see the steps: If there is no sequence, it returns None Creates an empty ‘actions’ If there is a sequence, it loops through it: - If the action is not a delay: stops (break) if we have collected ‘count’ non-delay actions - If there is an action but it’s not a delay: checks if the action differs to the previous one, and breaks if it does - If a wait exists, it sets the waiting_point_reached to True - Appends the action to the list of actions Crops the sequence to the length of ‘actions’ Returns ‘actions’

read_next_actions_ignoring_dependencies_and_extra_wait(count)

This function’s purpose is to peek ahead at the next count non-delay actions in the sequence (self._sequence), without removing them or considering dependency constraints. If there is no sequence, it returns None Creates an empty ‘actions’ If there is a sequence, it loops through it: - If the action is a delay: continues (skips it) - If there is an action (and it’s a delay): checks if the action differs to the previous one; if it does, it returns ‘actions’ (so stops) - Appends the action to the list of actions - When the length f the actions equals the given count, it stops (break) Crops the sequence to the length of ‘actions’ Returns ‘actions’

waiting_point_reached()

Returns the waiting point reached

exception sardine.acquisition.acquisition_sequence.EmptyAcquisitionSequence

Bases: Exception

Depends on the class Exception passes

sardine.acquisition.action module

class sardine.acquisition.action.Action(line_name)

Bases: object

property line_name

Returns the line name

class sardine.acquisition.action.AdditionalDelay(line_name, duration)

Bases: Action

Depends on Action class

property duration

Returns the duration, which is the delay (extra hours)

class sardine.acquisition.action.Deploy(line_name)

Bases: Action

Depends on Action class passes

class sardine.acquisition.action.Recover(line_name)

Bases: Action

Depends on Action class passes

class sardine.acquisition.action.Shoot(line_name)

Bases: Action

Depends on Action class passes

sardine.acquisition.dependency module

class sardine.acquisition.dependency.Dependency(name)

Bases: object

property line

Returns the name of the line

class sardine.acquisition.dependency.DeploymentDependency(name)

Bases: Dependency

Class dependant on Dependency class passes

class sardine.acquisition.dependency.RecoveryDependency(name)

Bases: Dependency

Class dependant on Dependency class passes

class sardine.acquisition.dependency.SourceDependency(name)

Bases: Dependency

Class dependant on Dependency class passes

sardine.acquisition.descriptor module

sardine.acquisition.waits module

class sardine.acquisition.waits.Waits

Bases: object

add_dependencies(for_action, *dependencies)

Exists if there are no dependencies Sets as default wait the given action Updates the action with the set of given dependencies

exists(for_action)

Returns True if there is the given action, False if there is not (??)

mark_dependencies_met(*dependencies_met)

Exists if there are no waits or no dependencies Creates a set with the given dependencies Creates new waits by removing the ones with dependencies

Module contents