Skip to main content
Ctrl+K
PYSTILT is in alpha. Expect API and workflow changes while the execution and observation layers settle.

PYSTILT 0.1.0a1

  • Getting Started
  • User Guides
  • Tutorials
  • API Reference
  • Roadmap
  • GitHub
  • Getting Started
  • User Guides
  • Tutorials
  • API Reference
  • Roadmap
  • GitHub

Section Navigation

  • Core Objects
    • stilt.Model
      • stilt.Model.register_pending
      • stilt.Model.run
      • stilt.Model.scene_counts
      • stilt.Model.status
    • stilt.Receptor
      • stilt.Receptor.from_dict
      • stilt.Receptor.from_points
      • stilt.Receptor.to_dict
    • stilt.PointReceptor
      • stilt.PointReceptor.from_dict
      • stilt.PointReceptor.from_points
      • stilt.PointReceptor.to_dict
    • stilt.ColumnReceptor
      • stilt.ColumnReceptor.from_dict
      • stilt.ColumnReceptor.from_points
      • stilt.ColumnReceptor.to_dict
    • stilt.MultiPointReceptor
      • stilt.MultiPointReceptor.from_dict
      • stilt.MultiPointReceptor.from_points
      • stilt.MultiPointReceptor.to_dict
    • stilt.ReceptorID
      • stilt.ReceptorID.capitalize
      • stilt.ReceptorID.casefold
      • stilt.ReceptorID.center
      • stilt.ReceptorID.count
      • stilt.ReceptorID.encode
      • stilt.ReceptorID.endswith
      • stilt.ReceptorID.expandtabs
      • stilt.ReceptorID.find
      • stilt.ReceptorID.format
      • stilt.ReceptorID.format_map
      • stilt.ReceptorID.from_parts
      • stilt.ReceptorID.index
      • stilt.ReceptorID.isalnum
      • stilt.ReceptorID.isalpha
      • stilt.ReceptorID.isascii
      • stilt.ReceptorID.isdecimal
      • stilt.ReceptorID.isdigit
      • stilt.ReceptorID.isidentifier
      • stilt.ReceptorID.islower
      • stilt.ReceptorID.isnumeric
      • stilt.ReceptorID.isprintable
      • stilt.ReceptorID.isspace
      • stilt.ReceptorID.istitle
      • stilt.ReceptorID.isupper
      • stilt.ReceptorID.join
      • stilt.ReceptorID.ljust
      • stilt.ReceptorID.lower
      • stilt.ReceptorID.lstrip
      • stilt.ReceptorID.maketrans
      • stilt.ReceptorID.partition
      • stilt.ReceptorID.removeprefix
      • stilt.ReceptorID.removesuffix
      • stilt.ReceptorID.replace
      • stilt.ReceptorID.rfind
      • stilt.ReceptorID.rindex
      • stilt.ReceptorID.rjust
      • stilt.ReceptorID.rpartition
      • stilt.ReceptorID.rsplit
      • stilt.ReceptorID.rstrip
      • stilt.ReceptorID.split
      • stilt.ReceptorID.splitlines
      • stilt.ReceptorID.startswith
      • stilt.ReceptorID.strip
      • stilt.ReceptorID.swapcase
      • stilt.ReceptorID.title
      • stilt.ReceptorID.translate
      • stilt.ReceptorID.upper
      • stilt.ReceptorID.zfill
    • stilt.LocationID
      • stilt.LocationID.capitalize
      • stilt.LocationID.casefold
      • stilt.LocationID.center
      • stilt.LocationID.count
      • stilt.LocationID.encode
      • stilt.LocationID.endswith
      • stilt.LocationID.expandtabs
      • stilt.LocationID.find
      • stilt.LocationID.format
      • stilt.LocationID.format_map
      • stilt.LocationID.index
      • stilt.LocationID.isalnum
      • stilt.LocationID.isalpha
      • stilt.LocationID.isascii
      • stilt.LocationID.isdecimal
      • stilt.LocationID.isdigit
      • stilt.LocationID.isidentifier
      • stilt.LocationID.islower
      • stilt.LocationID.isnumeric
      • stilt.LocationID.isprintable
      • stilt.LocationID.isspace
      • stilt.LocationID.istitle
      • stilt.LocationID.isupper
      • stilt.LocationID.join
      • stilt.LocationID.ljust
      • stilt.LocationID.lower
      • stilt.LocationID.lstrip
      • stilt.LocationID.maketrans
      • stilt.LocationID.partition
      • stilt.LocationID.removeprefix
      • stilt.LocationID.removesuffix
      • stilt.LocationID.replace
      • stilt.LocationID.rfind
      • stilt.LocationID.rindex
      • stilt.LocationID.rjust
      • stilt.LocationID.rpartition
      • stilt.LocationID.rsplit
      • stilt.LocationID.rstrip
      • stilt.LocationID.split
      • stilt.LocationID.splitlines
      • stilt.LocationID.startswith
      • stilt.LocationID.strip
      • stilt.LocationID.swapcase
      • stilt.LocationID.title
      • stilt.LocationID.translate
      • stilt.LocationID.upper
      • stilt.LocationID.zfill
    • stilt.read_receptors
    • stilt.Simulation
      • stilt.Simulation.footprint_path
      • stilt.Simulation.generate_footprint
      • stilt.Simulation.get_footprint
      • stilt.Simulation.resolve_output
      • stilt.Simulation.run_trajectories
      • stilt.Simulation.storage_key
    • stilt.SimID
      • stilt.SimID.from_parts
    • stilt.Trajectories
      • stilt.Trajectories.from_parquet
      • stilt.Trajectories.from_particles
      • stilt.Trajectories.to_parquet
    • stilt.Footprint
      • stilt.Footprint.aggregate
      • stilt.Footprint.calculate
      • stilt.Footprint.from_netcdf
      • stilt.Footprint.integrate_over_time
      • stilt.Footprint.to_netcdf
  • Configuration
    • stilt.config.ModelConfig
      • stilt.config.ModelConfig.basic
      • stilt.config.ModelConfig.from_yaml
      • stilt.config.ModelConfig.to_stilt_params
      • stilt.config.ModelConfig.to_yaml
    • stilt.config.MetConfig
    • stilt.config.FootprintConfig
      • stilt.config.FootprintConfig.replace
    • stilt.config.Bounds
    • stilt.config.Grid
    • stilt.config.RuntimeSettings
      • stilt.config.RuntimeSettings.from_env
    • stilt.config.ModelParams
    • stilt.config.TransportParams
    • stilt.config.ErrorParams
    • stilt.config.VerticalOperatorTransformSpec
    • stilt.config.FirstOrderLifetimeTransformSpec
  • Meteorology
    • stilt.meteorology.MetID
      • stilt.meteorology.MetID.capitalize
      • stilt.meteorology.MetID.casefold
      • stilt.meteorology.MetID.center
      • stilt.meteorology.MetID.count
      • stilt.meteorology.MetID.encode
      • stilt.meteorology.MetID.endswith
      • stilt.meteorology.MetID.expandtabs
      • stilt.meteorology.MetID.find
      • stilt.meteorology.MetID.format
      • stilt.meteorology.MetID.format_map
      • stilt.meteorology.MetID.index
      • stilt.meteorology.MetID.isalnum
      • stilt.meteorology.MetID.isalpha
      • stilt.meteorology.MetID.isascii
      • stilt.meteorology.MetID.isdecimal
      • stilt.meteorology.MetID.isdigit
      • stilt.meteorology.MetID.isidentifier
      • stilt.meteorology.MetID.islower
      • stilt.meteorology.MetID.isnumeric
      • stilt.meteorology.MetID.isprintable
      • stilt.meteorology.MetID.isspace
      • stilt.meteorology.MetID.istitle
      • stilt.meteorology.MetID.isupper
      • stilt.meteorology.MetID.join
      • stilt.meteorology.MetID.ljust
      • stilt.meteorology.MetID.lower
      • stilt.meteorology.MetID.lstrip
      • stilt.meteorology.MetID.maketrans
      • stilt.meteorology.MetID.partition
      • stilt.meteorology.MetID.removeprefix
      • stilt.meteorology.MetID.removesuffix
      • stilt.meteorology.MetID.replace
      • stilt.meteorology.MetID.rfind
      • stilt.meteorology.MetID.rindex
      • stilt.meteorology.MetID.rjust
      • stilt.meteorology.MetID.rpartition
      • stilt.meteorology.MetID.rsplit
      • stilt.meteorology.MetID.rstrip
      • stilt.meteorology.MetID.split
      • stilt.meteorology.MetID.splitlines
      • stilt.meteorology.MetID.startswith
      • stilt.meteorology.MetID.strip
      • stilt.meteorology.MetID.swapcase
      • stilt.meteorology.MetID.title
      • stilt.meteorology.MetID.translate
      • stilt.meteorology.MetID.upper
      • stilt.meteorology.MetID.zfill
    • stilt.MetStream
      • stilt.MetStream.required_files
      • stilt.MetStream.stage_files_for_simulation
  • Execution
    • stilt.execution.LocalExecutor
      • stilt.execution.LocalExecutor.start
    • stilt.execution.SlurmExecutor
      • stilt.execution.SlurmExecutor.from_config
      • stilt.execution.SlurmExecutor.start
    • stilt.execution.KubernetesExecutor
      • stilt.execution.KubernetesExecutor.from_config
      • stilt.execution.KubernetesExecutor.start
    • stilt.execution.pull_simulations
    • stilt.execution.push_simulations
    • stilt.execution.SimulationTask
    • stilt.execution.SimulationResult
  • Observations
    • stilt.observations.Observation
    • stilt.observations.Scene
    • stilt.observations.PointSensor
      • stilt.observations.PointSensor.build_receptor
      • stilt.observations.PointSensor.group_scenes
      • stilt.observations.PointSensor.make_observation
    • stilt.observations.ColumnSensor
      • stilt.observations.ColumnSensor.build_receptor
      • stilt.observations.ColumnSensor.group_scenes
      • stilt.observations.ColumnSensor.make_observation
    • stilt.observations.VerticalOperator
    • stilt.observations.FirstOrderLifetimeChemistry
      • stilt.observations.FirstOrderLifetimeChemistry.apply
    • stilt.observations.HorizontalGeometry
    • stilt.observations.ViewingGeometry
    • stilt.observations.LineOfSight
    • stilt.observations.VerticalOperatorWeighting
      • stilt.observations.VerticalOperatorWeighting.apply
    • stilt.observations.build_point_receptor
    • stilt.observations.build_column_receptor
    • stilt.observations.build_slant_receptor
    • stilt.observations.group_scenes_by_time_gap
    • stilt.observations.group_scenes_by_swath
    • stilt.observations.group_scenes_by_metadata
  • Storage And Index
    • stilt.index.IndexCounts
    • stilt.index.OutputSummary
      • stilt.index.OutputSummary.footprint_complete
      • stilt.index.OutputSummary.footprints_complete
      • stilt.index.OutputSummary.needs_work
      • stilt.index.OutputSummary.outputs_complete
      • stilt.index.OutputSummary.pending_footprints
    • stilt.index.SimulationIndex
      • stilt.index.SimulationIndex.count
      • stilt.index.SimulationIndex.counts
      • stilt.index.SimulationIndex.has
      • stilt.index.SimulationIndex.pending_trajectories
      • stilt.index.SimulationIndex.rebuild
      • stilt.index.SimulationIndex.receptors_for
      • stilt.index.SimulationIndex.record
      • stilt.index.SimulationIndex.register
      • stilt.index.SimulationIndex.reset_to_pending
      • stilt.index.SimulationIndex.scene_counts
      • stilt.index.SimulationIndex.sim_ids
      • stilt.index.SimulationIndex.summaries
    • stilt.storage.ProjectLayout
      • stilt.storage.ProjectLayout.resolve
    • stilt.storage.ProjectFiles
      • stilt.storage.ProjectFiles.config_key
      • stilt.storage.ProjectFiles.footprint_index_key
      • stilt.storage.ProjectFiles.particle_index_key
      • stilt.storage.ProjectFiles.receptors_key
      • stilt.storage.ProjectFiles.simulation
      • stilt.storage.ProjectFiles.simulation_prefix
    • stilt.storage.SimulationFiles
      • stilt.storage.SimulationFiles.clear_empty_footprint_marker
      • stilt.storage.SimulationFiles.empty_footprint_path
      • stilt.storage.SimulationFiles.footprint_path
      • stilt.storage.SimulationFiles.key
      • stilt.storage.SimulationFiles.key_for
      • stilt.storage.SimulationFiles.key_prefix_for
      • stilt.storage.SimulationFiles.write_empty_footprint_marker
    • stilt.storage.Storage
      • stilt.storage.Storage.exists
      • stilt.storage.Storage.load_config
      • stilt.storage.Storage.load_receptors
      • stilt.storage.Storage.publish_config
      • stilt.storage.Storage.publish_receptors
      • stilt.storage.Storage.publish_simulation
      • stilt.storage.Storage.receptor_source_path
      • stilt.storage.Storage.resolve
    • stilt.storage.FsspecStore
      • stilt.storage.FsspecStore.exists
      • stilt.storage.FsspecStore.list_prefix
      • stilt.storage.FsspecStore.local_path
      • stilt.storage.FsspecStore.publish_file
      • stilt.storage.FsspecStore.publish_simulation
      • stilt.storage.FsspecStore.read_bytes
      • stilt.storage.FsspecStore.write_bytes
  • HYSPLIT Integration
    • stilt.hysplit.HYSPLITDriver
      • stilt.hysplit.HYSPLITDriver.execute
      • stilt.hysplit.HYSPLITDriver.prepare
  • API Reference
  • Core Objects
  • stilt.Receptor
  • stilt.Receptor.from_points

stilt.Receptor.from_points#

classmethod Receptor.from_points(time, points, *, altitude_ref='agl')[source]#

Build a receptor from (longitude, latitude, altitude) tuples.

Returns PointReceptor for one point, ColumnReceptor when two points share the same horizontal location, and MultiPointReceptor otherwise.

Return type:

stilt.receptor.Receptor

Parameters:
  • time (datetime | Timestamp | datetime64 | str)

  • points (list[tuple[float, float, float]])

  • altitude_ref (Literal['agl', 'msl'])

previous

stilt.Receptor.from_dict

next

stilt.Receptor.to_dict

On this page
  • Receptor.from_points()
Show Source

© Copyright 2026, James Mineau.

Created using Sphinx 8.1.3.

Built with the PyData Sphinx Theme 0.17.0.