If for_spice is true, the nophys devices are included, and not shorted. This applies when generating output for SPICE simulation.
The function returns 1 on success, 0 otherwise. If the schematic is already processed and current, the function will return immediately. The schematic is implicitly processed before most internal operations that make use of the schematic, so it is unlikely that the user will need to call this function.