samples/apifest1/day2/pinbasedsolution/src/org/netbeans/apifest/boolcircuit/Circuit.java
1.1 --- /dev/null Thu Jan 01 00:00:00 1970 +0000
1.2 +++ b/samples/apifest1/day2/pinbasedsolution/src/org/netbeans/apifest/boolcircuit/Circuit.java Sat Jun 14 09:52:45 2008 +0200
1.3 @@ -0,0 +1,86 @@
1.4 +/*
1.5 + * The contents of this file are subject to the terms of the Common Development
1.6 + * and Distribution License (the License). You may not use this file except in
1.7 + * compliance with the License.
1.8 + *
1.9 + * You can obtain a copy of the License at http://www.netbeans.org/cddl.html
1.10 + * or http://www.netbeans.org/cddl.txt.
1.11 + *
1.12 + * When distributing Covered Code, include this CDDL Header Notice in each file
1.13 + * and include the License file at http://www.netbeans.org/cddl.txt.
1.14 + * If applicable, add the following below the CDDL Header, with the fields
1.15 + * enclosed by brackets [] replaced by your own identifying information:
1.16 + * "Portions Copyrighted [year] [name of copyright owner]"
1.17 + *
1.18 + * The Original Software is NetBeans. The Initial Developer of the Original
1.19 + * Software is Sun Microsystems, Inc. Portions Copyright 1997-2006 Sun
1.20 + * Microsystems, Inc. All Rights Reserved.
1.21 + */
1.22 +
1.23 +package org.netbeans.apifest.boolcircuit;
1.24 +
1.25 +/**
1.26 + * A representation of a logic circuit.
1.27 + * It can only be constructed from an element net.
1.28 + * Usage:
1.29 + * <pre>
1.30 + * Circuit c = Circuit.construct(
1.31 + * Element.createOr(
1.32 + * Element.createAnd(
1.33 + * Element.createInput(0),
1.34 + * Element.createInput(1)
1.35 + * ),
1.36 + * Element.createInput(2)
1.37 + * )
1.38 + * );
1.39 + *
1.40 + * boolean val = c.evaluate(false, true, false));
1.41 + * </pre>
1.42 + */
1.43 +public class Circuit {
1.44 + Element root;
1.45 + int pins;
1.46 +
1.47 + private Circuit(Element elem) {
1.48 + root = elem;
1.49 + pins = 1 + root.maxInput();
1.50 + }
1.51 +
1.52 + /**
1.53 + * Evaluate output of the circuit for given inputs.
1.54 + * For general
1.55 + */
1.56 + public boolean evaluate(Boolean ... inputs) throws UnstableException {
1.57 + if (inputs.length != pins) throw new IllegalArgumentException("Wrong number of inputs, " + pins + " expected.");
1.58 + double[] inp = new double[pins];
1.59 + for (int i=0; i<pins; i++) inp[i] = inputs[i] ? 1 : 0;
1.60 + double res = root.evaluate(inp);
1.61 + return res > 0.5;
1.62 + }
1.63 +
1.64 + public double evaluate(double ... inputs) throws UnstableException {
1.65 + if (inputs.length != pins) throw new IllegalArgumentException("Wrong number of inputs, " + pins + " expected.");
1.66 +
1.67 + double[] inp = new double[pins]; // defensive copy with a check
1.68 + for (int i=0; i<inputs.length; i++) {
1.69 + if (inputs[i] < 0.0 || inputs[i] > 1.0) {
1.70 + throw new IllegalArgumentException("Out of range, pin " + i + ", value=" + inputs[i]);
1.71 + }
1.72 + inp[i] = inputs[i];
1.73 + }
1.74 +
1.75 + return root.evaluate(inp);
1.76 + }
1.77 +
1.78 + /**
1.79 + * Creates a circuit from a preconstructed element net.
1.80 + *
1.81 + * @param a top-level element representing the logic net.
1.82 + * @return a circuit prepared for evaluating result for given inputs.
1.83 + *
1.84 + */
1.85 + public static Circuit construct(Element elem) {
1.86 + return new Circuit(elem);
1.87 + }
1.88 +
1.89 +}