BtfTimestampFormat.java

/*******************************************************************************
 * Copyright (c) 2014 Ericsson
 *
 * All rights reserved. This program and the accompanying materials are
 * made available under the terms of the Eclipse Public License v1.0 which
 * accompanies this distribution, and is available at
 * http://www.eclipse.org/legal/epl-v10.html
 *
 * Contributors:
 *   Matthew Khouzam - Initial API and implementation
 *******************************************************************************/

package org.eclipse.tracecompass.btf.core.trace;

import org.eclipse.jdt.annotation.NonNull;
import org.eclipse.tracecompass.tmf.core.timestamp.ITmfTimestamp;
import org.eclipse.tracecompass.tmf.core.timestamp.TmfTimestamp;

/**
 * Timstamp format of BTF timescale as per v2.1 of the spec
 *
 * @author Matthew Khouzam
 * @since 1.0
 */
public enum BtfTimestampFormat {
    /**
     * Picoseconds
     */
    PS("ps", -12, 0.001), //$NON-NLS-1$
    /**
     * Nanoseconds
     */
    NS("ns", -9, 1.0), //$NON-NLS-1$
    /**
     * Microseconds
     */
    US("us", -6, 1000.0), //$NON-NLS-1$
    /**
     * Milliseconds
     */
    MS("ms", -3, 1000000.0), //$NON-NLS-1$
    /**
     * Seconds
     */
    S("s", 0, 1000000000.0); //$NON-NLS-1$

    private final String fName;
    private final int fScale;
    private final double fScaleFactor;

    private BtfTimestampFormat(String name, int scale, double scaleFactor) {
        fName = name;
        fScale = scale;
        fScaleFactor = scaleFactor;
    }

    /**
     * Get the scaling factor
     *
     * @return the scaling factor
     */
    public double getScaleFactor() {
        return fScaleFactor;
    }

    @Override
    public String toString() {
        return fName;
    }

    /**
     * Parse a string to get a scale
     *
     * @param text
     *            the timestamp in text "ns", "ms" ...
     * @return a BtfTimestampFormat object
     */
    public static BtfTimestampFormat parse(String text) {
        switch (text.toLowerCase()) {
        case "ps": //$NON-NLS-1$
            throw new IllegalArgumentException("ps not yet supported"); //$NON-NLS-1$
        case "ns": //$NON-NLS-1$
            return BtfTimestampFormat.NS;
        case "us": //$NON-NLS-1$
            return BtfTimestampFormat.US;
        case "ms": //$NON-NLS-1$
            return BtfTimestampFormat.MS;
        case "s": //$NON-NLS-1$
            return BtfTimestampFormat.S;
        default:
            throw new IllegalArgumentException(text + " not a valid argument, use ps, ns, us, ms, s"); //$NON-NLS-1$
        }
    }

    /**
     * Create an ITmfTimestamp with a proper scale
     *
     * @param timestamp
     *            timestamp without scale
     * @return TmfTimestamp with proper scale
     */
    public @NonNull ITmfTimestamp createTimestamp(long timestamp) {
        return TmfTimestamp.create(timestamp, fScale);
    }
}