Function associateSeriesWithAxis

src/coord/axisStatistics.ts:377–445

(
    axis: Axis | NullUndefined,
    seriesModel: SeriesModel,
    coordSysType: CoordinateSystem['type']
)

 * @see scaleRawExtentInfoCreate in `scaleRawExtentInfo.ts`
 */
export function associateSeriesWithAxis(
    axis: Axis | NullUndefined,
    seriesModel: SeriesModel,
    coordSysType: CoordinateSystem['type']
): void {
    if (!axis) {
        return;
    }

    const ecModel = seriesModel.ecModel;
    const ecFullUpdateCache = ecModelCacheFullUpdateInner(getCachePerECFullUpdate(ecModel));
    const axisModelUid = axis.model.uid;

    if (__DEV__) {
        validateInputAxis(axis);
        // - An axis can be associated with multiple `axisStatKey`s. For example, if `axisStatKey`s are
        //   "candlestick" and "bar", they can be associated with the same "xAxis".
        // - Within an individual axis, it is a typically incorrect usage if a <axis, series> pair is
        //   associated with multiple `perKeyPerAxis`, which may cause repeated calculation and
        //   performance degradation, had hard to be found without the checking below. For example, If
        //   `axisStatKey` are "grid-bar" (see `barGrid.ts`) and "polar-bar" (see `barPolar.ts`), and
        //   a <xAxis-series> pair is wrongly associated with both "polar-bar" and "grid-bar", the
        //   relevant statistics will be computed twice.
        const axSerPairCheck = ecFullUpdateCache.axSerPairCheck
            || (ecFullUpdateCache.axSerPairCheck = createHashMap());
        const pairKey = `${axisModelUid}${AXIS_STAT_KEY_DELIMITER}${seriesModel.uid}`;
        assert(!axSerPairCheck.get(pairKey));
        axSerPairCheck.set(pairKey, 1);
    }

    const seriesOnAxisMap = ecFullUpdateCache.axSer || (ecFullUpdateCache.axSer = createHashMap());
    const seriesListPerAxis = seriesOnAxisMap.get(axisModelUid) || (seriesOnAxisMap.set(axisModelUid, []));
    if (__DEV__) {
        const lastSeries = seriesListPerAxis[seriesListPerAxis.length - 1];
        if (lastSeries) {
            // Series order should respect to the input order, since it matters in some cases
            // (e.g., see `barGrid.ts` and `barPolar.ts` - ec option declaration order matters).
            assert(lastSeries.seriesIndex < seriesModel.seriesIndex);
        }
    }
    seriesListPerAxis.push(seriesModel);

    const seriesType = seriesModel.subType;
    const isBaseAxis = seriesModel.getBaseAxis() === axis;

    const client = clientsForLookup.get(makeClientLookupKey(seriesType, isBaseAxis, coordSysType))
        || clientsForLookup.get(makeClientLookupKey(seriesType, isBaseAxis, null));
    if (!client) {
        return;
    }

    const keyed: AxisStatKeyed = ecFullUpdateCache.keyed || (ecFullUpdateCache.keyed = createHashMap());
    const keys: AxisStatKeys = ecFullUpdateCache.keys || (ecFullUpdateCache.keys = createHashMap());

    const axisStatKey = client.key;
    const perKey = keyed.get(axisStatKey) || keyed.set(axisStatKey, createHashMap());
    let perKeyPerAxis = perKey.get(axisModelUid);
    if (!perKeyPerAxis) {