AntennaInspector.tsx

Go to the documentation of this file.

// SPDX-License-Identifier: GPL-2.0-only
// Copyright (c) 2025-present FERS Contributors (see AUTHORS.md).
 
import {
    Alert,
    Box,
    FormControl,
    InputLabel,
    MenuItem,
    Select,
} from '@mui/material';
import { Antenna, useScenarioStore } from '@/stores/scenarioStore';
import { BufferedTextField, FileInput, NumberField } from './InspectorControls';
 
interface AntennaInspectorProps {
    item: Antenna;
}
 
export function AntennaInspector({ item }: AntennaInspectorProps) {
    const previewError = useScenarioStore(
        (state) => state.antennaPreviewErrors[item.id]
    );
    const { updateItem, setAntennaPattern } = useScenarioStore.getState();
    const handleChange = (path: string, value: unknown) =>
        updateItem(item.id, path, value);
 
    return (
        <Box sx={{ display: 'flex', flexDirection: 'column', gap: 2 }}>
            <BufferedTextField
                label="Name"
                variant="outlined"
                size="small"
                fullWidth
                value={item.name}
                allowEmpty={false}
                onChange={(v) => handleChange('name', v)}
            />
            <FormControl fullWidth size="small">
                <InputLabel>Pattern</InputLabel>
                <Select
                    label="Pattern"
                    value={item.pattern}
                    onChange={(e) =>
                        setAntennaPattern(
                            item.id,
                            e.target.value as Antenna['pattern']
                        )
                    }
                >
                    <MenuItem value="isotropic">Isotropic</MenuItem>
                    <MenuItem value="sinc">Sinc</MenuItem>
                    <MenuItem value="gaussian">Gaussian</MenuItem>
                    <MenuItem value="squarehorn">Square Horn</MenuItem>
                    <MenuItem value="parabolic">Parabolic</MenuItem>
                    <MenuItem value="xml">XML</MenuItem>
                    <MenuItem value="file">File (H5)</MenuItem>
                </Select>
            </FormControl>
            <NumberField
                label="Efficiency"
                value={item.efficiency}
                emptyBehavior="revert"
                onChange={(v) => handleChange('efficiency', v)}
            />
            <NumberField
                label="Mesh Scale Multiplier"
                value={item.meshScale ?? null}
                emptyBehavior="null"
                onChange={(v) => handleChange('meshScale', v)}
            />
            {previewError && <Alert severity="error">{previewError}</Alert>}
 
            {item.pattern === 'sinc' && (
                <>
                    <NumberField
                        label="Alpha"
                        value={item.alpha ?? null}
                        emptyBehavior="revert"
                        onChange={(v) => handleChange('alpha', v)}
                    />
                    <NumberField
                        label="Beta"
                        value={item.beta ?? null}
                        emptyBehavior="revert"
                        onChange={(v) => handleChange('beta', v)}
                    />
                    <NumberField
                        label="Gamma"
                        value={item.gamma ?? null}
                        emptyBehavior="revert"
                        onChange={(v) => handleChange('gamma', v)}
                    />
                </>
            )}
            {item.pattern === 'gaussian' && (
                <>
                    <NumberField
                        label="Azimuth Scale"
                        value={item.azscale ?? null}
                        emptyBehavior="revert"
                        onChange={(v) => handleChange('azscale', v)}
                    />
                    <NumberField
                        label="Elevation Scale"
                        value={item.elscale ?? null}
                        emptyBehavior="revert"
                        onChange={(v) => handleChange('elscale', v)}
                    />
                </>
            )}
            {(item.pattern === 'squarehorn' ||
                item.pattern === 'parabolic') && (
                <>
                    <NumberField
                        label="Diameter (m)"
                        value={item.diameter ?? null}
                        emptyBehavior="revert"
                        onChange={(v) => handleChange('diameter', v)}
                    />
                    <NumberField
                        label="Design Frequency (Hz)"
                        value={item.design_frequency ?? null}
                        emptyBehavior="null"
                        onChange={(v) => handleChange('design_frequency', v)}
                    />
                </>
            )}
 
            {(item.pattern === 'xml' || item.pattern === 'file') && (
                <>
                    {/* TODO: Support authoring antenna XML in-app. That requires a real editor flow plus UI/store/schema
                    changes for antenna asset contents, rather than treating XML antennas as opaque filename-only assets. */}
                    <FileInput
                        label="Pattern File"
                        value={item.filename}
                        onChange={(v) => handleChange('filename', v)}
                        filters={[
                            {
                                name: 'Antenna Pattern',
                                extensions:
                                    item.pattern === 'xml' ? ['xml'] : ['h5'],
                            },
                            { name: 'All Files', extensions: ['*'] },
                        ]}
                    />
                </>
            )}
        </Box>
    );
}