Skip to content
Snippets Groups Projects
Commit c38905d5 authored by Jorrit Schaap's avatar Jorrit Schaap
Browse files

Merge branch 'upgrade-beamforming-schemas' into 'master'

TMSS-3092: Remove obsolete limitations to beamforming schemas wrt repointings and multiple bf pipelines

See merge request !1447
parents cfc4af6d 91d4a56f
No related branches found
No related tags found
1 merge request!1447TMSS-3092: Remove obsolete limitations to beamforming schemas wrt repointings and multiple bf pipelines
{
"description": "This schema defines the supported settings for the COBALT beamformer.",
"name": "beamforming",
"purpose": "technical_commissioning",
"schema": {
"$id": "https://tmss.lofar.eu/api/schemas/commonschematemplate/beamforming/12#",
"$schema": "http://json-schema.org/draft-06/schema#",
"additionalProperties": false,
"definitions": {
"beamformer": {
"additionalProperties": false,
"default": {},
"properties": {
"pipelines": {
"additionalItems": false,
"default": [
{}
],
"description": "Beamformer pipelines. NB: If you also run Pulp, stick to 1 pipeline here.",
"items": {
"$ref": "#/definitions/beamformer_pipeline"
},
"minItems": 1,
"title": "Pipelines",
"type": "array"
},
"ppf": {
"default": false,
"description": "Use a PPF for the channellisation for beamforming. If not, an FFT is used.",
"title": "Use PPF when beamforming",
"type": "boolean"
}
},
"required": [
"pipelines",
"ppf"
],
"title": "Beamformer",
"type": "object"
},
"beamformer_pipeline": {
"additionalProperties": false,
"default": {},
"headerTemplate": "Beamformer Pipeline {{ self.index }}",
"properties": {
"coherent": {
"additionalProperties": false,
"default": {},
"properties": {
"SAPs": {
"additionalItems": false,
"default": [
{
"name": "_SAP_name_",
"tabs": []
}
],
"description": "Which SAPs in the observation to beamform.",
"items": {
"additionalProperties": false,
"properties": {
"name": {
"default": "_SAP_to_beamform_",
"description": "Name of the SAP to beamform",
"minLength": 1,
"title": "SAP name",
"type": "string"
},
"subbands": {
"$ref": "#/definitions/subband_selection",
"default": {}
},
"tab_rings": {
"additonalProperties": false,
"default": {},
"description": "Rings of TABs around the center of the beam.",
"properties": {
"count": {
"default": 0,
"maximum": 11,
"minimum": 0,
"title": "Number of rings",
"type": "integer"
},
"width": {
"default": 0.01,
"description": "Distance between pointings.",
"minimum": 0,
"title": "Ring width",
"type": "number"
}
},
"title": "Tied-Array Rings",
"type": "object"
},
"tabs": {
"additionalItems": false,
"default": [],
"description": "Tied-array beams to form",
"items": {
"additionalProperties": false,
"default": {},
"headerTemplate": "TAB {{ self.index }}",
"properties": {
"allow_after_previous": {
"default": true,
"description": "This TAB can be recorded after the previous TAB, if duration allows.",
"title": "Allow after previous",
"type": "boolean"
},
"duration": {
"default": 0,
"description": "Exposure time of the TAB. 0 = observation duration.",
"minimum": 0,
"title": "Duration",
"type": "integer"
},
"pointing": {
"$ref": "https://tmss.lofar.eu/api/schemas/commonschematemplate/pointing/8#/definitions/pointing",
"default": {}
},
"relative": {
"default": false,
"description": "The SAP pointing is added to the TAB pointing",
"title": "Relative to SAP",
"type": "boolean"
}
},
"required": [
"pointing",
"relative"
],
"title": "Tied-Array Beam",
"type": "object"
},
"title": "Tied-Array Beams",
"type": "array"
}
},
"required": [
"name",
"tabs"
],
"type": "object"
},
"minItems": 0,
"title": "SAPs",
"type": "array"
},
"settings": {
"$ref": "#/definitions/stokes_settings",
"default": {}
}
},
"required": [
"SAPs",
"settings"
],
"title": "Coherent Tied-Array Beams",
"type": "object"
},
"flys eye": {
"additionalProperties": false,
"default": {},
"description": "Produce beams containing the individual station signals",
"properties": {
"enabled": {
"default": false,
"title": "Enable Fly's Eye",
"type": "boolean"
},
"SAPs": {
"additionalItems": false,
"default": [],
"description": "Which SAPs in the observation to create the Fly's Eye for",
"items": {
"additionalProperties": false,
"default": {},
"properties": {
"name": {
"default": "_SAP_",
"description": "Name of the SAP",
"minLength": 1,
"title": "SAP name",
"type": "string"
},
"subbands": {
"$ref": "#/definitions/subband_selection",
"default": {}
}
},
"required": [
"name",
"subbands"
],
"type": "object"
},
"minItems": 0,
"title": "SAPs",
"type": "array"
},
"settings": {
"$ref": "#/definitions/stokes_settings",
"default": {}
}
},
"required": [
"enabled"
],
"title": "Fly's Eye Settings",
"type": "object"
},
"incoherent": {
"additionalProperties": false,
"default": {},
"properties": {
"SAPs": {
"additionalItems": false,
"default": [],
"description": "Which SAPs in the observation to create incoherent TABs for (empty list = all).",
"items": {
"additionalProperties": false,
"default": {},
"properties": {
"name": {
"default": "_SAP_to_beamform_",
"description": "Name of the SAP to beamform",
"minLength": 1,
"title": "SAP name",
"type": "string"
},
"subbands": {
"$ref": "#/definitions/subband_selection",
"default": {}
}
},
"required": [
"name",
"subbands"
],
"type": "object"
},
"minItems": 0,
"title": "SAPs",
"type": "array"
},
"settings": {
"$ref": "#/definitions/stokes_settings",
"default": {}
}
},
"required": [
"settings",
"SAPs"
],
"title": "Incoherent Tied-Array Beams",
"type": "object"
},
"name": {
"default": "_beamformer_name_",
"description": "Beamformer name, used for identification purposes.",
"minLength": 1,
"title": "Name",
"type": "string"
},
"station_groups": {
"$ref": "https://tmss.lofar.eu/api/schemas/commonschematemplate/stations/10#/definitions/station_groups",
"default": [
{
"max_nr_missing": 1,
"stations": [
"CS002",
"CS003",
"CS004",
"CS005",
"CS006",
"CS007",
"CS011",
"CS013",
"CS017",
"CS021",
"CS024",
"CS026",
"CS028",
"CS030",
"CS031",
"CS032",
"CS301",
"CS302",
"CS401",
"CS501"
]
}
],
"description": "While observing, COBALT will beamform on the intersection of all stations in this list and the used stations in the observation. So, specifying all possible stations here means that all observation-stations are used. Specifying a small subset here means that only the observing-stations in this small list are used. By default we let COBALT beamform on the Core stations.",
"minItems": 1
}
},
"required": [
"name"
],
"title": "Beamformer Pipeline",
"type": "object"
},
"stokes": {
"default": "I",
"description": "Which Stokes to produce",
"enum": [
"I",
"IQUV",
"XXYY"
],
"title": "Stokes",
"type": "string"
},
"stokes_settings": {
"additionalProperties": false,
"default": {},
"properties": {
"channels_per_subband": {
"default": 1,
"description": "Number of frequency bands per subband",
"enum": [
1,
8,
16,
32,
64,
128,
256,
512,
1024
],
"minimum": 1,
"title": "Channels/subband",
"type": "integer"
},
"quantisation": {
"additionalProperties": false,
"default": {},
"properties": {
"bits": {
"default": 8,
"description": "Number of bits for a single value",
"enum": [
8
],
"title": "Bits/sample",
"type": "integer"
},
"enabled": {
"default": false,
"title": "Output quantisation into integers",
"type": "boolean"
},
"scale_max": {
"default": 5,
"description": "Cut off values above this treshold",
"title": "Maximum value",
"type": "number"
},
"scale_min": {
"default": -5,
"description": "Cut off values below this treshold",
"title": "Minimum value",
"type": "number"
}
},
"required": [
"enabled",
"bits",
"scale_min",
"scale_max"
],
"title": "Output quantisation settings",
"type": "object"
},
"stokes": {
"$ref": "#/definitions/stokes",
"default": "I"
},
"subbands_per_file": {
"default": 488,
"description": "The maximum number of subbands to write in each output dataproduct.",
"maximum": 488,
"minimum": 1,
"title": "Subbands per file",
"type": "integer"
},
"time_integration_factor": {
"default": 1,
"description": "The number of samples to integrate over",
"maximum": 12288,
"minimum": 1,
"title": "Time integration",
"type": "integer"
}
},
"required": [
"stokes",
"time_integration_factor",
"channels_per_subband"
],
"type": "object"
},
"subband_selection": {
"additionalProperties": false,
"default": {},
"properties": {
"list": {
"additionalItems": false,
"default": [],
"description": "If method is 'select subset', only beamform these subbands, and only if they occur in the SAP.",
"items": {
"maximum": 511,
"minimum": 0,
"title": "Subband",
"type": "integer"
},
"minItems": 0,
"title": "Subset selection",
"type": "array"
},
"method": {
"default": "copy",
"description": "How to select the subbands to beam form",
"enum": [
"copy",
"largest continuous subset",
"select subset"
],
"title": "Method",
"type": "string"
}
},
"required": [
"method"
],
"title": "Subband selection",
"type": "object"
}
},
"description": "This schema defines the supported settings for the COBALT beamformer.",
"patternProperties": {
"^[$]schema$": {}
},
"properties": {
"beamformer": {
"$ref": "#/definitions/beamformer",
"default": {}
}
},
"required": [
"beamformer"
],
"title": "beamforming",
"type": "object",
"version": 12
},
"state": "active",
"version": 12
}
{
"description": "This schema defines the parameters for an observation that forms tied-array beams in COBALT.",
"name": "beamforming observation",
"purpose": "technical_commissioning",
"schema": {
"$id": "https://tmss.lofar.eu/api/schemas/tasktemplate/beamforming%20observation/10#",
"$schema": "http://json-schema.org/draft-06/schema#",
"additionalProperties": false,
"default": {},
"description": "This schema defines the parameters for an observation that forms tied-array beams in COBALT.",
"patternProperties": {
"^[$]schema$": {}
},
"properties": {
"QA": {
"$ref": "https://tmss.lofar.eu/api/schemas/commonschematemplate/QA/8#/definitions/QA",
"default": {
"file_conversion": {
"enabled": false
},
"inspection_plots": "msplots",
"plots": {
"enabled": false
}
}
},
"beamformer": {
"$ref": "https://tmss.lofar.eu/api/schemas/commonschematemplate/beamforming/12#/definitions/beamformer",
"default": {}
},
"duration": {
"$id": "#duration",
"$ref": "https://tmss.lofar.eu/api/schemas/commonschematemplate/datetime/9/#/definitions/timedelta",
"default": 300,
"description": "Duration of this observation (seconds)",
"minimum": 1,
"title": "Duration"
},
"station_configuration": {
"$ref": "https://tmss.lofar.eu/api/schemas/commonschematemplate/station_configuration/12#/definitions/station_configuration",
"default": {}
}
},
"required": [
"beamformer",
"duration",
"station_configuration"
],
"title": "beamforming observation",
"type": "object",
"version": 10
},
"state": "active",
"version": 10
}
0% Loading or .
You are about to add 0 people to the discussion. Proceed with caution.
Finish editing this message first!
Please register or to comment